> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# 我如何通过SDD精通Claude Code
- URL: https://www.hubwiz.com/blog/how-i-masterd-claude-code-using-spec-driven-development/
- Published: 2026-05-24T04:10:02.000Z
- Updated: 2026-05-24T04:10:02.000Z
- Description: 当我们把 Claude Code 和 Spec-Driven Development（规范驱动开发） 结合起来时，这一切就成为可能。
- Author: admin
- Tags: VIBE CODING, SDD, #Import 2026-10-14 14:41

我以前开发每个功能都采用同样的方式：打开文件，把文件分享给 AI，要求做一些修改，然后自己搞定剩下的部分。这种方式确实有效，而且实际上效率还不错。

但有一个问题——AI 从来没有获得过足够的上下文，因此无法主动改进代码，除非你明确要求。

想象一下，你只是简单地把一个文件发给承包商，然后说：修一下这个！

*"为什么要修？这个文件和什么有关联？错误确实出在这个文件里吗？我能添加哪些改进？"*

承包商一定会感到一头雾水，对吧？

但如果你和承包商分享一份头脑风暴/开发规范文档，解释所有的"为什么"和"怎么做"。召开一些讨论会议来确定解决方案，在明确了需要完成的工作范围之后，双方达成一致来交付这个方案。

这样，承包商就能更高效地工作。AI 也同样可以做到！

当我们把 **Claude Code** 和 **Spec-Driven Development（规范驱动开发）** 结合起来时，这一切就成为可能。

为了让这一点更具体，让我们跟踪一个真实项目的每个阶段：在 Microsoft Fabric Lakehouse 上构建一个实时数据湖，遵循 MedalLion 架构。

我将从我的仓库中取出一个旧项目，让它焕发新生。但请注意关注 SDD 方法论本身，而不是项目本身。

## 0、五阶段流水线

SDD 回答的是**做什么**、**怎么做**和**谁来做**。

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-vueQODzz7lXGnPiT-1.png)

最终产出不仅仅是代码。它是文档——解释了权衡取舍、每个步骤的计划，以及从过往对话中学到的经验教训。

每个阶段都会产出一份**活文档**，作为下一阶段的输入。对话之间不会丢失任何信息。

要调用每个阶段，你需要一个 *.claude* 文件夹，其中包含每个阶段的模板：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-hiZqn0FslXD7qzSg-1.png)

让我们用一个真实案例来解释每个阶段：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-CmJYdq6EncRB6YJh-1.png)

## 1、Brainstorm（头脑风暴）

当你与客户进行头脑风暴会议，或者对需要解决的问题只有一个模糊的想法时，使用这个阶段。

头脑风暴 Agent 通过结构化对话工作，每次只问一个问题。它会审查已有的内容，探索 2-3 种方案，强制进行 YAGNI（你不会需要它）思考，最终产出准备好进入 */define* 阶段的草稿需求。

调用方式使用命令：

