SDD 能力底座
生命周期与阶段产物
open → design → build → verify → archive — 每阶段写什么、门禁查什么
SDD 五阶段(spec/hotfix/tweak 跳过 design,四段式)。每阶段有明确产物和门禁校验,aiko-guard.sh <change> <phase> --apply 推进。
open(需求)
产物:proposal.md(动机+目标+范围)、design.md、tasks.md、specs/(delta spec,spec/full 流程需要)。
- tasks.md 是业务功能任务("商品加购"这种),实现细节进 design.md,不进 tasks
- change 创建即写
.aiko.yaml(aiko-state.sh init <name> <workflow> [requirement],workflow/phase/归属一次落盘) - 门禁:proposal/tasks 非空且至少一个任务;full 额外要 design.md
design(设计,仅 full)
产物:Superpowers Design Doc(docs/superpowers/specs/)+ 实现 plan(docs/superpowers/plans/)+ brainstorm 检查点(.aiko/handoff/brainstorm-summary.md)。
- 门禁:Design Doc 存在、frontmatter 关联当前 change(
aiko_change:)、声明技术角色与 OpenSpec 为准绳 .aiko.yaml记录design_doc/plan路径
build(构建)
产物:源码实现 + tasks.md 逐项勾选。
- full 的五字段门禁:plan → build_mode → tdd_mode → isolation → review_mode 逐级解锁,齐了才放行源码
- spec/hotfix/tweak 预设字段已在 init 落好(direct),build 入口只确认 TDD/审查
- 节奏门禁:连续 30 次源码写入未勾选 tasks.md 会被拦,勾选后重置
- 出 verify 前:任务全部勾选 + 构建通过(无构建体系的项目自动放行)
verify(验证)
产物:.aiko/verify-report.md + verify_result: pass + branch_status: handled。
- 验证报告必须落盘并在
.aiko.yaml登记;分支处理完才能转归档 - spec/full 走完整验证(含 delta spec 验收场景),hotfix/tweak 轻量验证
archive(归档)
产物:change 目录移入 openspec/changes/archive/<date>-<id>/,delta spec 按 ADDED/MODIFIED/REMOVED 合并进主 spec。
- 门禁:
verify_result: pass是硬条件 - 归档后 phase-guard 对该 change 放行(不再管写它)