SDD 能力底座

四种工作流怎么选

full / spec / hotfix / tweak 对比 — 设计落点、plan、TDD、审查与适用场景

起 change 时按任务大小选工作流。选轻了缺少必要设计评审,选重了写一堆用不上的文档——按这张表对号入座。

对比表

full(SDD 完整流程)spechotfixtweak
设计落点Superpowers Design Doc + planOpenSpec design.md(概要 + 可选详细设计)精简 design.md精简 design.md
plan(执行计划)✅ writing-plans
TDD可选(默认询问)可选(默认 direct)directdirect
代码审查可选(off/standard/thorough)可选(默认 standard)offoff
验证深度完整完整轻量轻量
决策点五字段全问(plan/执行方式/TDD/隔离/审查)详细设计裁判 + TDD/审查一次问
阶段形态open→design→build→verify→archiveopen→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 起)

  1. 详细设计裁判:概要设计落 design.md 后,复杂时调 superpowers:brainstorming 讨论,确认稿写回 design.md「详细设计」章节;详细设计推翻业务任务前提时才回头修订 tasks.md(业务任务边界不随技术方案变)
  2. build 入口一次问清:TDD(默认 direct;选了走 test-driven-development)+ 代码审查(默认 standard)

On this page