Spec-Kit 使用

安装

## 安装 CLI 命令行工具
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

## 升级 CLI 命令行工具
uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

初始化项目

## 初始化创建新项目
specify init <PROJECT_NAME>

## 在已有项目目录中初始化
##     . 或 --here：指明在当前路径操作，不创建新文件夹
##     --ai claude：指定使用的 AI 助手，此处使用的 claude code
specify init . --ai claude
或
specify init --here --ai claude

## 检查运行该工具所需的软件依赖（如 Python、Git 等）是否已正确安装，确保后续 AI 代理能够正常调用相关脚本
specify check

初始化 spec-kit 项目时会提示要使用 AI 工具和命令行工具；此处选择 claude code 作为 AI 助手工具，Window下选择 PowerShell 作为命令行工具，如下：

- 选择 AI 工具：

- 选择命令行工具：

基本使用

Spec Kit 将开发过程分为核心工作流和质量增强两个部分；核心工作流中是必须要执行的步骤，以便生产项目的范围说明；质量增强是可选的。

a> 在 AI 工具中执行 spec-kit 命令

在 spec-kit 项目目录中打开 AI 工具，然后就能看到 spec-kit 相关的命令，如下图：

b> 依次执行如下命令，以完成核心工作流

/speckit.constitution（制定宪法）
## 作用：建立项目的核心原则和开发指南（如：必须使用 TypeScript、优先考虑性能、UI 必须简洁）。
## 目的：确保 AI 在后续生成代码时，始终遵守这些“不容挑战”的底线。

/speckit.specify（定义需求）
## 作用：详细描述你想实现的功能。
## 关注点：只谈 “做什么 (What)” 和 “为什么 (Why)”，不谈具体的代码实现方案和技术栈。

/speckit.plan（制定技术计划）
## 作用：基于需求，确定 “怎么做 (How)”，使用什么技术栈和架构等；
## 内容：AI 会生成技术架构、数据库模型、API 定义等。

/speckit.tasks（拆解任务）
## 作用：AI 根据计划将庞大的计划拆解为一个个具体的、可执行的、细粒度的 待办清单（Todo List）。

/speckit.implement（执行实现）
## 作用：AI 会根据前面生成的任务清单，逐一编写并提交真实的代码。

c> 以下增强命令可选的，用于在关键节点“查漏补缺”，提升项目的严谨性：

/speckit.clarify（澄清疑问）
## 时机：在 specify（需求）之后、plan（计划）之前使用。
## 作用：AI 会化身“挑刺的产品经理”，针对你描述不清晰的地方提问，帮你规避需求模糊带来的风险。

/speckit.analyze（一致性分析）
##时机：在 tasks（任务）之后、implement（实现）之前使用。
## 作用：检查“代码任务”是否背离了最初的“项目宪法”或“需求规范”，防止开发跑偏。

/speckit.checklist（生成检查清单）
## 时机：在 plan（计划）之后使用。
## 作用：自动生成质量验收清单，用于验证需求是否完整、逻辑是否自洽。