spec-kit (规范驱动开发工具包)
149,348
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Python
语言
创建时间
最近更新
项目能做什么
帮助你快速上手 SDD 等开发流程的工具包。
来源:基于仓库元数据
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
项目简介
Spec Kit 是一个开源工具包,旨在为 AI 编码助手(AI coding agents)提供结构化的开发流程、可复用的模板以及清晰可追踪的交付成果。它开箱自带规范驱动开发(Spec-Driven Development,简称 SDD),帮助开发者在规划、实现和收敛全流程中由规范驱动 AI 完成编码,同时支持按需引入 Bug 修复、想法评估或完全自定义的开发流程。
核心功能
- 多流程支持:
- Spec-Driven Development(核心内置):从规范制定贯穿到方案规划、代码实现与收敛。
- Bug fixing(扩展):诊断问题原因、界定修复范围并记录验证结果。
- Idea assessment(扩展):通过事实依据评估是否立项(Go / Clarify / Stop)。
- 灵活的组合机制:
- Integration(集成):连接并支持切换不同的 AI coding agent(如 GitHub Copilot 等)。
- Extension(扩展):添加自定义命令、质量门禁(Quality gate)或外部服务集成;支持监听生命周期事件与命令执行钩子(Hooks)。
- Preset(预设)与本地覆盖:支持根据团队或合规标准定制模板、命令与方法论,支持针对单一项目覆盖模板(Project-local override)。
- Workflow(工作流):自动化提示词(Prompts)、命令、门禁与 Shell 任务,支持无侵入叠加修改(Overlays)与可复用步骤(Workflow step)。
- Bundle & Catalog:支持安装预打包套件,提供公共社区目录与私有组件目录检索能力(如
specify extension search等命令)。 - 离线与内网支持:支持本地源和自托管 Catalog,便于在防火墙内或离线环境使用。
适合谁用
- 使用 AI coding agent(如 GitHub Copilot 等)进行日常编码,希望让 AI 按照结构化步骤而非随意发挥的开发者。
- 希望规范团队 AI 辅助开发流程,落地 SDD、自动化质量门禁或合规标准的工程团队。
安装步骤
前置要求
- Python 3.11+
- uv
- 已安装并配置受支持的 AI coding agent
- 支持系统:Linux、macOS、Windows
安装与快速启动
在终端中执行以下命令安装 Specify CLI 并初始化项目(以 GitHub Copilot 为例):
# 安装 Specify CLI
uv tool install specify-cli
# 初始化项目并指定使用的 coding agent
specify init my-project --integration copilot
# 进入项目目录
cd my-project
安装并初始化完成后,在项目目录中启动你的 coding agent 即可开始使用。
配置说明
此部分原文未详细说明具体的配置文件细节与参数列表。README 中提及支持以下配置机制,具体配置方式请查看官方文档与原仓库:
- 通过 --integration <agent> 切换绑定的 coding agent;
- 通过项目根目录的项目级覆盖(Project-local override)覆盖默认模板;
- 通过私有 Catalog 和认证机制配置企业内部源。
常见问题
此部分原文未说明,请查看原仓库及官方文档。
原始 README 摘录(英文原文,节选前 3000 字符)
<div align="center">
<img src="https://raw.githubusercontent.com/github/spec-kit/main/media/logo_large.webp" alt="Spec Kit Logo" width="200" height="200"/>
<h1>🌱 Spec Kit</h1>
<h3><em>Build with a spec, fix a bug, or assess an idea — with your coding agent.</em></h3>
</div>
<p align="center">
<a href="https://github.com/github/spec-kit/releases/latest"><img src="https://img.shields.io/github/v/release/github/spec-kit" alt="Latest Release"/></a>
<a href="https://github.com/github/spec-kit/stargazers"><img src="https://img.shields.io/github/stars/github/spec-kit?style=social" alt="GitHub stars"/></a>
<a href="https://github.com/github/spec-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/github/spec-kit" alt="License"/></a>
<a href="https://github.github.io/spec-kit/"><img src="https://img.shields.io/badge/docs-GitHub_Pages-blue" alt="Documentation"/></a>
</p>
<p align="center">
<strong>English</strong> ·
<a href="./README.zh-CN.md">简体中文</a> ·
<a href="./README.ja.md">日本語</a> ·
<a href="./README.ko.md">한국어</a>
</p>
Spec Kit is an open source toolkit that gives AI coding agents structured
processes, reusable templates, and documented outcomes. Start with a ready-made
process, customize it, or bring your own.
## Choose your process
| What you need | Process | Outcome |
| --- | --- | --- |
| Build a feature or application | [Spec-Driven Development](#spec-driven-development) | A specification carried through planning, implementation, and convergence |
| Diagnose and repair broken behavior | [Bug fixing](#bug-fixing) | An assessed cause, scoped fix, and recorded verification |
| Decide whether an idea deserves investment | [Idea assessment](#idea-assessment) | An evidence-backed go, clarify, or stop decision |
| Adopt or create a different process | [Your own process](#capabilities) | A process adapted or assembled from reusable primitives |
These are independent entry points, not mandatory phases. SDD ships in core;
bug fixing and assessment are bundled extensions you install when needed, and
the primitives below let you adopt or create other processes.
## Capabilities
Spec Kit combines ready-to-use processes with composable mechanisms:
| Capability | Spec Kit mechanism |
| --- | --- |
| Connect to or switch between coding agents | [Integration](https://github.github.io/spec-kit/integrations/index.html) |
| Add a command, quality gate, or complete process | [Extension](https://github.github.io/spec-kit/extensions/overview.html) |
| Connect a process to an external tool or service | [Extension](https://github.github.io/spec-kit/extensions/overview.html) |
| React to coding-agent lifecycle events | [Extension runtime event](https://github.github.io/spec-kit/extensions/api.html#extension-runtime-events) |
| Run extension commands before or after Spec Kit commands | [Extension hook](https://github.github.io/spec-kit/extensions/api.html#hook-configuration) |
| Adapt templates, comma
阅读完整原文
商业机会分析 规则生成(AI 未配置)
综合评分 45.0 分。该项目在“个人可实施性”维度得 60 分,“付费可能性”维度得 20.0 分,差异化空间 40.0 分(评分依据见评分卡)。
面向细分需求的二次开发产品
| 产品构想 | 基于 spec-kit 的核心能力,聚焦一个更窄的场景(如某平台、某行业)做差异化。 |
| 目标用户 | 该细分场景用户 |
| 难度/周期 | 中 · 2~6 周 |
| 收费模式 | 买断制 / 订阅制 / 广告 |
| 竞争风险 | 细分需求规模需验证 |
| 依据 | AI 推测:基于项目主题标签的判断 |
封装为在线小工具或 API 服务
| 产品构想 | 把项目最常用的一个功能做成网页小工具,靠流量变现或按量计费。 |
| 目标用户 | 搜索引擎带来的长尾用户 |
| 难度/周期 | 低 · 1~3 周 |
| 收费模式 | 免费引流 + 增值功能 / API 按量计费 |
| 竞争风险 | 同质化竞争,需做好 SEO |
| 依据 | AI 推测:基于技术栈与部署特征的判断 |
以上为规则引擎基于仓库公开数据生成的参考结论,包含推测成分,不构成投资或创业承诺;配置 AI 后可获得更深入的分析。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| spec-kitty/spec-kitty | 中文介绍暂未生成 Spec-Driven Development with organizational governance. Spec |
1,720 | Python |
| GanyuanRan/Aegis | 中文介绍暂未生成 Make AI coding agents architecture-aware: baseline-first, ev |
1,429 | Python |
| wordflowlab/novel-writer | 中文介绍暂未生成 参考Spec-kit 实现小说撰写工具 |
957 | Shell |
| Linfee/spec-kit-cn | 中文介绍暂未生成 Clone of https://github.com/github/spec-kit but in Chinese |
714 | Python |
| ThibautBaissac/rails_ai_agents | 中文介绍暂未生成 Specialized AI skills, agents, rules and hooks for modern Ra |
673 | Shell |
| guiguiyan930-source/game-ui-design-workflow | 中文介绍暂未生成 一套面向游戏 UI 设计的 Cursor Agent Skills 工作流,覆盖原型视觉生成、风格切换、页面延展与组件拆 |
422 | Python |
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 100 个 Release |
| 社区活跃 | Star 149,348 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
快速开始(以仓库 README 为准)
git clone https://github.com/github/spec-kit.git cd spec-kit # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。