SuperAPI AI 工具集

flow-next-sync

编程与开发

查看项目

更新于 10-15 21:53

技能介绍

用途:在实现发生偏移、代码变化超出规格描述时,手动触发 plan-sync,更新下游任务规格。它用于补充自动触发,手动调用始终执行,不受 planSync.enabled 配置影响。

用法:命令为 /flow-next:sync <id> [--dry-run]。<id> 可为任务 ID(如 fn-1.2 或 fn-1-add-oauth.2)或规格 ID(fn-1 或 fn-1-add-oauth);旧格式 fn-N、fn-N-xxx 也支持。--dry-run 只报告将发生的变更,不写文件。

执行流程:先解析并校验 ID 格式;检查当前目录存在 .flow/(否则提示先运行 flowctl init);用 flowctl show <ID> --json 验证 ID 存在。任务模式取该任务所属规格,列出状态为 todo 或 blocked 的下游任务;规格模式优先选最近更新的 done 任务,其次 in_progress 任务作为漂移检测基准,再筛选待办与阻塞任务。若没有下游任务则直接结束。

随后收集术语表、决策与策略上下文:glossary list --json、memory list --track knowledge --category decisions --json、strategy read --json,均尽力而为,失败时使用空默认值。当术语总数为 0、决策条目为 0、策略 sections_filled 为 0 或为空对象时,跳过额外上下文。

最后通过 Task 工具以 subagent_type: flow-next:plan-sync 启动 plan-sync 代理,并传入 COMPLETED_TASK_ID、FLOWCTL、SPEC_ID、DOWNSTREAM_TASK_IDS、DRY_RUN 及各 JSON 上下文;dry-run 模式要求只分析报告、不使用 Edit。代理返回后输出扫描任务数与摘要。

限制:flowctl 为随插件捆绑,不全局安装,需使用 FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"。缺少 .flow/、ID 格式错误、任务或规格不存在、规格模式无已完成或进行中任务、无下游任务时均会报错停止。收费、价格、平台与效果等事实暂未提供。