SuperAPI AI 工具集

execute-phase

编程与开发

查看项目

更新于 11-14 09:10

技能介绍

用途

execute-phase 用于按项目名称(通过 $ARGUMENTS 传入)自主执行该项目的下一个待办阶段,范围限定为当前阶段,完成即停止,不推进到下一阶段。

主要能力

  • 阶段解析与恢复:通过 specpipe next-phase 查询项目 handoff 目录下的 phase-plan 文件,优先恢复被中断的 in_progress 阶段;可重新评估部分完成状态,或用 set-status 将其退回 pending。
  • 规格编写:基于模板 templates/phase-spec.md 与 spec-construction 标准(核心 + 阶段增量)编写阶段规格,继承主规格与前置阶段契约。
  • 计划编写:基于 templates/implementation-plan.md 与 plan-construction 标准编写实施计划,每个任务内嵌完整失败测试代码与实现代码,并按 TDD 顺序排列。
  • TDD 实现:逐任务执行 RED(确认测试因正确原因失败并用 record-red 记录)→ GREEN(实现并 record-green 记录)→ 重构的循环,并运行完整验证门禁后提交。
  • 覆盖率检查:运行覆盖率工具,满足项目对改动模块的覆盖率阈值,并识别缺少对应测试的新公开接口。
  • 评审门禁:规格与计划阶段各执行恰好一次 ultracode 工作流评审,随后用 /codex-review 迭代至收敛(最多 3 轮);最终评审仅用 /codex-review(最多 5 轮)。
  • 收尾:汇总阶段结果与遗留项,标记阶段完成,提交审计文件,按显式路径暂存变更(禁止 git add -A / git add .),推送提交到当前分支远端。

使用方式

在 Claude Code 中调用该技能,并以参数指定项目名称;需预先满足:会话权限模式允许无人值守运行、/codex-review 与 ultracode 工作流可用、工作树状态明确。结构校验通过如下方式调用: PYTHONPATH="${CLAUDE_PLUGIN_ROOT}/scripts/specpipe" uv run --no-project python -B -m specpipe <subcommand> … 默认路径为 docs/handoff/,审计文件位于阶段计划旁的 audit/ 子目录。

适用场景

适用于已有主规格与阶段计划的 Claude Code 项目,需要无人值守地完成单个开发阶段(规格、计划、实现、评审、提交)的流程化场景。

限制

  • 缺少 /codex-review 或 ultracode 工作流支持时必须中止,不可用临时评审替代。
  • 仅处理一个阶段,不自动继续下一阶段。
  • 逻辑相关模块必须严格 TDD;胶水/配置模块仅需冒烟测试,误分类属违规。
  • 冻结测试后不得为通过而修改、跳过或弱化测试断言。
  • 收敛轮次超限且仍有未解决错误时须上报,不得提交有问题的代码。
  • 未提供收费、价格或平台兼容性信息。