🌱 Spec Kit CN

更快地构建高质量软件.

一个开源工具包, 让你专注于产品场景和可预期的结果, 而不是从零开始随意编写每一个部分.

💡 这是 GitHub Spec Kit 的非官方中文复刻版本

🔄 对应原版版本: v0.5.0

📦 包名: specify-cn-cli

🛠️ 命令: specify-cn

⚠️ 保持同步: 本项目将定期与原版保持同步, 确保中文用户能够享受最新的功能和改进.

---

目录

• 🌱 Spec Kit CN
  • 更快地构建高质量软件.
• 目录
  • 🎯 差异说明
  • Tips
• 🤔 什么是规范驱动开发?
• ⚡ 快速开始
  • 1. 安装 Specify CLI
  • 方式 1: 持久化安装(推荐)
  • 方式 2: 一次性使用
  • 2. 建立项目原则
  • 3. 创建规范
  • 4. 创建技术实施计划
  • 5. 分解任务
  • 6. 执行实施
• 📽️ 视频概述
• 🧩 社区扩展
• 🎨 社区预设
• 🚶 社区演练
• 🛠️ 社区项目
• 🤖 支持的 AI 代理
• 🔧 Specify CLI 参考
  • 命令
  • specify-cn init 参数和选项
  • 示例
  • 可用的斜杠命令
  • 核心命令
  • 可选命令
  • 环境变量
• 🧩 打造专属 Spec Kit: 扩展与预设
  • 扩展 — 添加新功能
  • 预设 — 定制现有工作流
  • 何时使用哪个
• 📚 核心理念
• 🌟 开发阶段
• 🎯 实验目标
  • 技术独立性
  • 企业约束
  • 以用户为中心的开发
  • 创意和迭代过程
• 🔧 前置要求
• 📖 了解更多
• 📋 详细流程
  • 步骤 1: 建立项目原则
  • 步骤 2: 创建项目规范
  • 步骤 3: 功能规范澄清(计划前必需)
  • 步骤 4: 生成计划
  • 步骤 5: 让 Claude Code 验证计划
  • 步骤 6: 使用 /speckit.tasks 生成任务分解
  • 步骤 7: 实施
• 🔍 故障排除
  • Linux上的Git凭据管理器
• 💬 支持
• 🙏 致谢
• 📄 许可证

🎯 差异说明

项目	Spec Kit 原版	Spec Kit CN 中文版
命令	specify	specify-cn
包名	specify-cli	specify-cn-cli
文档	英文	中文

Tips

• specify-cn init --offline 国内用户推荐使用
• 直接使用包内置资源初始化, 不依赖 GitHub 下载.
• 在网络受限, 代理不稳定, 企业内网或离线环境下更稳妥.

• 还能避免模板下载超时, 证书校验失败, 防火墙拦截等常见问题.

• specify-cn init --ai-skills, 可以将 command 安装为 skill，习惯 skill 的用户推荐使用

• 将内置命令直接安装为 agent skills, 适合已迁移到 skills 工作流的 agent.
• 对 Codex, Kimi, Antigravity 等 agent 尤其重要, 可以避免旧 command 布局兼容性问题.
• 初始化后可以直接使用对应 skills, 减少后续手动调整目录结构的成本.

推荐组合:

# 网络环境不稳定时, 优先使用离线初始化
specify-cn init my-project --ai claude --offline

# 对已迁移到 skills 的 agent, 建议直接启用 --ai-skills
specify-cn init my-project --ai codex --offline --ai-skills
specify-cn init my-project --ai kimi --offline --ai-skills
specify-cn init my-project --ai agy --offline --ai-skills

---

🤔 什么是规范驱动开发?

规范驱动开发彻底颠覆了传统软件开发的方式. 几十年来, 代码一直占据主导地位——规范只是我们在编码"真正工作"开始时构建和丢弃的脚手架. 规范驱动开发改变了这一点: 规范变得可执行, 直接生成可工作的实现, 而不仅仅是指导它们.

⚡ 快速开始

1. 安装 Specify CLI

选择你偏好的安装方式:

方式 1: 持久化安装(推荐)

一次安装, 随处使用. 固定到特定的发布标签以获得稳定性 (查看 Releases 获取最新版本):

