让 AI 写代码结果一团糟？从编写‘设计蓝图 (Spec)’开始，情况将大不相同

想象一下，为了建造你梦想中的乡村别墅，你雇佣了资深的建筑师和施工队。但到了现场你却这样说：“那个，请帮我盖一栋住起来舒服又漂亮的两层小楼。厨房要宽敞一点，采光要好。你是专家，看着办吧！”

结果会怎样？也许你会看到马桶孤零零地放在客厅中央，或者上二楼的楼梯被天花板堵住，最终建成一栋荒谬的房子。

然而，最近在软件开发者之间，处理‘Claude Code’（专门用于编程的 AI Agent 工具）的一种全新方法成为了热门话题。与其盲目地让 AI 编写代码，不如先让它编写一份详细的‘设计蓝图 (Spec)’，这就是 规范驱动开发 (Spec-Driven Development，以下简称 SDD) [Claude Code Spec-Driven Development Implementation Guide]。

为什么这很重要？ (Why It Matters)

当听说 AI 能完成所有编程工作时，我们曾欢呼工作速度将瞬间提升数十倍。但现实并非如此。只要项目稍微复杂一点，与 AI 的协作很快就会变成沉重的负担 (cumbersome) [ClaudeCode:Spec-DrivenDevelopment(SDD)]。这是因为 AI 会忘记前后语境，或者出现修复了一处却弄坏了另一处的情况。

易于理解的解释 (The Explainer)

规范驱动开发 (SDD) 的核心是将庞大的任务从两个维度 (two dimensions) 进行精准拆分 [Show HN: Spec-Driven Development Workflow for Claude Code]。

1. 彻底的前期调查 (Research) 就像盖房前要检查土地状况一样，投入多个 AI Agent 对当前系统的状态和问题进行立体分析 [Spec-DrivenDevelopmentwithClaudeCodein Action | alexop.dev]。

2. 编写坚实的设计蓝图 (Spec Creation) 这是最关键的阶段。基于调查结果，创建一份包含需求 (requirements) 和系统设计的规格说明书文档 [Show HN: Spec-Driven Development Workflow for Claude Code]。这成为了人类与 AI 之间一份不可动摇的书面规格合同 (written spec contracts) [Spec-DrivenDevelopmentwithClaudeCode]。

3. 任务碎片化 (Task Decomposition) 即使是再聪明的 AI，也无法一次性完成复杂的系统。将整个任务拆分成非常小的子任务 (subtasks) [Show HN: Spec-Driven Development Workflow for Claude Code]。

4. 分步实现与验证 (Implementation & Verification) 按顺序一个一个执行拆分后的任务并编写代码。此时不会一次性保存，而是采用以有意义的最小单位保存的原子化提交 (atomic commits) 方式，以提高安全性 [Spec-DrivenDevelopmentwithClaudeCode]。

举个例子： 在会议室的白板上写下各种想法并结束了讨论。现在需要具体集中精力处理‘窗户设计’，但如果白板上还留着‘屋顶颜色’或‘管道位置’之类的涂鸦，会怎么样呢？工作人员难免会感到困惑。

因此，在 SDD 中，原则上在每个阶段结束时都要 ‘完全清除 AI 的上下文（记忆语境）(clear context)’ [Show HN: Spec-Driven Development Workflow for Claude Code]。让大脑变为空白，只给它重新塞入刚刚完成的‘蓝图’和‘当下的目标’。这样，AI 就不会陷入幻觉（Hallucination，即把虚假信息说得像真的一样），而是能敏锐地专注于眼前的任务。

现状如何？ (Where We Stand)

随着这种方法的效果得到证实，全球开发者纷纷推出了将这一过程自动化的工具。

• ShipSpec: 开发者无需亲自动手写蓝图，AI 会分析项目并自动生成包含 3 个文档文件的蓝图 [ShowHN:SpecDrivenDevelopmentPluginforClaudeCode]。
• sddw: 直接让负责编程的 AI 本人编写自己的任务蓝图。帮助它自主制定计划并以小单位（原子任务）处理工作 [Spec-drivendevelopmentworkflow- how to get production-ready…]。

• claude-code-spec-workflow: 由开发者 Pimzino 公开的这个包在 GitHub 上获得了超过 3,700 颗星，受到了爆发性的欢迎 [GitHub - Pimzino/claude-code-spec-workflow: Automatedworkflows…]。Pimzino 强调：“将计划环节与实现环节分开是不可妥协 (non-negotiable) 的必要条件” [[Spec-Driven Development with Claude Code

  Build This Now](https://www.buildthisnow.com/blog/guide/mechanics/spec-driven-development)]。

未来会怎样？ (What’s Next)

未来的开发者将不再在电脑前通宵达旦，而是口述自己的想法。然后 AI 会分析这些语音，编写出完美的‘设计蓝图 (Spec)’，并自主编写代码，最后完成测试。事实上，全球企业 Notion 已经在其内部构建了这种方式的 AI 工作流 [Spec-drivendevelopment: The AI engineeringworkflowat Notion]。

最终，人工智能正在超越单纯接受指令的打字机，进化为能够自主计划和验证的自我开发 AI 系统 (Self-Developing AI System) [A Config-Driven Way to BuildSpec-DrivenWorkflowsforClaude…]。我们正在告别冲动的‘氛围感编程’，迎来作为一个描绘宏图的‘总建筑师’，指挥 AI‘建筑机器人’军团的时代。

AI 的观点

人工智能不是魔法棒，而是优秀的员工。要让员工发挥出实力，我们必须先提供清晰的蓝图，明确‘想要什么’，这再次印证了这一朴素的真理。

参考资料

1. [在行动中通过 Claude Code 进行规范驱动开发

   alexop.dev](https://alexop.dev/posts/spec-driven-development-claude-code-in-action/)

2. GitHub - Pimzino/claude-code-spec-workflow: 自动化工作流…
3. 一种配置驱动的方法来构建 Claude 的规范驱动工作流…

4. [从氛围感编程到出货：我的规范驱动工作流…

   SunDr](https://www.sundr.dev/blog/spec-driven-development-claude-code)

5. 使用 Claude Code 进行规范驱动开发
6. Claude Code：规范驱动开发 (SDD)
7. Claude Code 规范驱动开发实现指南
8. 使用 Claude Code 进行规范驱动开发：正确构建

9. [使用 Claude Code 进行规范驱动开发

   Build This Now](https://www.buildthisnow.com/blog/guide/mechanics/spec-driven-development)

10. 使用 Claude Code 进行规范驱动开发：引导教程
11. Show HN: Claude Code 的规范驱动开发工作流

12. [Claude Code 规范工作流指南 (2026)

    ClaudHQ](https://claudhq.com/claude-code-spec-workflow-guide/)

13. 规范驱动开发工作流 - 如何获得生产就绪的…
14. ClaudeEngineer 简直疯了… 升级你的 Claude Code 工作流
15. Show HN: Claude Code 的规范驱动开发插件
16. 规范驱动开发：Notion 的 AI 工程工作流