本指南将帮助您掌握使用Cursor结合Spec-Kit进行项目开发的完整流程，从初始化到最终实现的全过程。
Spec Kit官方仓库：https://github.com/github/spec-kit - 💫 Toolkit to help you get started with Spec-Driven Development
在使用本指南之前，请确保您已经安装了Spec-Kit：
# 安装uv。需要魔法访问到GitHub powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # 验证uv uv --version # 安装Spec-Kit uv tool install specify-cli --from git+https://github.com/github/spec-kit.git # 验证安装 specify --help 注意：确保您的Node.js版本 >= 16.0.0
参考：详细安装说明请查看 官方文档
- ✅ Node.js >= 16.0.0
- ✅ npm 或 yarn 包管理器
- ✅ Git 版本控制
- ✅ Cursor IDE
graph LR A[📋初始化] --> B[📜章程] B --> C[📝需求] C --> D[❓澄清] D --> E[📋计划] E --> F[📋任务] F --> G[🔍分析] G --> H[🚀开发] H --> I{满意?} I -->|否| J[🔧修改] J --> H I -->|是| K[📝更新] K --> L[📚总结] style A fill:#e1f5fe,stroke:#2196f3,stroke-width:1px style B fill:#f3e5f5,stroke:#9c27b0,stroke-width:1px style C fill:#e8f5e8,stroke:#4caf50,stroke-width:1px style D fill:#fff3e0,stroke:#ff9800,stroke-width:1px style E fill:#fce4ec,stroke:#e91e63,stroke-width:1px style F fill:#f1f8e9,stroke:#8bc34a,stroke-width:1px style G fill:#fff8e1,stroke:#ffc107,stroke-width:1px style H fill:#e3f2fd,stroke:#03a9f4,stroke-width:1px style I fill:#ffebee,stroke:#f44336,stroke-width:1px style J fill:#f3e5f5,stroke:#9c27b0,stroke-width:1px style K fill:#e8f5e8,stroke:#4caf50,stroke-width:1px style L fill:#f9fbe7,stroke:#8bc34a,stroke-width:1px # 已有项目初始化 # 打开项目 specify init --here # 新项目初始化 specify init [项目名]重要：项目章程定义了开发过程中必须严格遵守的规则和边界，是整个项目的基础约束。
# 你需要检查生成的章程文件 /speckit.constitution 当前项目必须要严格遵守的内容、边界（如：密码等敏感信息需要加密存储，变量命名是驼峰还是下划线、SQL语句严格遵守MySQL语法还是PostgreSQL等，可以不断完善补充。） # 也可以像这样填写，这是官方视频的示例 /speckit.constitution Fill the constitution with the bare minimum requirements for a static web app based on the template. # 翻译后 /speckit.constitution 基于最低限度的静态网页应用程序的模板，来填写章程文件- 🔐 安全规范：密码等敏感信息加密存储
- 📝 编码规范：变量命名规则（驼峰/下划线）
- 🗄️ 数据库规范：SQL语法标准（MySQL/PostgreSQL）
- 🏗️ 架构约束：技术栈选择限制
目标：明确项目需求，生成规范的需求文档，为后续开发提供清晰指导。
# 会自动新建一个分支，并在分支上生成一些md文件，记录需求内容。需要关注的是生成的spec.md文件的内容 /speckit.specify 新的需求内容是什么？为什么？（不涉及如何实现，使用什么技术栈） # 当生成的需求文档中，存在需要修改的内容时： #（选中spec.md文件） @spec.md 描述你需要修改的内容关注用户体验和业务价值
- ✅ "用户可以在3分钟内完成结账"
- ✅ "系统支持10000个并发用户"
- ✅ "95%的搜索在1秒内返回结果"
- ✅ "任务完成率提高40%"
避免过于技术化的描述
- ❌ "API响应时间小于200ms"（过于技术性，请使用"用户立即看到结果"）
- ❌ "数据库可以处理1000 TPS"（实施细节，使用面向用户的指标）
- ❌ "React组件高效渲染"（特定于框架）
- ❌ "Redis缓存命中率超过80%"（技术特定）
目的：通过AI提问来消除需求中的歧义，确保项目目标清晰明确。
# AI会返回一些它觉得不确定或必要的问题，你需要回答，来明确需求中的歧义或缺失的决策点，并记录问题和结果到需求文档spec.md文件中。 /speckit.clarify 可选，可以输入一些你重点关注的内容，比如性能瓶颈风险 # 示例 /speckit.clarify 你现在是项目产品/架构顾问，请给出一组澄清问题（不超过 12 个），用于与产品负责人对接，且每个问题后面说明为什么需要这个问题（1–2 行）。问题要基于现有表结构与业务目标。示例要命中要害（检测频率、阈值、删除策略、保留敏感信息等）。- 🚀 性能要求：响应时间、并发量等
- 🔒 安全考虑：数据保护、权限控制
- 📱 用户体验：界面友好性、操作流程
- 🏗️ 技术约束：兼容性、扩展性
目标：制定详细的技术实现方案，为开发团队提供清晰的实施路径。
# 将会生成一个plan.md文件，记录了完整的实现方案。你需要检查方案内容是否符合预期，是否有需要修改内容 /speckit.plan 如何实现？或对实现有什么要求？如：要使用什么技术栈、要复用代码中某部分已实现的功能、是否要生成测试代码之类的，如果有表结构之类的SQL语句，也可以输入在这里 # 当生成的方案文档中，存在需要修改的内容时 #（选中plan.md文件） @plan.md 描述你需要修改的内容- 🛠️ 技术栈选择：框架、库、工具链
- 🏗️ 架构设计：系统结构、模块划分
- 🗄️ 数据库设计：表结构、索引策略
- 🧪 测试策略：单元测试、集成测试
目标：将复杂的实现计划分解为可管理的小任务，便于团队协作和进度跟踪。
# 将会生成一个tasks.md文件，记录了拆分后的任务步骤。你需要检查每项任务步骤是否正确，是否有多余步骤，是否缺少步骤，步骤内容是否需要修改 /speckit.tasks 基于 @plan.md，请把实现分解为 20–30 条可执行任务（tasks），每个任务包含： - 标题 - 描述（1–2 行） - 估时（小时） - 前置条件 - 验收标准（单元/集成测试或 DB 变化） - 建议实现路径（文件名） 请优先标注 P0/P1/P2。任务示例： P0-1 实现登录功能 估时 2h 前置无 验收：用户名密码正确可以登录，密码错误不可访问系统，并提示对应错误信息 # 当需要修改任务步骤时 #（选中tasks.md文件） @tasks.md 描述你需要修改的内容- 任务步骤是否完整
- 是否有重复或多余步骤
- 任务依赖关系是否清晰
- 任务描述是否具体可执行
- 预估工作量是否合理
目的：全面检查项目文档的一致性，识别潜在风险和冲突点。
# 命令会读取spec.md, plan.md, tasks.md， constitution.md文档，检查文档中前后矛盾或冲突的部分、潜在风险内容 /speckit.analyze # 如果有冲突，直接在对话中描述需要修改的内容 描述你需要修改的内容⚠️ 文档一致性：需求与计划是否匹配- 🔄 逻辑冲突：任务间是否存在矛盾
- 🎯 目标对齐：实现方案是否符合需求
- ⏰ 时间规划：任务安排是否合理
核心阶段：基于前期规划，开始实际的代码开发和功能实现。
# 开发实现 /speckit.implement # 当最终实现经常没有满足要求时 直接在对话中描述需要修改的内容，直到功能实现，并符合期望当最终实现符合预期后，更新需求文档：
# 总结对话历史，更新需求文档 Based on the conversation, encode the learnings and the experience pieces (NOT THE TECHNICAL DETAILS) into @spec.md for the current feature.持续改进：将开发过程中的经验教训转化为可复用的功能需求。
# 总结经验 Let's transform the learnings into relevant functional requirements in the spec.🎉 恭喜！您已经掌握了Cursor结合Spec-Kit的完整开发流程
持续实践，让AI成为您最得力的开发伙伴！