Spec Kit “从零到专家”

下面是一份**按 Spec Kit 官方仓库文档/模板（github/spec-kit）**整理的「从零到专家」分阶段使用指南：你可以把它当成一条学习路线（每一阶段都有“目标—动作—产物—常见坑”），一路用到熟练掌握 Spec-Driven Development（SDD）的工作流。

你要掌握的整体心智模型

Spec Kit 的核心是把开发流程固定成一条“可重复执行”的链路：先写清楚“意图/规格”，再生成计划与任务，再执行实现。官方 Quickstart 把它总结为一套多步骤流程，并强调通过 Git 分支/特性目录实现“上下文感知”（你切分支就切换当前特性规格）。(GitHub)

你最终会频繁使用这些 slash commands（在specify init后出现在你的 AI agent 里）：核心命令/speckit.constitution /speckit.specify /speckit.plan /speckit.tasks /speckit.implement，以及可选的/speckit.clarify /speckit.checklist /speckit.analyze。(GitHub)

Phase 0（入门前）环境与项目初始化：把“工具链”装到可用

0.1 前置依赖（官方列出的最小集合）

• OS：Linux/macOS 或 Windows（脚本现在同时支持 PowerShell，不再依赖 WSL）
• AI coding agent：如 Claude Code / Copilot / Codebuddy / Gemini CLI
• uv（包管理）+ Python 3.11+ + Git (GitHub)

0.2 安装/升级 uv（按官方 uv 文档）

• macOS/Linux（官方安装脚本示例）：(docs.astral.sh)

curl-LsSfhttps://astral.sh/uv/install.sh|shuv--version

• 更新（你若是脚本安装，一般用uv self update；若用 brew/pip 安装则用对应包管理器升级——uv 文档明确建议“按原安装方式升级”）。(docs.astral.sh)

0.3 安装 Specify CLI（Spec Kit 的 CLI）

官方提供两条路：**持久安装（推荐）**或一次性运行。(GitHub)

A) 持久安装（推荐）

uv toolinstallspecify-cli--fromgit+https://github.com/github/spec-kit.git specify check

(GitHub)

B) 一次性运行（不想全局装）

uvx--fromgit+https://github.com/github/spec-kit.git specify init<PROJECT_NAME>

(GitHub)

0.4 初始化项目（新项目/已有项目都支持）

• 新建目录初始化：