SuperAPI AI 工具集

execute-phase

通用与其它

查看项目

更新于 10-15 21:56

技能介绍

用途:execute-phase 是智能体工作流中的步骤执行器,针对已完成分诊(unit-lane triage)的单元执行指定步骤或全部剩余步骤。单元文档(由 unit-lane 创建)的 Tasks P1…Pn、Evidence 行与 Progress 日志取代了 PLAN.md、TASKS.md、progress.md 和 ACCEPTANCE.md;每个步骤以原子化的门禁/提交方式运行。

参数解析(取第一个匹配):<NN-slug> P<k> 表示分诊顺序中指定的步骤;<NN-slug> 不带步骤表示所有剩余步骤,每步一次提交;单独 P<k> 表示当前单元中按位置的步骤。不得推断分诊块中不存在的步骤 ID。

主要能力与用法:先发现项目并读取单元文档 docs/features/<NN-slug>/SPEC.md,确认其含 ## Tasks、## Evidence、## Progress 段;缺失则停止并建议先做 unit-lane 分诊。然后依次执行:验证分诊时效(运行 bun scripts/unit-route.mjs --triage <slug> 与 Evidence 段头比对)、选择步骤、前置门禁(路径保护检查、phase-lint、pre-write mapper、依赖/不变量检查)、执行步骤、后置处理(diff guard、Evidence 行、Progress 日志、提交)、红色门禁修复循环(默认 --max-attempts 3)。支持整体单元模式:无步骤参数时循环所有剩余步骤,每步一次提交。

适用场景:来自 unit-lane 的分诊单元(步骤含 implement/tests/evidence);仅文档单元不加载此技能。修复失败步骤时以 <NN-slug> P<k> 重试同一步骤。

限制与护栏:仅执行分诊列出的步骤;不得提交红色(测试失败);不得削弱验证器;不得编辑单元文档的 Acceptance 标准;不得超出 Non-goals 扩大范围;不得凭空编造验收标准。降围(descope)需先获用户明确批准。可移植性:在 Claude Code 以外的智能体上无斜杠菜单,需直接按 SKILL.md 执行;无模型分级与子代理机制。

必要命令:bun scripts/unit-route.mjs --triage <slug>、bun scripts/phase-lint.mjs <unit-doc>、bun scripts/diff-guard.mjs --base <last-step-commit> --unit <unit>。