# 安装特定的稳定版本(推荐 — 将 vX.Y.Z 替换为最新标签)
uv tool install specify-cn-cli --from git+https://github.com/linfee/spec-kit-cn.git@vX.Y.Z

# 或安装最新的 main 分支(可能包含未发布的变更)
uv tool install specify-cn-cli --from git+https://github.com/linfee/spec-kit-cn.git

然后直接使用工具:

# 创建新项目
specify-cn init <PROJECT_NAME>

# 或在现有项目中初始化
specify-cn init . --ai claude
# 或
specify-cn init --here --ai claude

# 检查已安装的工具
specify-cn check

要升级 Specify CLI, 请参阅 升级指南 获取详细说明. 快速升级:

uv tool install specify-cn-cli --force --from git+https://github.com/linfee/spec-kit-cn.git@vX.Y.Z

方式 2: 一次性使用

直接运行, 无需安装:

# 创建新项目(固定到稳定版本 — 将 vX.Y.Z 替换为最新标签)
uvx --from git+https://github.com/linfee/spec-kit-cn.git@vX.Y.Z specify-cn init <PROJECT_NAME>

# 或在现有项目中初始化
uvx --from git+https://github.com/linfee/spec-kit-cn.git@vX.Y.Z specify-cn init . --ai claude
# 或
uvx --from git+https://github.com/linfee/spec-kit-cn.git@vX.Y.Z specify-cn init --here --ai claude

持久化安装的优势:

• 工具保持安装状态并在 PATH 中可用
• 无需创建 shell 别名
• 更好的工具管理: uv tool list, uv tool upgrade, uv tool uninstall
• 更简洁的 shell 配置

方式 3: 企业级/离线环境安装

如果你的环境阻止访问 PyPI 或 GitHub, 请参阅企业级/离线环境安装指南, 了解如何使用 pip download 在联网机器上创建可移植的, 特定于操作系统的 wheel 包的分步说明.

2. 建立项目原则

在项目目录中启动你的 AI 助手. 大多数代理以 /speckit.* 斜杠命令的形式暴露 spec-kit; Codex CLI 在技能模式下使用 $speckit-* 代替.

使用 **/speckit.constitution** 命令创建项目的指导原则和开发指南, 这将指导所有后续开发.

/speckit.constitution 创建专注于代码质量, 测试标准, 用户体验一致性和性能要求的原则

3. 创建规范

使用 **/speckit.specify** 命令描述你想要构建的内容. 专注于做什么和为什么, 而不是技术栈.

/speckit.specify 构建一个可以帮助我将照片整理到不同相册中的应用程序. 相册按日期分组, 可以通过在主页上拖拽来重新组织. 相册不会嵌套在其他相册中. 在每个相册内, 照片以瓷砖界面预览.

4. 创建技术实施计划

使用 **/speckit.plan** 命令提供你的技术栈和架构选择.

/speckit.plan 应用程序使用 Vite 和最少数量的库. 尽可能使用纯 HTML, CSS 和 JavaScript. 图片不会上传到任何地方, 元数据存储在本地 SQLite 数据库中.

5. 分解任务

使用 **/speckit.tasks** 从你的实施计划创建可操作的任务列表.

/speckit.tasks

6. 执行实施

使用 **/speckit.implement** 执行所有任务并根据计划构建你的功能.

/speckit.implement

详细的分步说明, 请参阅我们的综合指南.

📽️ 视频概述

想要观看 Spec Kit 的实际操作? 观看我们的视频概述!

🧩 社区扩展

[!NOTE] 社区扩展由各自作者独立创建和维护. GitHub 和 Spec Kit 维护者可能会审查向社区目录添加条目的拉取请求的格式, 目录结构或策略合规性, 但他们不审查, 审计, 认可或支持扩展代码本身. 社区扩展网站也是第三方资源. 请在安装前审查扩展源代码, 并自行判断使用.

🔍 在 社区扩展网站 上浏览和搜索社区扩展.

以下社区贡献的扩展可在 catalog.community.json 中找到:

类别:

• docs — 读取, 验证或生成规范制品
• code — 审查, 验证或修改源代码
• process — 跨阶段编排工作流
• integration — 与外部平台同步
• visibility — 报告项目健康或进度

效果:

• Read-only — 生成报告但不修改文件
• Read+Write — 修改文件, 创建制品或更新规范

