核心用法
Formstack Documents 技能通过 OOMOL 官方 CLI 工具（oo-cli）封装了 Formstack Documents 平台的完整 API 能力，支持文档模板的增删改查全生命周期管理。用户通过预配置的连接器调用 formstack_documents 服务，OOMOL 在服务端自动注入凭证，彻底避免令牌泄露风险。
使用流程遵循标准模式：首先通过 oo connector schema 获取目标 action 的权威输入/输出结构，确认字段类型和必填项后，再使用 oo connector run 执行具体操作。支持的 action 覆盖模板复制（copy_document）、创建（create_document）、更新（update_document）、删除（delete_document）及查询类操作（get_document、list_documents、get_document_fields）。其中写操作和删除操作带有 [write] 和 [destructive] 标签，执行前需二次确认。
显著优点
零凭证管理负担：OOMOL 服务端托管 Formstack 认证信息，用户无需接触 API Key 或 OAuth Token，大幅降低泄露风险。
声明式安全模型：每个 action 明确标注读取、写入或破坏性级别，Agent 可在执行前进行策略拦截或用户确认，符合企业合规要求。
Schema 驱动开发：通过 CLI 实时拉取 action schema，确保请求结构与 Formstack API 最新版本保持同步，避免因 API 变更导致的运行时错误。
跨平台 CLI 支持：提供 macOS/Linux 的 Bash 安装脚本与 Windows PowerShell 指令，环境初始化成本低。
潜在缺点与局限性
依赖 OOMOL 账户体系：必须拥有 OOMOL 账户并完成 Formstack Documents 连接授权，无法独立运行或迁移至其他平台。
网络与计费门槛：OOMOL 采用 Token 计费模式（OOMOL_INSUFFICIENT_CREDIT 错误码），高频调用可能产生持续成本；同时依赖 OOMOL 服务可用性，存在单点依赖。
功能封装粒度：当前仅暴露核心模板管理 action，Formstack Documents 的高级功能（如条件逻辑、批量合并、第三方集成触发器）可能需要直接调用原生 API 补充。
调试透明度有限：CLI 封装层可能隐藏底层 HTTP 错误细节，复杂场景下的问题定位需要结合 oo 命令的 verbose 模式。
适合的目标群体
- 企业自动化团队：需要安全、可审计的文档模板管理管道，避免开发团队接触生产环境凭证。
- SaaS 集成开发者：构建基于 Formstack Documents 的客户解决方案，希望快速验证 action schema 而无需阅读完整 REST 文档。
- 低代码/无代码实践者：通过自然语言指令驱动文档工作流，降低表单与合同生成自动化的技术门槛。
使用风险
凭证失效风险：Formstack 连接可能因授权过期或 scope 变更进入 credential_expired 或 scope_missing 状态，需人工重新授权。建议建立连接健康检查机制。
误操作数据丢失：delete_document 等破坏性 action 无回收站机制，执行前务必通过 get_document 确认目标 ID，建议在 Agent 层实现删除前的显式确认对话框。
Schema 版本漂移：Formstack API 更新可能导致 action schema 与本地假设不一致，关键业务场景应在 CI/CD 中加入 oo connector schema 校验步骤。
性能与配额限制：大规模批量操作可能触发 Formstack 平台速率限制，建议实施指数退避重试策略，并监控 OOMOL Token 消耗速率。
供应商锁定：深度依赖 OOMOL 的 CLI 封装和凭证托管，未来迁移至其他基础设施或直接使用 Formstack API 需重构调用层。