- */workflow:brainstorm "Open DataLake with weather, swells, and waves on Microsoft Fabric"\`*
- */workflow:brainstorm C:\\Workspace\\MEETING\_DISCUSSION.md*

有两种调用方式，我们先试试第二种：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-VDvwIOvl-ujfj8J3-1.png)

一份完整的头脑风暴文档，解释了解决方案和各种权衡取舍。

最后，我们会进行评审，然后就可以进入下一步了。

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-vGl8nBeXffFduX-9-1.png)

## 2、Define（定义）

将头脑风暴转化为经过验证的需求文档，并设有可衡量的质量门禁。Agent 会从 5 个维度评分。低于 12/15 分将阻止进入下一阶段。

在这种情况下，模糊的需求可能变成 bug，我们在这里定义头脑风暴文档中所有未明确的缺口。

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-9lff2FBwNWqeTLWy-1.png)

我们会得到另一份文档，解释这个阶段的所有内容：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-X3CDhkh2Oz26NPdu-1.png)

例如，在这种情况下，它发现了一个缺口并提出问题：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-ybjahCcn3tbxWMVi-1.png)

回答这个问题后，它会更新 /define 文档：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-8ZIHz4epNaPzEjjp-1.png)

我们准备好继续前进了！

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-MoEFM4c_Gr6l3xJb-1.png)

## 3、Design（设计）

产出完整的技术讨论和蓝图：架构、关键决策和文件清单。

设计文档变成了一份执行计划。不是参考文档，而是一份脚本。

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-JYGL0jTE34Y3xynz-1.png)

它会创建完整的项目结构，解释每个文件夹的用途和决策：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-KWwqBjv-OU5gSely-1.png)

让我们仔细看看……

我们有架构概览部分：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-ePF5qxq_QSTdUZl8-1.png)

组件以及关键决策（来自我们的头脑风暴和定义阶段）将如何应用到我们的项目中：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-ZOLn74gSQb71HQwG-1.png)

每个 Pipeline 的说明：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-5FP1doVEMFwY6D1K-1.png)

文件清单，基本上是一个目录的雏形：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-WZ_BBM7N9095kyws-1.png)

每个 Notebook 要应用的代码模式，这是良好实践：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-fGL3lp-cDAHMO8vn-1.png)

集成、测试策略、错误处理、配置等等：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-tR0OaNPiUbkVV0aM-1.png)

你觉得哪个部分不合理，需要更改、删除或添加？

直接在文档中修改，然后和 AI 讨论。

如果你有一份好的头脑风暴文档，你就会得到一份好的定义文档。好的定义文档会创造出出色的设计文档。

设计文档……我们来看看！

## 4、Build（构建）

我们的构建 Agent 基本上会读取文件清单，按依赖关系排序工作，然后通过 Claude Task Pool 委派给各个 Agent。可以并行的就并行，必须串行的就串行。

见证奇迹的时刻到了：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-4uUUBsyT5WI9d1nM.png)

Claude 会列出计划，并对每个文件请求你的确认：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-jJmZ63sFHcCui_gE.png)

配置文件、工具函数、Notebooks 文件夹、带有模拟环境 fixtures 的测试文件夹，以及种子数据——所有这些都是由 Claude 创建的，你可以在整个过程中进行审批：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-VpERGOlp0Ewzw37p.png)

我不是说你应该全盘接受，你需要验证每一步，审视代码。就像对待承包商一样。

最后，Claude 会添加一份新的构建文档，解释所完成的所有工作：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-HMg0UD8-LuZPLZ0_.png)

并为你提供 /ship 代码到 Fabric 的教程选项：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-YDhS0pCR1OmOvW3h.png)

## 5、Ship（交付）

这里是 Claude 应用我们定义的交付策略的地方，它能够在终端中运行命令，并在云中创建所需的资源。

但我意识到在我们最新的文件中没有提到这一点。所以，让我们用 **/iterate** 来做一些修改。

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-a0G6XjXgfZHcez_4.png)

我要求 Claude 在 Ship 流程中加入 Terraform，它会重写并更新所有文档和步骤，添加这个 Terraform 部分：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-K4-qETig4LWYH-Y_.png)

太疯狂了！

现在我们有了一个新的 Terraform 文件夹：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-k3uG1O1AKZwSV6Ik.png)

而且我们在构建报告中也有了新的 Ship 计划：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-ZxATXJtEhqVKbWw4.png)

来看看是否能正常工作……

我首先运行开发环境：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-yTty2yuAVqXeFlX3.png)

一切就绪！终端中一切正常：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-bospfNoOhQtWNwr-.png)

现在来看看 Fabric：

![None](https://www.hubwiz.com/blog/content/images/2026/05/0-fn_6tycptrdXmgMO.png)

所有资源在不到 2 小时内构建并部署完成。从头脑风暴到部署不到 2 小时。我知道我已经说过一次了，但这真的太疯狂了！！！

这就是我目前使用 Claude Code 的方式，你可以改进并为这 5 个阶段创建自己的模板。

另一件事是创建专门的 Agent 来检查与你将在项目中使用的技术相关的知识库，添加技能是另一个选项，还有很多可以改进的地方。

---

原文链接: [How I Master Claude Code with Spec-Driven Development](https://medium.com/@lorenzouriel/how-i-master-claude-code-with-spec-driven-development-b7c1de15ff9b?ref=hubwiz.com)

汇智网翻译整理，转载请标明出处