扩展	用途	类别	效果	URL
AI-Driven Engineering (AIDE)	结构化的 7 步工作流, 使用 AI 助手从零构建新项目 — 从愿景到实施	process	Read+Write	aide
Archive Extension	将已合并的功能归档到主项目记忆中	docs	Read+Write	spec-kit-archive
Azure DevOps Integration	使用 OAuth 认证将用户故事和任务同步到 Azure DevOps 工作项	integration	Read+Write	spec-kit-azure-devops
Checkpoint Extension	在实施过程中提交变更, 避免最终只有一个非常大的提交	code	Read+Write	spec-kit-checkpoint
Cleanup Extension	实施后的质量关卡, 审查变更, 修复小问题(童子军规则), 为中等问题创建任务, 为大问题生成分析	code	Read+Write	spec-kit-cleanup
Conduct Extension	通过子代理委派编排 spec-kit 阶段, 减少上下文污染	process	Read+Write	spec-kit-conduct-ext
DocGuard — CDD Enforcement	规范驱动开发(CDD)强制执行. 通过自动化检查, AI 驱动的工作流和 spec-kit 钩子验证, 评分和追踪项目文档. 零 NPM 运行时依赖	docs	Read+Write	spec-kit-docguard
Extensify	创建和验证扩展及扩展目录	process	Read+Write	extensify
Fix Findings	自动化的分析-修复-再分析循环, 解决规范发现直到清除	code	Read+Write	spec-kit-fix-findings
Fleet Orchestrator	通过人工审批关卡编排完整的功能生命周期, 覆盖所有 SpecKit 阶段	process	Read+Write	spec-kit-fleet
Iterate	使用两阶段定义和应用工作流迭代规范文档 — 在实施中途细化规范, 然后直接继续构建	docs	Read+Write	spec-kit-iterate
Jira Integration	从 spec-kit 规范和任务分解创建 Jira Epic, Story 和 Issue, 支持可配置的层级和自定义字段	integration	Read+Write	spec-kit-jira
Learning Extension	从实施中生成教育指南, 并通过导师上下文增强澄清环节	docs	Read+Write	spec-kit-learn
MAQA — Multi-Agent & Quality Assurance	协调者 → 功能 → QA 代理工作流, 支持基于 worktree 的并行实施. 语言无关. 自动检测已安装的看板插件. 可选 CI 关卡	process	Read+Write	spec-kit-maqa-ext
MAQA Azure DevOps Integration	MAQA 的 Azure DevOps Boards 集成 — 随功能进展同步用户故事和子任务	integration	Read+Write	spec-kit-maqa-azure-devops
MAQA CI/CD Gate	自动检测 GitHub Actions, CircleCI, GitLab CI 和 Bitbucket Pipelines. 在流水线通过前阻止 QA 交接	process	Read+Write	spec-kit-maqa-ci
MAQA GitHub Projects Integration	MAQA 的 GitHub Projects v2 集成 — 随功能进展同步草拟 issue 和状态列	integration	Read+Write	spec-kit-maqa-github-projects
MAQA Jira Integration	MAQA 的 Jira 集成 — 随功能在看板中的进展同步 Story 和 Subtask	integration	Read+Write	spec-kit-maqa-jira
MAQA Linear Integration	MAQA 的 Linear 集成 — 随功能进展跨工作流状态同步 issue 和子 issue	integration	Read+Write	spec-kit-maqa-linear
MAQA Trello Integration	MAQA 的 Trello 看板集成 — 从规范填充看板, 移动卡片, 实时勾选清单	integration	Read+Write	spec-kit-maqa-trello
Onboard	为 spec-kit 项目新开发者提供上下文引导和渐进式成长. 解释规范, 映射依赖, 验证理解, 指导下一步	process	Read+Write	spec-kit-onboard
Plan Review Gate	要求 spec.md 和 plan.md 通过 MR/PR 合并后才能生成任务	process	Read-only	spec-kit-plan-review-gate
Presetify	创建和验证预设及预设目录	process	Read+Write	presetify
Product Forge	完整产品生命周期: 研究 → 产品规范 → SpecKit → 实施 → 验证 → 测试	process	Read+Write	speckit-product-forge
Project Health Check	诊断 Spec Kit 项目并报告结构, 代理, 功能, 脚本, 扩展和 Git 方面的健康问题	visibility	Read-only	spec-kit-doctor
Project Status	显示当前 SDD 工作流进度 — 活跃功能, 制品状态, 任务完成度, 工作流阶段和扩展摘要	visibility	Read-only	spec-kit-status
QA Testing Extension	使用浏览器驱动或基于 CLI 的验收标准系统化 QA 测试	code	Read-only	spec-kit-qa
Ralph Loop	使用 AI 代理 CLI 的自主实施循环	code	Read+Write	spec-kit-ralph
Reconcile Extension	通过精确更新功能制品来协调实施偏差	docs	Read+Write	spec-kit-reconcile
Repository Index	为现有仓库生成概览, 架构和模块级别的索引	docs	Read-only	spec-kit-repoindex
Retro Extension	冲刺回顾分析, 包含指标, 规范准确性评估和改进建议	process	Read+Write	spec-kit-retro
Retrospective Extension	实施后回顾, 包含规范遵循评分, 偏差分析和人工审批的规范更新	docs	Read+Write	spec-kit-retrospective
Review Extension	实施后全面代码审查, 使用专门的代理检查代码质量, 注释, 测试, 错误处理, 类型设计和简化	code	Read-only	spec-kit-review
SDD Utilities	恢复中断的工作流, 验证项目健康状态, 验证规范到任务的追溯性	process	Read+Write	speckit-utils
Staff Review Extension	资深工程师级别的代码审查, 根据规范验证实施, 检查安全性, 性能和测试覆盖率	code	Read-only	spec-kit-staff-review
Superpowers Bridge	在 spec-kit SDD 工作流中编排 obra/superpowers 技能, 覆盖完整生命周期(澄清, TDD, 审查, 验证, 评审, 调试, 分支完成)	process	Read+Write	superpowers-bridge
Ship Release Extension	自动化发布流水线: 预检, 分支同步, 变更日志生成, CI 验证和 PR 创建	process	Read+Write	spec-kit-ship
Spec Critique Extension	从产品策略和工程风险两个角度对规范和计划进行批判性审查	docs	Read-only	spec-kit-critique
Spec Sync	检测并解决规范与实施之间的偏差. AI 辅助解决, 需人工审批	docs	Read+Write	spec-kit-sync
V-Model Extension Pack	强制 V-Model 配对生成开发规范和测试规范, 提供完整的追溯性	docs	Read+Write	spec-kit-v-model
Verify Extension	实施后质量关卡, 根据规范制品验证已实施的代码	code	Read-only	spec-kit-verify
Verify Tasks Extension	检测虚假完成: tasks.md 中标记为 [X] 但没有实际实施的任务	code	Read-only	spec-kit-verify-tasks

