在 Claude Code 里安装并使用 Spec-Kit

Spec-Kit 是什么

Spec-Kit 是微软发布的"规格驱动开发（SDD）"工具包，适配 Claude Code、Copilot、Gemini CLI 等 AI Coding 代理。

核心作用是：把"规格→计划→任务→实现"的流程标准化，做成可执行的斜杠命令，让 AI Coding 有章可循，而不是凭感觉写代码。

核心用途集中在三方面：

项目初始化：快速生成带规范目录（.specify/、specs/、scripts/）和模板的项目骨架
流程标准化：提供 /speckit.constitution、/speckit.specify、/speckit.plan 等斜杠命令，覆盖从需求澄清到任务拆解的全流程
一致性保障：通过 /speckit.analyze 检查需求文档、技术方案、任务列表之间的矛盾或遗漏

Spec-Kit 能解决什么问题

让"写什么/为什么"（Spec）先于"怎么做"（Plan/Tasks/Impl），减少返工；给代理提供统一的"宪法"和护栏；产出一套可追溯的工件与目录结构。

一个更直白的理解

他是增加 tokens 消耗，减少人脑消耗的一种方式，而且这是大模型时代的正确思考方式。

spec-kit 会大幅增加开发时间，大幅增加 tokens 消耗，但这个过程中你可以看着就好，去干点其他事情。相当于你招了一个成熟下属，虽然你的命令表达不特别清晰，但是他会中规中矩按照自己理解给你全部做的好好的。虽然结果可能和你最开始的想法不完全一致，但你心里的台词是，"也还行，就这样吧"。

完整安装步骤（Windows + PowerShell）

一、安装 uv

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

重开一个新的 PowerShell 后运行：

uv --version

如果提示找不到命令，执行：

uv tool update-shell

（或者把 C:\Users\<你>\.local\bin 加到 PATH）

二、用 uv 安装 Specify CLI

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
specify --help
specify check

三、确认 Claude Code 可用

claude --version

四、初始化项目骨架

在打算放项目的目录里运行：

specify init my-feature --ai claude --script ps

如果你是新开发，直接在根目录下，用：

specify init --here --force --ai claude --script ps

⚠️ 注意：spec-kit 基于 git 管理项目，在运行以上命令之前，需要先 git push。

初始化后会生成 .specify/、templates/、specs/、scripts/ 等目录与模板，且模板会自动注入 /speckit.* 斜杠命令供代理使用。

五、跑完整的 Spec-Driven 工作流

cd my-feature
claude

在 Claude Code 里依次发送以下命令：

步骤	命令	说明
1	`/speckit.constitution`	建立项目原则，生成 `.specify/memory/constitution.md`
2	`/speckit.specify`	撰写功能规格，专注"做什么 & 为什么"，不要先纠结技术栈
3	`/speckit.clarify`	结构化澄清需求，通过 Q&A 消除模糊点（可选）
4	`/speckit.plan`	产出技术实现方案（这一步再指定技术栈、架构）
5	`/speckit.tasks`	从实现方案拆解成可执行的任务列表
6	`/speckit.analyze`	检查所有工件的一致性与覆盖率
7	`/speckit.implement`	一键执行实现（按依赖顺序执行任务）

💡 标记 [P] 的 task 是可以并行执行的，Claude Code 会自动分配多个 task agent 并行处理。

怎么自动完成整个流程

spec-kit 的初衷是让用户每步确认产出并修正，但如果你想像作者一样一句话让 Claude Code 自动跑完全流程，可以建一个 subagent：

---
name: spec-kit-feature-agent
description: Use this agent when the user explicitly mentions using 'spec-kit'...
model: inherit
---

You are a Spec-Kit Feature Implementation Agent...
Your core workflow follows this exact order:
1. /speckit.constitution
2. /speckit.specify
3. /speckit.clarify
4. /speckit.checklist
5. /speckit.plan
6. /speckit.tasks
7. /speckit.analyze
8. /speckit.checklist
9. /speckit.implement

作者实测：一句话命令后，agent 一次执行了 13M tokens，自动依次执行了 /speckit.constitution → /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement，并按依赖顺序并行执行了多个任务。

💡 在 subagent 中可以自动发出 /command，而在 Claude Code 的 /command 里要求自动执行其他 /command 是不生效的。

spec-kit 的适用场景

适合的场景：

从 0 到 1 搭建新需求
需要稳定、完整地搭建一个功能模块

不适用的场景：

Bug Fix：Claude Code 没有项目索引，项目大了之后 Grep 查回来的片段既不精准也耗 tokens/time，不如 Cursor 的 RAG 精准定位问题

常见问题

安装时报错 typer 找不到？

pip install typer

如果仍然报错，可能是 specify-cli 版本问题，可尝试指定版本安装或查看官方最新解决方案。

spec-kit 太复杂怎么办？

可以看轻量版 OpenSpec，更适合 MVP 阶段。0-1 用 spec-kit，1-n 用 OpenSpec 更合适。

总结

特点	说明
核心理念	规格驱动开发（Spec-Driven Development）
适用阶段	0-1 新功能搭建
tokens 消耗	大（但省人脑）
开发时间	长（但省人工干预）
最佳搭档	Claude Code（支持并行 task）
轻量替代	OpenSpec