spec-kit-cn CLAUDE.md

Spec Kit CN

项目性质: GitHub Spec Kit 的官方中文复刻版本, 仅做中文本地化, 不开发新特性

项目标识

核心信息

• 项目名称: Spec Kit CN
• 原版项目: github/spec-kit
• 当前项目: linfee/spec-kit-cn
• 包名: specify-cn(原版: specify-cli 不做更改)
• 命令: specify-cn(原版: specify)
• 文档语言: 中文(原版: 英文)

核心原则

1. 功能对等: 与原版保持完全一致的功能, 不添加新特性
2. 仅做本地化: 专注于中文翻译和本地化适配
3. 同步优先: 定期与原版同步, 保持技术更新

关键差异

项目	原版	中文版
包名	specify-cli	specify-cn-cli
命令	specify	specify-cn
文档	英文	中文
功能	持续开发	仅做本地化
斜杠命令	/speckit.plan	保持一致

---

快速参考

常用命令

# 开发环境
uv sync                              # 同步依赖
uv run specify-cn --help             # 运行 CLI
uv run specify-cn check              # 检查工具链

# 测试功能
specify-cn init test-project --ai claude    # 测试项目初始化
specify-cn --help | grep -E "中文|Spec Kit CN"  # 验证中文输出

自动化翻译工作流

# 一键自动化翻译(推荐)
/translation-auto      # 全自动翻译流程

# 原版更新处理
/translation-sync      # 智能同步原版更新

# 质量管理
/translation-qa        # 质量保证检查
/translation-fix       # 智能修复问题

# 人工审核
/translation-review    # 人工审核(已存在)
/translation-workflow  # 工作流指南

项目目录结构

项目根目录/
├── src/specify_cli/           # 核心代码(必须同步)
├── templates/                 # 模板文件(需要本地化)
├── scripts/                   # 构建脚本(完全同步, 不翻译)
├── .devcontainer/             # 开发容器配置(完全同步, 不翻译)
├── .github/                   # CI配置(谨慎同步, 不翻译)
├── docs/                     # 项目文档(需要本地化)
├── memory/                    # 项目章程(需要本地化)
├── spec-kit/                 # 原版项目(.gitignore)
├── .claude/commands/         # 翻译自动化命令
├── TERMINOLOGY.md            # 术语表
├── TRANSLATION_STANDARDS.md  # 翻译标准
├── CHANGELOG.md              # 版本记录(独立维护)
└── CLAUDE.md                 # 项目记忆文件

文件分类与处理策略

类别	目录/文件	同步策略	本地化策略
核心代码	src/specify_cli/	必须同步	CLI输出信息需要中文
模板系统	templates/	结构同步	完全中文翻译
构建脚本	scripts/	完全同步	不翻译
开发环境	.devcontainer/	完全同步	不翻译
CI配置	.github/	谨慎同步	不翻译
项目文档	docs/, README.md	结构参考	完全中文翻译
项目章程	memory/constitution.md	结构同步	完全中文翻译
原版追踪	spec-kit/	不提交	不适用
Agent入口	AGENTS.md	独立维护	引用CLAUDE.md