用途:修改已部署在已连接 Salesforce 组织中的 Data Capture Flow(如 Inventory_Transfer、Asset_Inspection)。适用于用户指定现有 Flow 名称、粘贴 Flow Builder URL 或描述已部署 Flow 的部署错误/运行时缺陷;从零创建应改用 design-* 技能。
主要能力:通过 Codey 运行时以 REST 调用完成组织鉴权探测、读取 Flow Metadata JSON、内存内编辑并 PATCH 回写。所有交互均为单次 REST 调用,不依赖 sf CLI、本地 Python、临时文件或 SFDX 项目,不执行 shell。
使用方式:先以 SELECT Id FROM Organization LIMIT 1 探测鉴权;再用 Tooling 查询 FlowDefinition 获取 LatestVersionId(为空则回退 ActiveVersionId),GET /tooling/sobjects/Flow/<versionId> 取 Metadata;编辑前阅读 fs-data-capture-reference/SKILL.md 的硬约束,并向用户说明改动内容、是否需重排 schema、激活状态风险,经确认后编辑内存 JSON,最后 PATCH /tooling/sobjects/Flow/<versionId> 提交完整 Metadata 对象(204 成功,400 返回校验错误)。
限制:PATCH 生成新草稿版本,原激活版本继续运行,需用户在 Flow Builder 中激活;仅支持 processType=DataCaptureFlow;不适用于新建 Flow、跨多 Flow 批量迁移或整体重构;错误排查不得连续循环超过两次而不告知用户。