SDD 能力底座
四种工作流怎么选
full / spec / hotfix / tweak 对比 — 设计落点、plan、TDD、审查与适用场景
起 change 时按任务大小选工作流。选轻了缺少必要设计评审,选重了写一堆用不上的文档——按这张表对号入座。
对比表
| full(SDD 完整流程) | spec | hotfix | tweak | |
|---|---|---|---|---|
| 设计落点 | Superpowers Design Doc + plan | OpenSpec design.md(概要 + 可选详细设计) | 精简 design.md | 精简 design.md |
| plan(执行计划) | ✅ writing-plans | ❌ | ❌ | ❌ |
| TDD | 可选(默认询问) | 可选(默认 direct) | direct | direct |
| 代码审查 | 可选(off/standard/thorough) | 可选(默认 standard) | off | off |
| 验证深度 | 完整 | 完整 | 轻量 | 轻量 |
| 决策点 | 五字段全问(plan/执行方式/TDD/隔离/审查) | 详细设计裁判 + TDD/审查一次问 | 无 | 无 |
| 阶段形态 | open→design→build→verify→archive | open→build→verify→archive(跳过 Superpowers 设计阶段) | 同 spec | 同 spec |
| 适用 | 复杂功能、跨模块、架构决策 | 需求清晰的中型功能 | 行为修复、范围可预估 | 小调整 |
升级条件(轻流程要主动升 full)
- 设计说不清,需要 Superpowers 级详细设计(逐字段规格 / 多方案对比 / 逐步 TDD plan)
- 大型架构改动、跨子系统重构
- hotfix 发现根因涉及接口/架构调整、改动超 2 个文件或任务超 3 个
升级时:aiko-state.sh set <change> workflow full + set <change> phase design,然后走 /aiko-design 补 Design Doc。
spec 的两个新决策点(2026-07 起)
- 详细设计裁判:概要设计落
design.md后,复杂时调superpowers:brainstorming讨论,确认稿写回design.md「详细设计」章节;详细设计推翻业务任务前提时才回头修订 tasks.md(业务任务边界不随技术方案变) - build 入口一次问清:TDD(默认 direct;选了走 test-driven-development)+ 代码审查(默认 standard)