SuperAPI AI 工具集

flow-next-sync

通用与其它

查看项目

更新于 10-16 06:18

技能介绍

用途:在代码实现偏离原规格后,手动触发 plan-sync,更新下游任务规格。适用于代码变更已超出规格描述的情况。手动触发不受配置控制,planSync.enabled 仅用于自动触发。

输入格式:<id> [--dry-run]。<id> 为任务 ID(fn-N-slug.M,或旧格式 fn-N.M、fn-N-xxx.M)或规格 ID(fn-N-slug,或旧格式 fn-N、fn-N-xxx)。--dry-run 仅展示变更而不写入。

工作流程:解析参数并校验 ID 格式;校验 .flow/ 目录存在;通过 flowctl show <ID> --json 校验 ID 存在;查找下游任务(todo 或 blocked 状态)。任务模式提取规格并列出其余任务;规格模式优先选取最近更新的 done 任务作为源,否则选 in_progress,再过滤下游任务。随后收集 glossary、decisions、strategy 三类上下文,三者均无信号时跳过。之后通过 Task 工具启动 flow-next:plan-sync 子代理,传入 COMPLETED_TASK_ID、FLOWCTL、SPEC_ID、DOWNSTREAM_TASK_IDS、DRY_RUN 及三类上下文 JSON。最后格式化输出结果。

关键命令:flowctl 为内置工具,不全局安装,须用 FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"。

限制:需先运行 flowctl init 生成 .flow/;源任务可为任意状态;下游集合包含 todo 与 blocked;无下游任务则提示无需同步;ID 不存在或格式错误会报错;规格模式若无可用的已完成或进行中任务会报错。