BlueprintOS TDD(桥接到 superpowers)
Contract
- Inputs: executable task from writing plan, test target, acceptance criteria
- Outputs: RED test, GREEN implementation, refactor notes
- Gates: RED observed before implementation; GREEN observed after implementation
- Required disciplines:
stage-gate - Next:
/executing-plans
本仓库不维护此 skill 的内容。完整纪律请读:
<SUPERPOWERS_SKILL_ROOT>/tdd/SKILL.md
何时调
- writing-plans 之后
- 每个子任务开始时(红绿循环)
衔接点
- 产出:RED 测试 + GREEN 实现 + REFACTOR
- 下一步:
/executing-plans(commit + 下一任务) - 门控:
disciplines/stage-gate第 3 层(RED 必须确认失败才能写实现)
降级方案(superpowers 未装时)
如果 <SUPERPOWERS_SKILL_ROOT>/tdd/ 不存在,严格按以下 4 步红绿循环:
1. RED — 写失败测试
- 在
src/test/写测试,只测一个最小行为 - 跑测试 → 必须确认失败(看到红色 / FAILURE,不是 BUILD SUCCESS)
- ❌ 跳过 RED = 你不知道测试到底在测什么
2. 最小实现
- 写最少量代码让测试通过(可以丑 / 可以硬编码)
- 不优化、不重构、不扩展
3. GREEN — 跑通
- 再跑测试 → 必须确认通过(看到 BUILD SUCCESS / PASSED)
- ❌ 测试莫名通过 = 测试没断言你想要的东西
4. REFACTOR — 重构
- 改进实现 / 抽取方法 / 命名优化
- 每次重构后必须重跑测试确认仍 GREEN
- 改完再跑 = 唯一能防止重构破坏功能的方法
最小纪律摘要
- RED 必须亲眼看到失败:写测试 → 跑 → 看 stack trace → 才写实现
- GREEN 后才能 REFACTOR:实现未通过前重构 = 在错的地基上盖楼
- 测试一次只测一个行为:堆叠断言 = 失败时不知道哪个挂了
- 不 mock 你要测的东西:只 mock 边界 IO
安装提示
npx skills@latest add obra/superpowers-tdd