要提交你自己的扩展, 请参阅 扩展发布指南.

🎨 社区预设

[!NOTE] 社区预设由各自作者独立创建和维护. GitHub 和 Spec Kit 维护者可能会审查向社区目录添加条目的拉取请求的格式, 目录结构或策略合规性, 但他们不审查, 审计, 认可或支持预设代码本身. 请在安装前审查预设源代码, 并自行判断使用.

以下社区贡献的预设自定义 Spec Kit 的行为方式 — 覆盖模板, 命令和术语而不更改任何工具. 预设可在 catalog.community.json 中找到:

预设	用途	提供	依赖	URL
AIDE In-Place Migration	将 AIDE 扩展工作流适配为就地技术迁移(X → Y 模式) — 添加迁移目标, 验证关卡, 知识文档和行为等价标准	2 个模板, 8 个命令	AIDE 扩展	spec-kit-presets
Pirate Speak (Full)	将所有 Spec Kit 输出转换为海盗语言 — 规范变成"航海宣言", 计划变成"作战计划", 任务变成"船员分配"	6 个模板, 9 个命令	—	spec-kit-presets

要构建和发布你自己的预设, 请参阅 预设发布指南.

🚶 社区演练

[!NOTE] 社区演练由各自作者独立创建和维护. 它们未经 GitHub 审查, 认可或支持. 请在跟随演练前审查其内容, 并自行判断使用.

通过这些社区贡献的演练, 在不同场景中观看规范驱动开发的实际操作:

• **[全新 .NET CLI 工具](https://github.com/mnriem/spec-kit-dotn