SDD 能力底座
SDD 总览
Spec-Driven Development — OpenSpec change 目录 + .aiko.yaml 状态机 + phase-guard 门禁 + skill 驱动的开发方式
SDD(Spec-Driven Development)是 Aiko IDE 把"需求 → 设计 → 实现 → 验证 → 归档"做成可机检的状态机的开发方式:规格先于代码,阶段推进有门禁,进度落盘可追溯。
三个支柱
| 支柱 | 是什么 | 在哪 |
|---|---|---|
| OpenSpec change | 一次开发任务的全部规格:openspec/changes/<id>/ 下的 proposal.md / design.md / tasks.md / specs/ | 工作区仓库内 |
**.aiko.yaml 状态文件 | 唯一权威状态:workflow、phase、各模式字段、需求归属(requirement) | 每个 change 目录内 |
| phase-guard | 写文件门禁:按阶段白名单放行/拦截(Claude / Codex / opencode 三形态同一套判定) | ~/.aiko/claude-auth/skills/aiko/scripts/ |
工作方式
- 选需求:从 Aiko Studio 拉 PRD 落盘(
.aiko/sdd-input/<slug>/),或直接描述需求 - 选工作流:full / spec / hotfix / tweak 四档(下一页详细对比),Aiko 会按任务建议,你确认
- 按流程走:skill 驱动每个阶段(
/aiko、/aiko-spec、/aiko-hotfix、/aiko-tweak),写产物、推进状态、过门禁 - 看进度:SDD 面板实时显示阶段条、任务勾选、验证/归档进度
和"聊天写代码"的区别
- 规格是先写、可审、可归档的资产,不是聊完就散的上下文
- 阶段门禁保证"没设计完不许写码、没验证完不许归档"——AI 也不能越级
- 中断可续:状态全在文件里,换个窗口/换天接着干
下一页:四种工作流怎么选