当前“规范驱动开发”(Spec-Driven Development
)火热程度超过了“氛围编程”(Vibe Coding
),本文尝试使用Claude Code搭配Spec-Kit来体验下。
安装必要软件
安装Claude Code
一条命令执行即可:1
npm install -g @anthropic-ai/claude-code
设置模型
国内使用Claude系列模型的门槛较高,这里使用Qwen3-Coder
来替代。可以参考这里。
因为Qwen3-Coder
提供了对Anthropic格式的支持,所以直接设置环境变量即可。
对于其他模型,可以使用claude-code-router
这个库来实现,具体可参考这里。
1 | # 用您的百炼API KEY代替YOUR_DASHSCOPE_API_KEY |
设置完了别忘了source
一下。
安装Specify
1 | uv tool install specify-cli --from git+https://github.com/github/spec-kit.git |
至此,需要安装的软件都已经安装完成。
规范驱动开发流程介绍
Spec-Kit所定义的规范驱动开发包含5个顺序步骤:
建立项目原则
使用/constitution
命令创建项目的治理原则和开发指导方针,比如:1
/constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements
这一步创建
memory/constitution.md
文件,包含项目的基础指导原则。定义功能
使用 /specify 命令描述要构建的内容,专注于what
和why
,而不是技术栈,比如:1
/specify Build an application that can help me organize my photos in separate photo albums...
这个命令会自动创建新的功能分支并生成结构化的规格文档
spec.md
。
这一步完成后,最好马上查看下生成的该规格文档,检查其是否满足需求,这在“规范驱动开发”中非常重要,不要“默认正确”。
可以使用/clarify
来进一步澄清模糊的需求。
创建技术实现规划
使用/plan
命令提供技术栈和架构选择,比如:1
/plan The application uses Vite with minimal number of libraries. Use vanilla HTML, CSS, and JavaScript...
这会生成多个文件,包括
plan.md
、research.md
、data-model.md
、contracts/
和quickstart.md
。分解任务
使用/tasks
命令从实现计划创建可执行的任务列表:1
/tasks
这会分析计划和相关设计文档,生成
tasks.md
文件,包含有序的任务列表和依赖关系。实现
使用/implement
命令执行所有任务并根据计划构建功能:1
/implement
开始使用
如果是空白项目,则直接运行命令:1
specify init <project-name>
如果是已有项目,则可以运行:1
specify init --here
运行时会让选择是使用哪个编程智能体,这里选Claude
,也可以在启动时直接指定:1
specify init <project-name> --ai claude
启动Claude Code:1
Claude
然后依次按5个步骤走即可。