SuperAPI AI 工具集

spec-finish

编程与开发

查看项目

更新于 10-16 00:06

技能介绍

用途:Spec Finish 是 Spec-backed Plan 实现完成后的收尾工作流,衔接 spec-implement 与最终 PR,流程为简化→同步文档→验证→审查→准备 PR。

前提:所有 Spec-backed Plan 任务已完成;工作目录无未解决的暂存或未暂存改动;测试通过。否则应回到 spec-implement。

主要步骤:1)对比实现与原始行为和用户目标,删除未请求的范围、重复概念、单消费者抽象及替代平台能力的自定义机制;若实现遵循了不必要的大设计,应停止并回到 spec-plan 获取更小方案的批准,并更新 SDD。2)检查 README、API 文档或 changelog 是否需要更新,通过 code-commit 提交。3)运行验证:测试(npm test / pytest / cargo test)、类型检查(npm run typecheck / python -m mypy / cargo check)、Lint(npm run lint / ruff check . / cargo clippy)、构建(npm run build / go build ./...);失败则回到 spec-implement。4)通过 harness 的技能机制调用 code-review 做一次全面审查,覆盖自目标基线分支合并基点以来的所有改动文件、测试覆盖、文档更新、无调试代码;小问题可在此修复并重新验证审查,阻塞或改变范围的问题回到 spec-implement。5)用 git log --oneline 查看提交,未提交工作用 code-commit;默认不重写历史,若 rebase 能显著改善未发布栈,需展示受影响范围并单独获批。6)前五步全部完成后,先向人类展示完成摘要(功能、测试、类型检查、Lint、审查、提交数、是否可开 PR),仅当 Ready for PR 为 yes 时调用 code-pull-request 创建 PR,它会检测平台(GitHub/GitLab)、检查已有 PR、查找模板、根据提交生成正文并通过 gh 或 glab 打开 PR。

集成:编排 code-review 与 code-pull-request。

不适用:实现仍在进行、测试失败、审查发现阻塞或改变范围的问题、实现遵循不必要的大设计时,应分别回到 spec-implement 或 spec-plan。

限制:资料未提供具体安装方式、收费、价格或平台支持细节。