docs(zh-CN): sync Chinese docs with latest upstream changes (#341)

* docs(zh-CN): sync Chinese docs with latest upstream changes

* docs(zh-CN): update link

---------

Co-authored-by: neo <neo.dowithless@gmail.com>
This commit is contained in:
zdoc.app
2026-03-08 06:48:02 +08:00
committed by GitHub
parent da17d33ac3
commit abcf38b085
53 changed files with 2977 additions and 610 deletions

61
docs/zh-CN/CLAUDE.md Normal file
View File

@@ -0,0 +1,61 @@
# CLAUDE.md
本文件为 Claude Code (claude.ai/code) 处理此仓库代码时提供指导。
## 项目概述
这是一个 **Claude Code 插件** - 一个包含生产就绪的代理、技能、钩子、命令、规则和 MCP 配置的集合。该项目提供了使用 Claude Code 进行软件开发的经验证的工作流。
## 运行测试
```bash
# Run all tests
node tests/run-all.js
# Run individual test files
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js
```
## 架构
项目组织为以下几个核心组件:
* **agents/** - 用于委派的专业化子代理规划器、代码审查员、TDD 指南等)
* **skills/** - 工作流定义和领域知识(编码标准、模式、测试)
* **commands/** - 由用户调用的斜杠命令(/tdd, /plan, /e2e 等)
* **hooks/** - 基于触发的自动化(会话持久化、工具前后钩子)
* **rules/** - 始终遵循的指南(安全、编码风格、测试要求)
* **mcp-configs/** - 用于外部集成的 MCP 服务器配置
* **scripts/** - 用于钩子和设置的跨平台 Node.js 工具
* **tests/** - 脚本和工具的测试套件
## 关键命令
* `/tdd` - 测试驱动开发工作流
* `/plan` - 实施规划
* `/e2e` - 生成并运行端到端测试
* `/code-review` - 质量审查
* `/build-fix` - 修复构建错误
* `/learn` - 从会话中提取模式
* `/skill-create` - 从 git 历史记录生成技能
## 开发说明
* 包管理器检测npm、pnpm、yarn、bun可通过 `CLAUDE_PACKAGE_MANAGER` 环境变量或项目配置设置)
* 跨平台:通过 Node.js 脚本支持 Windows、macOS、Linux
* 代理格式:带有 YAML 前言的 Markdown名称、描述、工具、模型
* 技能格式:带有清晰章节的 Markdown何时使用、如何工作、示例
* 钩子格式:带有匹配器条件和命令/通知钩子的 JSON
## 贡献
遵循 CONTRIBUTING.md 中的格式:
* 代理:带有前言的 Markdown名称、描述、工具、模型
* 技能:清晰的章节(何时使用、如何工作、示例)
* 命令:带有描述前言的 Markdown
* 钩子:带有匹配器和钩子数组的 JSON
文件命名:小写字母并用连字符连接(例如 `python-reviewer.md`, `tdd-workflow.md`