下面按「在 Claude Code 里用 spec-kit 跑完一个项目」来总结:你需要哪些命令、每一步在干什么、以及最小闭环工作流。
0)一次性安装 Specify CLI(spec-kit 的命令行入口)
推荐用 uv 做“全局工具安装”(装一次,所有项目都能用):([GitHub][1])
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
(不想安装也可以用 uvx 临时跑一次 init,但日常不建议。)([GitHub][1])
1)在项目里初始化 spec-kit(生成 /speckit.* 相关配置)
新项目(创建目录)
specify init <PROJECT_NAME>
([GitHub][1])
已有项目(在当前目录初始化,常用)
specify init . --ai claude
# 或
specify init --here --ai claude
([GitHub][1])
--ai claude的意义:把适配 Claude Code 的 slash commands 等配置写到项目里,这样你在 Claude Code 里会看到/speckit.constitution等命令。([GitHub][1])
检查环境/工具是否就绪
specify check
会检查 git、claude 等工具是否安装可用。([GitHub][1])
2)进入 Claude Code:用 /speckit.* 完成“从规格到实现”的闭环
初始化完成后,在该项目目录启动 Claude Code(你的方式可能是 claude/Claude Code GUI 打开项目等)。README 明确说:在 AI assistant 里会提供 /speckit.* 命令。([GitHub][1])
你应该能在命令列表里看到这些核心命令:
/speckit.constitution、/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement ([GitHub][1])
3)完成一个项目(或一个 feature)的“最小命令清单”(按顺序)
STEP 1:立项目“宪法/原则”
/speckit.constitution <写清楚代码质量、测试标准、体验一致性、性能要求等原则>
([GitHub][1])
STEP 2:写“做什么”(规格说明)
/speckit.specify <描述你要做的功能:what/why,不要先讲技术栈>
([GitHub][1])
STEP 3:写“怎么做”(技术方案/实现计划)
/speckit.plan <补充你的技术栈、架构选择、关键约束>
([GitHub][1])
STEP 4:拆任务(生成 tasks.md)
/speckit.tasks
([GitHub][1])
STEP 5:按任务执行实现
/speckit.implement
它会基于 tasks.md 按顺序执行任务,并校验前置产物(constitution/spec/plan/tasks)。([GitHub][1])
4)你真正会频繁用到的“命令总表”
终端(一次/偶尔用):
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git(安装) ([GitHub][1])specify init . --ai claude(在项目中启用 spec-kit)([GitHub][1])specify check(检查工具链)([GitHub][1])
Claude Code(每个 feature/每轮迭代都会用):
/speckit.constitution/speckit.specify/speckit.plan/speckit.tasks/speckit.implement([GitHub][1])
1 个帖子 - 1 位参与者