Spec-Kit 最佳实践

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