核心用法
ByteForms Skill 是 OOMOL 官方提供的表单数据管理工具，专为 ByteForms（forms.bytesuite.io）平台设计。该技能通过封装 oo CLI 命令行工具，让 Agent 能够安全地与 ByteForms API 进行交互，而无需直接处理 API 密钥或访问令牌。
使用时，Agent 首先通过 oo connector schema 命令获取指定动作的权威输入/输出 schema，确保构造合法的 JSON payload；随后通过 oo connector run 执行具体动作，支持的动作包括：
get_form：按表单 ID 获取单个表单详情list_forms：列出当前账户可访问的所有表单list_form_responses：查询指定表单的响应数据，支持分页、筛选和排序
所有 API 调用均在 OOMOL 服务端完成身份注入，用户凭证由平台托管，Agent 全程不接触原始令牌，从根本上杜绝了密钥泄露风险。
显著优点
安全性设计突出：采用服务端凭证注入架构，Agent 无需存储或传输 API 密钥，符合零信任安全原则。
标准化接口：统一使用 oo CLI 作为调用层，屏蔽底层 HTTP 细节，降低集成复杂度。
动态 Schema 发现：支持运行时获取动作的最新输入规范，避免因 API 版本迭代导致请求失败。
读写操作分离：通过 [write] 和 [destructive] 标签明确标识状态变更操作，便于实现人机确认流程。
跨平台兼容：oo CLI 提供 macOS、Linux、Windows 三端安装支持，覆盖主流开发环境。
潜在缺点与局限性
依赖链较长：正常运行需要预装 oo CLI、完成 OOMOL 账户登录、建立 ByteForms 连接三重前置条件，首次配置流程较繁琐。
错误处理抽象：CLI 错误码（如 scope_missing、OOMOL_INSUFFICIENT_CREDIT）需要额外映射为用户友好的提示。
功能覆盖有限：当前仅暴露读取类操作（get/list），未包含表单创建、字段编辑等管理功能，适用场景受限。
网络延迟叠加：本地 CLI → OOMOL 服务端 → ByteForms API 的多跳架构，在高频调用场景下可能引入可观延迟。
适合的目标群体
- 使用 ByteForms 收集数据的运营、市场、产品团队，需要自动化导出或分析表单响应
- 构建数据管道的开发者，希望将表单数据集成至 OOMOL Workflow 或下游 BI 系统
- 注重合规的企业用户，要求 API 密钥不落地的场景
使用风险
计费风险：OOMOL 平台采用 Token 计费模式，大量调用可能导致 OOMOL_INSUFFICIENT_CREDIT 中断，需提前充值。
连接失效风险：API 密钥过期或权限变更会导致 credential_expired 或 scope_missing，需引导用户重新授权。
数据范围风险：list_form_responses 可能返回敏感个人信息，需确保 Agent 遵循最小权限原则，避免过度拉取。
CLI 版本兼容：oo CLI 更新可能引入 breaking changes，建议锁定版本或持续跟进 release note。