SDD 实战

规范驱动开发（Specification-Driven Development）实战系列。 从手写第一份 spec 开始，到 OpenSpec、BMAD、Superpowers 等工具的协同实操。 配套代码库 sdd-in-action， 每一篇都能跟着跑通。

这是我 SDD 课程的实操配套。把概念落到能跑通的具体动作上： Specify → Clarify → Implement 的三段闭环， 两层 Spec（项目愿景 + 任务变更）的结构， 以及它们在真实工程里怎么和现有的 Memory、Sub-Agents、Skills 协同。

• 第 1 篇 SDD 本质：手写第一份 spec

  不装任何工具，只用 Claude Code / OpenCode，手写一份能跑的 spec。从 Vibe 路径和 SDD 闭环的双路对比开始，看清规范驱动开发到底解决什么问题。

• 第 2 篇 Memory 工程：AGENTS.md 的 SDD 化重写

  把项目级 Memory 文件 AGENTS.md 当作 spec 来重写。用 SDD 三阶段——Specify、Clarify、Implement——把零散的项目说明变成可验收的规范。

• 第 3 篇 Sub-Agents 角色分工：三 Agent 协作规格

  用 SDD 给三个 Sub-Agent 写协作规格：每个 Agent 的输入、输出、边界、失败模式。一份规格 = 一次明确的角色对话契约。

• 第 4 篇 SDD 两层 Spec 的完整故事：从灰度开始讲

  Spec 不是一份文档，是两层结构：项目级愿景 + 任务级变更。从灰度发布这个真实需求切入，把两层 Spec 的演化过程讲清楚。

• 第 5 篇 OpenSpec 实操指南

  OpenSpec 是 SDD 思想落地的开源工具。这一篇是完整实操：怎么装、怎么跑、怎么和 Claude Code / OpenCode 协同，附完整命令清单和踩坑记录。

• 第 6 篇 BMAD + OpenSpec 协同实操：add-metrics-collector

  用一个真实需求——给项目加一个指标采集器——把 BMAD 方法论和 OpenSpec 工具串起来。从需求到 spec 到代码到验收，端到端走一遍。

• 第 7 篇 Superpowers 详解 + 实操指南

  Superpowers 是 SDD 体系下的一类高阶能力封装。这一篇把它的设计哲学、调用方式、以及与 Skills / Sub-Agents 的边界讲透。