Spec Kit
用本地 CLI 把需求逐步变成计划、任务与实现
它是什么
Spec Kit 是一套配合 AI 编码 Agent 使用的规格驱动开发工具包。你先写明项目原则和功能需求,它再把需求逐步整理成技术计划与可执行任务,最后交给 Agent 编码,并检查实现是否符合前面的约定。
一次典型操作不是输入一段提示后直接等待代码生成,而是依次完成规格、计划、任务和实现。与常见的一次性提示相比,这种方式多了可检查、可修改的中间产物,需求变化或实现偏离时,可以回到对应阶段调整,而不必只靠补充提示反复纠正。
怎么运行
项目通过 Specify CLI 初始化。运行前需要安装 uv,并准备一个受支持的 AI 编码 Agent。CLI 可从 PyPI 安装:
bash
uv tool install specify-cli
specify init my-project --integration copilot
cd my-project初始化后,项目中会写入对应 Agent 使用的命令或技能。接着在 Agent 中依次执行规格、计划、任务和实现命令。若当前环境没有交互式终端,可在 specify init 后添加 --non-interactive。
核心机制
- 项目宪法:先记录代码质量、测试、体验和性能等长期原则,之后生成的规格、计划、任务与实现都要遵守这些约束。
- 分阶段产物:使用
/speckit.specify整理需求,接着通过/speckit.plan制订技术方案,再由/speckit.tasks拆成任务,最后运行/speckit.implement执行。 - 收敛检查:
/speckit.converge会对照规格、计划和任务检查代码,并把尚未完成的工作追加回任务列表,供后续继续处理。 - 分层定制:项目覆盖、Preset、Extension 和核心模板按优先级解析。Bundle 可以把扩展、预设和流程组合成带版本的团队配置。
适合谁
它适合希望 AI Agent 按明确需求开发新功能的团队,也适合改造已有工程、需要保留规格与实现对应关系的开发者。若组织希望统一需求格式、技术计划和任务拆解方式,可以使用 Preset 与 Bundle 固化约定。
使用边界
Spec Kit 不替代编码 Agent,实现质量仍取决于所选模型、Agent 集成和输入规格。它通过本机 CLI 运行,安装依赖 uv。社区扩展由各自作者维护,仓库建议安装前审查源码。项目采用 MIT 许可证。