规范驱动开发 · 教程入口

spec-kit 超详细使用教程

基于 GitHub spec-kit + Claude Code 的规范驱动开发完全指南。 这是整套教程的总入口,你可以按章节阅读,也可以按角色选择学习路径。

工具版本:spec-kit v0.4.3 配套 AI:Claude Code 适用对象:产品 / 开发 / 测试

Authored by JMC · Published & designed by Chorvy

学习路径

按角色进入

如果你不是从头通读,建议先按自己的工作角色进入对应学习路线。

01

产品经理怎么读

重点掌握如何把自然语言需求转成结构化规格,理解澄清与验收标准的写法。

  • 重点章节:核心工作流
  • 重点阶段:Specify / Clarify
  • 建议配合:角色手册 + 实战演练
02

开发工程师怎么读

重点掌握 Plan、Tasks、Implement 的关系,理解规格如何一路落地为计划、任务与代码。

  • 重点章节:项目初始化 / 核心工作流
  • 重点阶段:Plan / Tasks / Implement
  • 建议配合:Analyze / 实战演练
03

测试工程师怎么读

重点掌握 V-Model 扩展与追溯矩阵,参与规格审阅并建立需求与测试的映射关系。

  • 重点章节:V-Model 扩展
  • 重点阶段:Specify 审阅 / Trace
  • 建议配合:角色手册 + 命令速查

章节目录

核心章节总览

整套教程已整理为 2 个合并页 + 5 个独立页,点击即可进入对应阅读页面。

第 2 章 准备

二、环境准备与安装

安装 Python、uv、Claude Code 与 spec-kit CLI,并验证依赖是否齐全。

安装环境CLI
进入本章
第 3 章 基础

三、项目初始化

理解 `.specify/`、`.claude/` 与 `specs/` 的职责和初始化方式。

初始化目录结构配置
进入本章
第 5 章 进阶

五、扩展与预设系统

学习 extension / preset 的作用、优先级与团队化定制方式。

扩展预设模板
进入本章
第 6 章 测试

六、V-Model 测试扩展详解

理解设计与测试的一一配对关系,以及需求追溯矩阵的价值。

V-Model测试追溯
进入本章
第 7 章 角色

七、各角色操作手册

面向产品、开发、测试三种角色,给出各自的实际操作路径。

角色操作指南场景
进入本章
第 9 - 11 章 参考篇

命令速查、对比选型与常见问题

合并收录命令速查表、与 OpenSpec 的对比,以及常见问题 FAQ,适合作为教程附录页。

命令对比FAQ
进入参考篇

术语卡片

先掌握这几个核心词

这些术语是整套教程的关键节点,理解它们有助于快速建立整体框架。

Constitution

项目宪法,定义不可违背的技术规范、测试原则与工程约束。

Specify

把自然语言需求转换为结构化规格文档,让需求变得可审阅、可追踪、可实现。

Plan

根据规格生成技术方案,包括数据模型、接口契约与实现思路。

Tasks

把计划拆成可执行任务清单,明确依赖、并行关系和实施顺序。

Implement

按照任务逐步落地代码,并与计划、规格和宪法持续保持一致。

Analyze

只读检查规格、计划、任务与实现之间的一致性,发现冲突和覆盖缺口。