课程设计
课程共 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 流程,避免为了流程而流程。
课程目录
Chapter 1
2 课时第一章:为什么需要 SDD
从 Vibe Coding 的局限出发,理解 SDD 的核心回答,并建立完整工作流全景图。
Chapter 2
4 课时第二章:SDD 的规格体系
学习项目级 Constitution 和功能级 Feature Spec 的写法,并在命令行 TODO Demo 项目中完成实操。
01第一节:项目级规格:Constitution讲清 Mission、Tech Stack、Roadmap 三份项目级 Spec 各自负责什么,以及写到什么程度比较合适。视频 / 图文30 分钟02第二节:Constitution 实操以命令行 TODO 工具为 Demo 项目,演示如何与 Agent 对话产出 Mission、Tech Stack 和 Roadmap。视频35 分钟03第三节:Feature 级规格:Feature Spec讲清 plan.md、requirements.md、validation.md 分别解决什么问题,以及怎样写得清楚、不过度。视频 / 图文30 分钟04第四节:Feature Spec 实操从 Roadmap 取出第一个 Feature,与 Agent 对话产出 plan.md、requirements.md 和 validation.md。视频35 分钟
Chapter 3
4 课时第三章:从 Spec 到交付
学习 Feature Loop 和 Replanning,把写好的 Spec 接到实现、验收、合并和持续改进的流程里。
01第一节:Feature Loop:从 Spec 到交付讲清 Plan、Implement、Validate、Merge 四步流程,以及你在每一步该如何跟进和纠偏。视频 / 图文30 分钟02第二节:Feature Loop 实操把上一章写好的 Feature Spec 交给 Agent,完整跑通一次实现、验收和合并流程。视频40 分钟03第三节:Replanning:持续改进的机制讲解每个 Feature 后如何复盘 Roadmap、Constitution 和工作流,并重新校准 MVP。视频 / 图文30 分钟04第四节:Replanning 实操 + 第二个 Feature在第一个 Feature 交付后做一次完整 Replanning,再交付第二个 Feature 并锁定 MVP 范围。视频40 分钟
Chapter 4
4 课时第四章:老项目如何引入 SDD
面向已有代码和零散文档的项目,学习如何补出 Constitution,并把 SDD 流程渐进引入日常开发。
01第一节:反向工程:从代码生成 Constitution讲清如何让 Agent 先读懂老项目,再协助整理 Mission、Tech Stack 和 Roadmap。视频 / 图文25 分钟02第二节:反向工程实操选择一个真实老项目,现场演示探索代码库、生成 Mission、提取 Tech Stack 和还原 Roadmap。视频40 分钟03第三节:渐进式迁移与落地讲清有了 Constitution 之后,如何在老项目里先跑通第一个 Feature Loop,再逐步推广到日常开发。视频 / 图文30 分钟04第四节:渐进式迁移实操 + 课程总结基于反向工程产出的 Constitution,在老项目中跑第一个 Feature Loop,并回顾四章核心内容。视频40 分钟