Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Chinese-localized spec-driven development toolkit for Codex, Claude Code, Cursor, and other AI coding agents.
| Date | Stars |
|---|---|
| 2026-07-31 | 332 |
| 2026-08-06 | 332 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
35.0
growth rate 0.00%/day
<!-- spec-kit-zh repo note: package `specify-cli-zh`, command `specify-zh`. -->
<div align="center">
<img src="./media/logo_large.webp" alt="Spec Kit Logo" width="200" height="200"/>
<h1>🌱 Spec Kit ZH</h1>
<h3><em>更快地构建高质量软件。</em></h3>
</div>
<p align="center">
<strong>一个开源工具包，让你专注于产品场景与可预期的结果，而不是从零开始凭感觉拼凑每一个实现细节。</strong>
</p>
<p align="center">
<a href="https://github.com/loulanyue/spec-kit-zh/releases/latest"><img src="https://img.shields.io/github/v/release/loulanyue/spec-kit-zh?label=version&style=flat" alt="Version"/></a>
<a href="https://github.com/loulanyue/spec-kit-zh/releases/latest"><img src="https://img.shields.io/github/v/release/loulanyue/spec-kit-zh?style=flat" alt="Latest Release"/></a>
<a href="https://github.com/loulanyue/spec-kit-zh/stargazers"><img src="https://img.shields.io/github/stars/loulanyue/spec-kit-zh?style=flat" alt="GitHub stars"/></a>
<a href="./LICENSE"><img src="https://img.shields.io/github/license/loulanyue/spec-kit-zh?style=flat" alt="License"/></a>
<a href="./docs"><img src="https://img.shields.io/badge/docs-Repository-blue?style=flat" alt="Documentation"/></a>
</p>
---
## 目录
- [🤔 什么是规范驱动开发？](#what-is-sdd)
- [⚡ 快速开始](#quickstart)
- [📽️ 视频概览](#video-overview)
- [🚶 社区演练项目](#community-walkthroughs)
- [🤖 支持的 AI 代理](#supported-ai-agents)
- [🔧 specify-zh 命令参考](#specify-zh-cli-reference)
- [📚 核心理念](#core-philosophy)
- [🌟 开发阶段](#development-phases)
- [🎯 实验目标](#experimental-goals)
- [🔧 前置要求](#prerequisites)
- [📖 延伸阅读](#learn-more)
- [📋 详细流程](#detailed-process)
- [🔍 故障排除](#troubleshooting)
- [💬 支持](#support)
- [🙏 致谢](#acknowledgements)
- [⭐ Star History](#star-history)
- [📄 许可证](#license)
<a id="what-is-sdd"></a>
## 🤔 什么是规范驱动开发？
规范驱动开发（Spec-Driven Development）**重新定义**了软件开发的起点。过去几十年里，代码一直是开发过程中的主角，而规范常常只是编码开始前临时搭起来的脚手架。规范驱动开发改变了这一点：**规范本身变得可执行**，它不再只是指导实现，而是可以直接驱动计划、任务拆解与最终实现。
<a id="quickstart"></a>
## ⚡ 快速开始
如果你希望先快速跑通一遍从需求到实现的完整流程，这一节可以帮助你在几分钟内建立起最小可用认知。
### ⏱️ 3 分钟上手
**第 1 步：安装**
```bash
uv tool install specify-cli-zh --from git+https://github.com/loulanyue/spec-kit-zh.git
```
> [!IMPORTANT]
> 📦 **安装包名**：`specify-cli-zh` (用于 pip / uv install 下载)
> 🚀 **执行命令**：`specify-zh` (用于在终端执行工具)
**第 2 步：初始化项目**
```bash
specify-zh init my-project
```
**第 3 步：验证**
```bash
specify-zh check
```
### 🤷♂️ 我应该用哪个命令？ (FAQ)
- **`specify-cli-zh`**：这是本中文分支在 Python 包管理系统中的**分发包名**。但在运行工具本身时，请**不要**输入 `specify-cli-zh`。
- **`specify-zh`**：这是您真正在终端执行的**命令名**。所有的命令前缀都应为 `specify-zh` 以避免冲突。
- **`specify`**：这是上游英文原版的默认命令名。如果你只安装了本工具，并且环境中没有安装过冲突工具，你可以为其配置 alias，但在本项目文档和教程中，我们将始终称之为 `specify-zh`。
### 📌 安装方式速览
| 场景 | 推荐命令 |
| ---- | ---- |
| 长期使用、希望全局可调用 | `uv tool install specify-cli-zh --from git+https://github.com/loulanyue/spec-kit-zh.git` |
| 临时试用、不想安装到本机 | `uvx --from git+https://github.com/loulanyue/spec-kit-zh.git specify-zh` |
---
### 1. 安装 `specify-cli-zh`
请选择你偏好的安装方式：
#### 方式 1：持久化安装（推荐）
安装一次，全局可用：
```bash
uv tool install specify-cli-zh --from git+https://github.com/loulanyue/spec-kit-zh.git
```
安装完成后即可直接使用：
```bash
# 创建新项目
specify-zh init <PROJECT_NAME>
# 或在现有项目中初始化
specify-zh init . --ai claude
# 或者
specify-zh init --here --ai claude
# 检查本机工具环境
specify-zh check
```
`specify-cli-zh` 默认安装的命令名是 `specify-zh`，这样可以避免与其他已安装的 `specify` 命令冲突。
升级 Specify 请参阅 [升级指南](./docs/upgrade.md)。快速升级命令如下：
```bash
uv tool install specify-cli-zh --force --from git+https://github.com/loulanyue/spec-kit-zh.git
```
#### 方式 2：一次性使用
无需安装，直接运行：
```bash
# 创建新项目
uvx --from git+https://github.com/loulanyue/spec-kit-zh.git specify-zh init <PROJECT_NAME>
# 或在现有项目中初始化
uvx --from git+https://github.com/loulanyue/spec-kit-zh.git specify-zh init . --ai claude
# 或者
uvx --from git+https://github.com/loulanyue/spec-kit-zh.git specify-zh init --here --ai claude
```
**持久化安装的优势：**
- 工具会保留在 PATH 中，随时可用
- 不需要额外维护 shell 别名
- 可以使用 `uv tool list`、`uv tool upgrade`、`uv tool uninstall` 做更完整的工具管理
- shell 配置更简洁
### 2. 验证安装
安装完成后，运行以下命令确认 CLI 正常工作：
```bash
specify-zh --helpExcerpt of 30,293 characters
Read on GitHubWould you bet a product on this? Bounded 0–100 and slow moving.
matched fp:0ed16ad9556efcc6, topic:ai-coding, topic:developer-tools