Spec-Kit 中文版 🇨🇳

GitHub Spec-Kit 的完整中文汉化版本 | 规范驱动开发工具包

📖 简介

Spec-Kit 是 GitHub 开源的规范驱动开发工具包，与 Cursor 等 AI 编码工具深度集成，帮助开发者从需求到实现的全流程开发。

本项目特点：

🇨🇳 完整中文化 - 所有命令和模板已汉化
📋 开头一句话 - 每个命令都有简洁的用途说明
🚀 开箱即用 - 克隆即可使用
📚 文档完善 - 详细的中文使用指南

✨ 核心功能

🎯 四阶段核心工作流

阶段	命令	用途
1️⃣	`/speckit.specify`	将功能需求转化为清晰的规范文档
2️⃣	`/speckit.plan`	制定功能的技术实现方案
3️⃣	`/speckit.tasks`	将技术方案分解为可执行的任务清单
4️⃣	`/speckit.implement`	按任务清单逐步实现功能代码

🔧 辅助命令

命令	用途	使用时机
`/speckit.constitution`	定义项目的核心原则和开发规范	项目开始时（可选）
`/speckit.clarify`	解决规范中的模糊和歧义问题	规范化后（可选）
`/speckit.analyze`	检查规范、计划、任务的一致性	实现前（可选）
`/speckit.checklist`	生成需求质量验证清单	任何阶段

🚀 快速开始

方式一：使用此模板创建新项目

# 1. 在 GitHub 上点击 "Use this template" 创建新仓库

# 2. 克隆您的新仓库
git clone https://github.com/your-username/your-project.git
cd your-project

# 3. 开始使用（在 Cursor 中）
/speckit.specify
开发一个用户注册功能...

方式二：在现有项目中使用

# 1. 确保已安装 Spec-Kit CLI
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# 2. 在项目中初始化
cd your-existing-project
specify init --here --ai cursor --force

# 3. 复制中文化文件
# 从本模板复制 .cursor/commands/ 和 .specify/templates/ 到您的项目

📚 使用示例

完整开发流程

# 步骤 1：创建功能规范
/speckit.specify
开发一个待办事项管理功能。用户可以创建、查看、标记完成、删除待办事项。

# 步骤 2：制定技术方案
/speckit.plan

# 步骤 3：分解任务
/speckit.tasks

# 步骤 4：开始实现
/speckit.implement

最小工作流（4步）

指定 → 规划 → 任务 → 实现

完整工作流（含质量检查）

原则 → 指定 → 澄清 → 规划 → 任务 → 分析 → 实现

📁 项目结构

.
├── .cursor/
│   └── commands/          # 8个汉化的命令文件
│       ├── speckit.constitution.md
│       ├── speckit.specify.md
│       ├── speckit.clarify.md
│       ├── speckit.plan.md
│       ├── speckit.tasks.md
│       ├── speckit.implement.md
│       ├── speckit.analyze.md
│       └── speckit.checklist.md
│
├── .specify/
│   ├── memory/
│   │   └── constitution.md    # 项目宪章模板
│   ├── scripts/               # 自动化脚本
│   └── templates/             # 5个汉化的文档模板
│
├── README.md                  # 本文档
└── 命令快速参考.md             # 命令速查表

🎯 汉化说明

本项目遵循以下汉化原则：

✅ 已汉化

所有命令的 description 和执行说明
所有模板的章节标题和注释
每个命令开头的"命令用途"说明

✅ 保持英文

命令文件名（如 speckit.specify.md）
命令触发词（如 /speckit.specify）
技术标识符（变量名、路径等）

原因：确保工具稳定运行的同时提供最佳中文体验

💡 核心优势

对比项	传统开发	Spec-Kit
需求管理	口头沟通，易误解	结构化文档，清晰明确
开发流程	直接编码，后期问题多	先规范后实现，减少返工
测试覆盖	后期补充，覆盖率低	强制 TDD，测试先行
文档维护	文档与代码脱节	规范与实现同步
团队协作	依赖个人理解	基于统一规范

🌟 特色功能

1. 开头一句话用途说明

每个命令文档都以简洁的方式告诉您它的用途：

## 📋 命令用途

**将功能需求转化为清晰的规范文档**

2. 快速参考表

查看命令快速参考.md 获取：

所有命令总览
使用时机说明
完整工作流示例
使用技巧

📋 系统要求

Python: 3.11+
包管理器: uv
AI 工具: Cursor（推荐）或其他兼容工具
Git: 版本控制

🤝 贡献

欢迎提交 Issue 和 Pull Request！

如果您发现翻译不准确或有改进建议，请：

Fork 本仓库
创建您的特性分支
提交更改
发起 Pull Request

📄 许可证

本项目基于原 github/spec-kit 项目。

汉化工作遵循原项目的许可证。

🔗 相关链接

⭐ 如果有帮助，请给个 Star！

如果这个汉化版本对您有帮助，请点击右上角的 ⭐ Star 支持我们！

开始使用 Spec-Kit 中文版，体验规范驱动开发的强大威力！ 🚀

spec-kit-chinese

Links

README