spec-finish 是用于实现后收尾的工作流技能,位于 spec-implement 之后。前提条件:所有实现任务完成、工作目录干净(已提交或已暂存)、测试通过;否则需返回 spec-implement。
流程分五步。第一步验证:运行测试套件(如 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 修复,全部通过再继续。
第二步评审:通过 Skill 工具调用 code-review 技能,检查特性分支以来的所有变更文件、测试覆盖率、文档更新及是否残留调试代码;发现问题则修复或记录后续处理,并重新验证。
第三步堆叠提交:调用 code-stacked-commit 技能,用 gt stack 查看当前堆栈,确保提交组织合理、必要时用 gt branch restack 重排,保证每个提交干净且可运行;提交应通过测试、使用约定式提交格式并写有意义的提交信息。
第四步更新文档(可选):可按需使用 code-docs 技能,检查 README、API 文档和变更日志是否需要更新,并与文档一起提交。
第五步准备 PR:确认全部测试通过、评审完成、文档更新、提交堆叠正确,并输出完成摘要(特性名、测试/类型检查/Lint 的通过情况、堆栈提交数量、是否可提 PR),然后交接说明实现完成、已堆叠 N 个提交、可提交或开 PR。
该技能会编排其他技能:code-review 用于质量检查、code-stacked-commit 用于提交管理、code-docs 用于文档更新。不建议在实现仍在进行、测试失败或评审发现阻塞问题时使用,这些情况应回到 spec-implement。