SuperAPI AI 工具集

tdd-harness

测试与质量

查看项目

更新于 10-15 20:08

技能介绍

用途:tdd-harness 是一个企业级测试驱动开发(TDD)编排器,负责把用户想构建的功能、产品或修复,从想法一路推进到可评审的 Pull Request,而不是临时随手写功能代码。

主要能力:它按四个阶段驱动流水线,每个阶段本身是一个独立技能,需通过 Skill 工具按顺序调用:1)tdd-plan,把需求拆成薄的垂直切片,在 plans/<feature>/ 下生成 README 索引和每个切片一个计划文件;2)red-green-refactor,先写失败的验收/e2e 测试(外层循环),再通过内层单元测试的红→绿→重构循环实现,直到验收测试变绿;3)tdd-ci,把测试接入 GitHub Actions,在每次 push 和 PR 时运行;4)safe-pr,从功能分支向 main 开 PR,附带测试日志、Playwright 截图和录屏等证据。可选第五步 safe-cleanup 在 PR 合并后清理本地陈旧切片分支。

使用方式:先澄清目标并用一两句话复述确认;若系统尚无构建/测试/部署流水线,阶段 1 会从 walking skeleton 切片开始。阶段 1 产出切片列表后需用户审阅并批准第一个切片;阶段 2 针对已批准切片开发;本地全绿后进入阶段 3;阶段 4 在用户确认后推送并开 PR。之后回到阶段 2 处理下一个切片,一个切片等于一次 RGR 等于一个 PR。用户也可直接调用任一阶段技能(/tdd-plan、/red-green-refactor、/tdd-ci、/safe-pr),不必强制走完整流水线。

约定:计划位于 plans/<feature-slug>/README.md 与 plans/<feature-slug>/<NN>-<slice-slug>.md;分支为 feat/<feature-slug>/<NN>-<slice-slug>,从最新的 main 切出;证据放在 docs/tdd-evidence/<feature-slug>/<NN>-<slice-slug>/;提交遵循 Conventional Commit 风格且仅在绿时提交。

限制与门禁:没有切片计划不得写代码;本地未全绿不得进入 CI 阶段;未绿且未提交 CI 工作流不得开 PR;PR 默认只针对 main,除非用户明确另行说明;禁止 force-push;任何推送或创建 PR 前必须确认;一次只处理一个切片,不得把多个切片合并到一个分支或 PR。具体安装命令、收费与平台信息暂未提供。