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.yamlaiko-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 放行(不再管写它)

On this page