AI 编程进阶2026-06-08 更新

SDD:Spec-Driven Development

从规格体系到交付闭环,用 Spec 驱动 Agent 编码

SDD(Spec-Driven Development)是一种用规格驱动 Agent 编码的开发方法。它把目标、边界、技术约束和验收标准写成可以版本管理的 Spec,再让 Agent 基于这些 Spec 完成实现、验证和交付。

这门课按照 Why → What → How → Migrate 的路线展开:先解释 Vibe Coding 为什么在复杂项目中失控,再建立 Constitution 和 Feature Spec 的规格体系,随后跑通从 Spec 到交付的 Feature Loop 与 Replanning,最后讲解已有项目如何反向补齐 Spec 并渐进式迁移到 SDD。

课程设计

课程共 4 章 14 个课时。它不是让你背一套固定流程,而是帮你判断:什么时候需要完整 Spec,什么时候只要轻量记录,什么时候可以继续快速试错。

  • 第 1 章建立全景:看清 Vibe Coding 在复杂项目中的问题,也知道 SDD 不是“多写文档”,而是在合适的位置留下关键上下文。
  • 第 2 章聚焦规格体系:学习项目级 Constitution 和功能级 Feature Spec 的写法,同时讨论文档写到什么程度够用、哪些内容可以合并或省略。
  • 第 3 章聚焦交付流程:把 Feature Spec 交给 Agent 实现,按 validation.md 验收,再通过 Replanning 吸收真实开发中出现的新信息。
  • 第 4 章聚焦存量迁移:面对没有 Spec 的老项目,不追求一次性补全,而是从最值得补的地方开始,逐步把 SDD 接入日常开发。

你会学到什么

  • 为什么一次性对话式的 Vibe Coding 容易带来上下文衰减、意图漂移和代码堆砌。
  • 如何编写 Mission、Tech Stack、Roadmap 三份 Constitution 文件,让项目拥有稳定的根上下文。
  • 如何编写 plan.md、requirements.md、validation.md 三份 Feature Spec,让单个功能可执行、可验证、可交付。
  • 如何用 Feature Loop 完成 Plan、Implement、Validate、Merge,并在 Agent 跑偏时用 Spec 纠偏。
  • 如何在每个 Feature 后做 Replanning,让 Roadmap、Constitution 和工作流持续进化。
  • 如何为已有项目反向生成 Constitution,并用轻量、渐进的方式推广 SDD。
  • 如何根据项目大小、风险和维护周期裁剪 SDD,而不是机械套模板。

适合人群

  • 正在用 AI Agent、Codex CLI、Claude Code、Cursor 或类似工具辅助开发的工程师。
  • 已经感受到 AI 编程速度,但开始遇到上下文丢失、需求漂移、重复解释项目背景等问题的人。
  • 希望让 Agent 编码成果更可控、更容易验收、更适合长期维护的个人开发者或团队。
  • 接手老项目、缺少文档、希望让 Agent 更可靠地理解存量代码的工程负责人。

学习路径

你会先建立 SDD 的整体框架,再逐步学习每类 Spec 的写法,随后把 Spec 接入交付流程,最后把这套方法迁移到真实老项目。学完后,你不只是知道流程怎么跑,也能判断流程该跑多完整、哪里要写细、哪里可以保持轻量。

学习目标

解释 Vibe Coding 在复杂项目中的一次性代码、上下文衰减和意图漂移问题。
画出 SDD 从 Constitution 到 Feature Loop、Replanning、MVP 的完整链路。
能为新项目产出 Mission、Tech Stack、Roadmap 三份 Constitution 文档。
能为单个 Feature 产出 plan.md、requirements.md、validation.md 三份可执行 Spec。
能按 Feature Loop 跟进 Agent 实现、完成验收、合入主干并复盘。
能为已有项目反向生成 Constitution,并选择渐进式 SDD 落地路径。
能根据项目复杂度裁剪 SDD 流程,避免为了流程而流程。

课程目录