概念入门、环境准备与项目初始化

1.1 spec-kit 的定位

spec-kit 是 GitHub 官方开源的规范驱动开发（Spec-Driven Development, SDD）工具包。 它的作用不是只帮你“写文档”，而是把原本容易散落在会议、聊天和脑海中的需求，整理成 AI 和团队都能持续读取的结构化规格。

1.2 五个核心阶段

这五个阶段把模糊需求逐步转化为可执行代码。它不是让 AI 一次性“自由发挥”，而是把需求、方案、任务、实现拆成连续的可审阅过程。

1.3 三个可选辅助阶段

它们不是主线中的固定步骤，但在真实项目里很实用：一个负责补齐模糊信息，一个负责做只读检查，一个负责最终逐条核对。

1.4 为什么它适合团队协作

• 每个阶段都会产出结构化 Markdown 文件，不会随着对话消失。
• AI 在后续阶段可以反复读取前面阶段的输出，而不是只依赖上下文记忆。
• 产品、开发、测试可以围绕同一份规格协作，减少口头约定丢失的问题。

2.1 前置依赖

注意：uv 是 Rust 编写的超快 Python 包管理器，也是安装 `specify` 的推荐方式。

2.2 安装方式

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@v0.4.3

uvx --from git+https://github.com/github/spec-kit.git@v0.4.3 specify init my-project

2.3 离线 / 企业内网安装思路

# 1. 在联网机器上操作
git clone https://github.com/github/spec-kit.git
cd spec-kit
python -m build
pip download -d dist/ dist/specify_cli-*.whl

# 2. 将 dist/ 文件夹拷贝到目标机器
# 3. 在目标机器上安装
pip install --no-index --find-links=./dist specify-cli

2.4 验证安装

specify version
specify check

3.1 初始化命令

specify init my-project --ai claude

参数 --ai claude 表示生成 Claude Code 专用的命令文件。 如果团队同时使用多种 AI 工具，也可以多次初始化不同 agent，彼此不会冲突。

specify init my-project --ai claude
specify init my-project --ai copilot
specify init my-project --ai cursor-agent

3.2 初始化后的目录结构

my-project/
├── .specify/
│   ├── memory/
│   │   └── constitution.md
│   ├── templates/
│   ├── presets/
│   ├── extensions/
│   └── preset-catalogs.yml
├── .claude/
│   └── commands/
│       ├── speckit.constitution.md
│       ├── speckit.specify.md
│       ├── speckit.plan.md
│       ├── speckit.tasks.md
│       ├── speckit.implement.md
│       ├── speckit.clarify.md
│       ├── speckit.analyze.md
│       ├── speckit.checklist.md
│       └── speckit.taskstoissues.md
└── specs/   # 首次运行 /speckit.specify 时才创建

3.3 需要特别记住的几个点