Spec-Kit 最佳实践

sepc-kit 项目初始化

初始化 sepc-kit 项目时要指定当前项目所使用的 AI 助手；spec-kit 会生成适配指定 AI 助手的命令；项目初始化完成后，还可以再次初始化，以更改命令适配。

Claude (含自定义)	
## 生成专门适配 Anthropic 风格的斜杠命令
specify init . --ai claude	

## Codex使用通用模板，或根据需要选 copilot 模式
## 此处必须指定
specify init . --ai generic --ai-commands-dir .spec-kit/commands

## Antigravity: 适配 Google 的 AI 指令集和上下文处理逻辑
specify init . --ai gemini

注：当 AI 助手是 codex 或其它通用助手时，需要指定存放指令的路径；但以下 AI 助手不需要指定路径，spec-kit 会自动将指令放到如下对应路径：

--ai claude 👉 自动关联 .claude/

--ai copilot 👉 自动关联 .github/

--ai gemini 👉 自动关联 .google/

spec-kit 项目开发最佳实践流程

1. 奠基：同步宪法 (/speckit.constitution)

建立项目的核心原则和开发指南，例如：技术栈（如 React+TS）、代码风格（如类名必须用小驼峰）、设计原则（如必须支持多语言）等；

## 具体操作
/speckit.constitution <输入项目宪法文字>

2. 打磨核心：需求漏斗 (Specify → Clarify)

定义需求：执行 /speckit.specify ，把原始需求丢给AI

需求澄清：执行 /speckit.clarify ，澄清需求是给 AI 答疑解惑，确保 AI 完全理解需求，因此执行此命令时不需要输入任何文字

## 具体操作

## 定义需求
/speckit.specify <输入需求>

## 澄清需求，让 AI 主动寻找需求中的漏洞
/speckit.clarify 

## 更新需求
基于刚才的讨论，重新执行 /speckit.specify 更新需求文档
## 或
/speckit.specify 请更新关于“支付失败重试逻辑”的部分

即，通过澄清和聊天指令来反复打磨需求，直到没有问题时，再次运行 /speckit.specify 来更新需求文档，直到 spec.md 逻辑自洽；

3. 架构推演：方案与验收 (Plan → Checklist)

制定计划：/speckit.plan ，AI 生成计划和架构设计

检查计划清单：/speckit.checklist，质量防线，基于计划生成验收清单，明确告诉 AI 什么代码才算“通过验收”，增加开发的确定性

## 具体操作

## 制定计划
/speckit.plan

## 检查计划清单
/speckit.checklist

如果 /spectkit.checklist 检查结果有问题，则让 AI 进行调整；

4. 落地前的最后校验 (Tasks → Analyze)

拆解任务：/speckit.tasks 将大任务拆解，确保每个任务足够小（如：创建一个组件，而不是写完整个登录模块）

分析确认：必须执行 /speckit.analyze 检查 Tasks 是否违背了最初的 Constitution（宪法），例如：任务里是否漏掉了单测？是否用了禁用的库？

## 具体操作

## 制定计划
/speckit.tasks

## 检查计划清单
/speckit.analyze

如果 /spectkit.analyze 分析结果有问题，则让 AI 进行调整；

5. 自动化交付 (Implement)

实施：/speckit.implement

监控：观察 AI 提交的代码。如果发现它在某个任务卡住了，说明之前的 plan 或 tasks 粒度还是太粗，此时应停止实现，回退到 tasks 阶段重新拆解。

不要一次性让 AI 完成所有任务。建议让 AI 逐项执行任务单，每完成 1-2 个任务就停下来，让你手动检查效果；

## 具体操作

## 实施
/speckit.implement

与 Claude code 配合

在 Claude code 中执行 /init 命令时，Claude Code 会扫描整个项目，并自动生成 CLAUDE.md 文件。CLAUDE.md 是 Claude Code 的“项目级系统提示词”，是记忆锚点；Claude Code 每次启动或清理上下文时，都会强制读取这个文件。没有 CLAUDE.md，Claude Code 依然能通过 Spec Kit 的流程写代码，但它会缺乏“肌肉记忆”，它不会主动遵循宪法（除非每次对话都提醒它看 specs/ 目录）。最佳实践是，在 spec-kit 项目中运行一次 /init 命令，让 Claude code 中自动生成一个 CLAUDE.md 文件，然后在生成的 CLAUDE.md 文件里加一句：“Follow the rules in specs/constitution.md”；即，让 Claude code 遵循 specs/constitution.md （spec-kit 宪法）中的规则，这样就完美结合了 Claude Code。