Claude Code Spec Workflow 把 Spec-Driven Development（规范驱动开发）落成“可执行流程”，用于解决 Vibe Coding 的需求模糊、架构混乱、维护困难等问题。本文系统整理从理念到落地的完整路径，适合复杂项目和团队协作场景。

为什么要用规范驱动开发

传统 AI 编程（Vibe Coding）虽然快，但常见问题有三类：

  • 缺乏长远架构考虑：代码结构随意、扩展困难
  • 需求定义不严谨：逻辑漏洞与边界问题频出
  • 维护成本高：质量参差不齐，后期重构代价大

规范驱动开发的核心是：先规范，再设计，再任务，再代码。把“写代码”变成“执行规范”的过程。

Spec-Driven 的核心产物

一套标准化流程通常由三类文档驱动：

  1. Guidelines（指导文档）
    • Product Guideline：产品愿景与目标
    • Tech Guideline：技术栈与约束
    • Project Guideline：项目结构与协作规则
  2. Spec（规格文档）
    • 需求细化、边界条件、验收标准
  3. Design + Tasks
    • 设计方案、模块拆分
    • 任务清单，便于协作与分步实现

快速开始

以 React + TypeScript 为例：

1
2

npx create-vite@latest my-app -- --template react-ts
cd my-app

可选 UI 库：

1
2

npm install @radix-ui/react-slot class-variance-authority clsx tailwind-merge lucide-react
npx shadcn-ui@latest init

初始化 Workflow：

1

npx claude-code-spec-workflow init

进入 Claude Code：

1

claude

Spec-Driven Loop（规范驱动闭环）

完整闭环建议按以下顺序执行：

  1. Guidelines：分析项目技术栈与目标，生成三份北极星文档
  2. Spec：针对具体功能输出规格文档
  3. Design：给出技术方案、接口与数据结构
  4. Tasks：拆解为可执行任务清单
  5. Code：严格按照规范完成开发

实战演示一：Claude Code CLI 流程

示例需求：开发一个背单词应用（学习、练习、进度查看功能）。

典型流程：

  • 在 Claude Code 中执行 /plan 或工作流命令
  • 生成三份 Guideline
  • 选择模块（如“学习模块”），生成 Spec → Design → Tasks
  • 按任务清单实现代码
  • 新模块（如“复习模块”）沿用同样流程

这样做的优势是：每次迭代都能复用规范，不会偏离最初的需求与架构设定。

实战演示二：MCP Server

此方法适合不习惯命令行的用户，通过 MCP 协议在编辑器内完成流程。

1. 配置 MCP Server

在 Cursor 设置中打开 Features → MCP Servers，点击 Add New MCP Server，填入名称和启动命令（指向项目路径）。

配置示例：

1
2
3
4
5
6

{
  "spec-workflow": {
    "command": "npx",
    "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/Users/lwy/Desktop/spec-demo"]
  }
}

2. 启动 Dashboard

1

npx claude-code-spec-workflow-dashboard ./my-project-path

浏览器会打开可视化面板，用于查看生成的规范文档与任务清单。

3. 在 Cursor 中使用

在 Chat 中直接对话即可，例如：

请使用 Spec Workflow 设计一个用户登录模块，并生成 Spec 与任务清单。

使用建议与注意事项

  • 需求越具体，Spec 越可靠，开发越稳定
  • Spec 是“契约”，不是一次性文件，迭代时要同步更新
  • 任务清单要小步可执行，避免大而泛
  • 规范优先于代码，先对齐再实现
  • 团队协作时，Guidelines 是统一语言

结语

Vibe Coding 适合快速验证想法，但进入工程阶段就必须引入规范流程。Claude Code Spec Workflow 把 Spec-Driven 思路落地成可执行操作，让 AI 编程不再“玄学”，而是“工程化的可控流程”。

下一步建议：

  1. 在真实项目里跑一遍完整流程
  2. 选一个核心模块做闭环验证
  3. 让团队形成统一的规范模板