Skip to content
Back to search

everything-claude-code-zh

everything-claude-code 中文翻译项目:完整的 Claude Code 配置集合(agents, skills, hooks, commands, rules, MCPs)。源自 Anthropic 黑客松获胜者的实战配置,助力中文工程师高效理解与使用 Claude Code。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xu-xiang--everything-claude-code-zh/badge.svg)](/listings/xu-xiang--everything-claude-code-zh)

HTML

<a href="/listings/xu-xiang--everything-claude-code-zh"><img src="/api/listings/xu-xiang--everything-claude-code-zh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

在 2 分钟内启动并运行:

步骤 1:安装插件 (Plugin)

# 添加市场
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/plugin install everything-claude-code@everything-claude-code

步骤 2:安装规则 (Rules)(必选)

> ⚠️ **重要提示:** Claude Code 插件无法自动分发 `rules`(规则)。请手动安装:

# 首先克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# 推荐:使用安装脚本(安全处理通用规则和语言规则)
./install.sh typescript    # 或 python 或 golang
# 你可以传递多种语言:
# ./install.sh typescript python golang
# 或者针对 cursor 安装:
# ./install.sh --target cursor typescript

有关手动安装的说明,请参阅 `rules/` 文件夹中的 README。

步骤 3:开始使用

# 尝试一个命令(插件安装使用命名空间形式)
/everything-claude-code:plan "添加用户身份验证"

# 手动安装(选项 2)使用简短形式:
# /plan "添加用户身份验证"

# 查看可用命令
/plugin list everything-claude-code@everything-claude-code

✨ **完成!** 你现在可以访问 13 个智能体(Agents)、56 个技能(Skills)和 32 个命令(Commands)。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 49 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "everything-claude-code",
  4. "description": "Battle-tested Claude Code configurations from an Anthropic hackathon winner — agents, skills, hooks, commands, and rules evolved over 10+ months of intensive daily use",
  5. "owner": {
  6. "name": "Affaan Mustafa",
  7. "email": "me@affaanmustafa.com"
  8. },
  9. "metadata": {
  10. "description": "Battle-tested Claude Code configurations from an Anthropic hackathon winner"
  11. },
  12. "plugins": [
  13. {
  14. "name": "everything-claude-code",
  15. "source": "./",
  16. "description": "The most comprehensive Claude Code plugin — 14+ agents, 56+ skills, 33+ commands, and production-ready hooks for TDD, security scanning, code review, and continuous learning",
  17. "version": "1.7.0",
  18. "author": {
  19. "name": "Affaan Mustafa",
  20. "email": "me@affaanmustafa.com"
  21. },
  22. "homepage": "https://github.com/affaan-m/everything-claude-code",
  23. "repository": "https://github.com/affaan-m/everything-claude-code",
  24. "license": "MIT",
  25. "keywords": [
  26. "agents",
  27. "skills",
  28. "hooks",
  29. "commands",
  30. "tdd",
  31. "code-review",
  32. "security",
  33. "best-practices"
  34. ],
  35. "category": "workflow",
  36. "tags": [
  37. "agents",
  38. "skills",
  39. "hooks",
  40. "commands",
  41. "tdd",
  42. "code-review",
  43. "security",
  44. "best-practices"
  45. ],
  46. "strict": false
  47. }
  48. ]
  49. }
README.md · README · 1,188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. **语言:** [English](README.md) | **简体中文** | [繁體中文](docs/zh-TW/README.md)
  2. # Everything Claude Code
  3. [![Stars](https://img.shields.io/github/stars/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/stargazers)
  4. [![Forks](https://img.shields.io/github/forks/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/network/members)
  5. [![Contributors](https://img.shields.io/github/contributors/affaan-m/everything-claude-code?style=flat)](https://github.com/affaan-m/everything-claude-code/graphs/contributors)
  6. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  7. ![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white)
  8. ![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
  9. ![Python](https://img.shields.io/badge/-Python-3776AB?logo=python&logoColor=white)
  10. ![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)
  11. ![Java](https://img.shields.io/badge/-Java-ED8B00?logo=openjdk&logoColor=white)
  12. ![Markdown](https://img.shields.io/badge/-Markdown-000000?logo=markdown&logoColor=white)
  13. > **50K+ stars** | **6K+ forks** | **30 contributors** | **6 种语言支持** | **Anthropic 黑客松获胜者**
  14. ---
  15. <div align="center">
  16. **🌐 Language / 语言 / 語言**
  17. [**English**](README.md) | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja-JP/README.md)
  18. </div>
  19. ---
  20. **为 AI 智能体(Agent)框架打造的性能优化系统。源自 Anthropic 黑客松获胜作品。**
  21. 这不仅仅是配置文件。它是一个完整的系统:包含技能(Skills)、本能(Instincts)、内存优化、持续学习、安全扫描以及研究优先的开发模式。这些生产级的智能体(Agents)、钩子(Hooks)、命令(Commands)、规则(Rules)以及 MCP 配置,是在构建真实产品的 10 个多月高强度日常使用中演化而来的。
  22. 适用于 **Claude Code**, **Codex**, **Cowork** 以及其他 AI 智能体框架。
  23. ---
  24. ## 指南 (The Guides)
  25. 本仓库仅包含原始代码。指南部分解释了所有细节。
  26. <table>
  27. <tr>
  28. <td width="50%">
  29. <a href="https://x.com/affaanmustafa/status/2012378465664745795">
  30. <img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="Everything Claude Code 简明指南" />
  31. </a>
  32. </td>
  33. <td width="50%">
  34. <a href="https://x.com/affaanmustafa/status/2014040193557471352">
  35. <img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="Everything Claude Code 详细指南" />
  36. </a>
  37. </td>
  38. </tr>
  39. <tr>
  40. <td align="center"><b>简明指南 (Shorthand Guide)</b><br/>设置、基础知识、哲学。<b>请先阅读此篇。</b></td>
  41. <td align="center"><b>详细指南 (Longform Guide)</b><br/>令牌(Token)优化、内存持久化、评测(Evals)、并行化。</td>
  42. </tr>
  43. </table>
  44. | 主题 | 你将学到什么 |
  45. |-------|-------------------|
  46. | 令牌(Token)优化 | 模型选择、系统提示词瘦身、后台进程 |
  47. | 内存持久化 | 跨会话自动保存/加载上下文的钩子 (Hooks) |
  48. | 持续学习 | 自动将会话模式提取为可重用的技能 (Skills) |
  49. | 验证循环 | 检查点 vs 持续评测、评分器类型、pass@k 指标 |
  50. | 并行化 | Git worktrees、级联方法、何时扩展实例 |
  51. | 子智能体编排 | 上下文问题、迭代检索模式 |
  52. ---
  53. ## 更新内容 (What's New)
  54. ### v1.7.0 — 跨平台扩展与演示文稿生成器 (2026年2月)
  55. - **Codex 应用 + CLI 支持** — 直接支持基于 `AGENTS.md` 的 Codex,安装器目标定位及 Codex 文档
  56. - **`frontend-slides` 技能 (Skill)** — 无依赖的 HTML 演示文稿生成器,包含 PPTX 转换指南和严格的视口自适应规则
  57. - **5 个新型通用业务/内容技能** — `article-writing`(文章写作)、`content-engine`(内容引擎)、`market-research`(市场研究)、`investor-materials`(融资材料)、`investor-outreach`(投资者对接)
  58. - **更广的工具覆盖** — 强化了 Cursor、Codex 和 OpenCode 的支持,使同一仓库能在所有主流框架中无缝运行
  59. - **992 项内部测试** — 扩展了插件、钩子 (Hooks)、技能 (Skills) 及打包的验证与回归覆盖率
  60. ### v1.6.0 — Codex CLI, AgentShield & 市场 (2026年2月)
  61. - **Codex CLI 支持** — 新增 `/codex-setup` 命令,生成用于 OpenAI Codex CLI 兼容的 `codex.md`
  62. - **7 个新技能** — `search-first`、`swift-actor-persistence`、`swift-protocol-di-testing`、`regex-vs-llm-structured-text`、`content-hash-cache-pattern`、`cost-aware-llm-pipeline`、`skill-stocktake`
  63. - **AgentShield 集成** — `/security-scan` 技能可直接从 Claude Code 运行 AgentShield;包含 1282 项测试,102 条规则
  64. - **GitHub 市场 (Marketplace)** — ECC Tools GitHub 应用已在 [github.com/marketplace/ecc-tools](https://github.com/marketplace/ecc-tools) 上线,提供免费/专业/企业版
  65. - **合并 30+ 社区 PR** — 来自 6 种语言的 30 位贡献者的贡献
  66. - **978 项内部测试** — 扩展了涵盖智能体、技能、命令、钩子和规则的验证套件
  67. ### v1.4.1 — Bug 修复 (2026年2月)
  68. - **修复本能 (Instinct) 导入内容丢失问题** — `parse_instinct_file()` 在执行 `/instinct-import` 时会静默丢弃 Frontmatter 之后的所有内容(Action、Evidence、Examples 部分)。由社区贡献者 @ericcai0814 修复 ([#148](https://github.com/affaan-m/everything-claude-code/issues/148), [#161](https://github.com/affaan-m/everything-claude-code/pull/161))
  69. ### v1.4.0 — 多语言规则、安装向导与 PM2 (2026年2月)
  70. - **交互式安装向导** — 新增 `configure-ecc` 技能,提供带合并/覆盖检测的引导式设置
  71. - **PM2 与多智能体编排** — 6 个新命令(`/pm2`, `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend`, `/multi-workflow`)用于管理复杂的多服务工作流
  72. - **多语言规则架构** — 规则从扁平文件重构为 `common/` + `typescript/` + `python/` + `golang/` 目录。仅安装你需要的语言
  73. - **中文 (zh-CN) 翻译** — 完成了所有智能体、命令、技能和规则(80+ 文件)的完整翻译
  74. - **GitHub Sponsors 支持** — 可以通过 GitHub Sponsors 资助本项目
  75. - **增强的 CONTRIBUTING.md** — 为每种贡献类型提供了详细的 PR 模板
  76. ### v1.3.0 — OpenCode 插件支持 (2026年2月)
  77. - **全面集成 OpenCode** — 12 个智能体、24 个命令、16 个技能,通过 OpenCode 的插件系统(20+ 事件类型)支持钩子
  78. - **3 个原生自定义工具** — run-tests(运行测试)、check-coverage(检查覆盖率)、security-audit(安全审计)
  79. - **LLM 文档** — 提供 `llms.txt` 以获取全面的 OpenCode 文档
  80. ### v1.2.0 — 统一命令与技能 (2026年2月)
  81. - **Python/Django 支持** — Django 模式、安全、TDD 和验证技能
  82. - **Java Spring Boot 技能** — Spring Boot 的模式、安全、TDD 和验证
  83. - **会话管理** — `/sessions` 命令用于查看会话历史
  84. - **持续学习 v2** — 基于本能的带置信评分、导入/导出、进化的学习系统
  85. 在 [Releases](https://github.com/affaan-m/everything-claude-code/releases) 中查看完整变更日志。
  86. ---
  87. ## 🚀 快速开始 (Quick Start)
  88. 在 2 分钟内启动并运行:
  89. ### 步骤 1:安装插件 (Plugin)
  90. ```bash
  91. # 添加市场
  92. /plugin marketplace add affaan-m/everything-claude-code
  93. # 安装插件
  94. /plugin install everything-claude-code@everything-claude-code
  95. ```
  96. ### 步骤 2:安装规则 (Rules)(必选)
  97. > ⚠️ **重要提示:** Claude Code 插件无法自动分发 `rules`(规则)。请手动安装:
  98. ```bash
  99. # 首先克隆仓库
  100. git clone https://github.com/affaan-m/everything-claude-code.git
  101. cd everything-claude-code
  102. # 推荐:使用安装脚本(安全处理通用规则和语言规则)
  103. ./install.sh typescript # 或 python 或 golang
  104. # 你可以传递多种语言:
  105. # ./install.sh typescript python golang
  106. # 或者针对 cursor 安装:
  107. # ./install.sh --target cursor typescript
  108. ```
  109. 有关手动安装的说明,请参阅 `rules/` 文件夹中的 README。
  110. ### 步骤 3:开始使用
  111. ```bash
  112. # 尝试一个命令(插件安装使用命名空间形式)
  113. /everything-claude-code:plan "添加用户身份验证"
  114. # 手动安装(选项 2)使用简短形式:
  115. # /plan "添加用户身份验证"
  116. # 查看可用命令
  117. /plugin list everything-claude-code@everything-claude-code
  118. ```
  119. ✨ **完成!** 你现在可以访问 13 个智能体(Agents)、56 个技能(Skills)和 32 个命令(Commands)。
  120. ---
  121. ## 🌐 跨平台支持 (Cross-Platform Support)
  122. 该插件现已全面支持 **Windows, macOS 和 Linux**。所有钩子和脚本已使用 Node.js 重写,以实现最大兼容性。
  123. ### 包管理器检测 (Package Manager Detection)
  124. 插件会自动检测你首选的包管理器(npm, pnpm, yarn 或 bun),优先级如下:
  125. 1. **环境变量**: `CLAUDE_PACKAGE_MANAGER`
  126. 2. **项目配置**: `.claude/package-manager.json`
  127. 3. **package.json**: `packageManager` 字段
  128. 4. **锁文件**: 从 package-lock.json, yarn.lock, pnpm-lock.yaml 或 bun.lockb 检测
  129. 5. **全局配置**: `~/.claude/package-manager.json`
  130. 6. **备选方案**: 首个可用的包管理器
  131. 设置你首选的包管理器:
  132. ```bash
  133. # 通过环境变量
  134. export CLAUDE_PACKAGE_MANAGER=pnpm
  135. # 通过全局配置
  136. node scripts/setup-package-manager.js --global pnpm
  137. # 通过项目配置
  138. node scripts/setup-package-manager.js --project bun
  139. # 检测当前设置
  140. node scripts/setup-package-manager.js --detect
  141. ```
  142. 或者在 Claude Code 中使用 `/setup-pm` 命令。
  143. ---
  144. ## 📦 包含内容 (What's Inside)
  145. 本仓库是一个 **Claude Code 插件** —— 你可以直接安装,也可以手动复制组件。
  146. ```
  147. everything-claude-code/
  148. |-- .claude-plugin/ # 插件与市场清单文件
  149. | |-- plugin.json # 插件元数据与组件路径
  150. | |-- marketplace.json # 用于 /plugin marketplace add 的市场目录
  151. |
  152. |-- agents/ # 专门用于任务委派的子智能体 (Subagents)
  153. | |-- planner.md # 功能实现规划
  154. | |-- architect.md # 系统设计决策
  155. | |-- tdd-guide.md # 测试驱动开发 (TDD)
  156. | |-- code-reviewer.md # 质量与安全审查
  157. | |-- security-reviewer.md # 漏洞分析
  158. | |-- build-error-resolver.md # 构建错误修复
  159. | |-- e2e-runner.md # Playwright E2E 测试
  160. | |-- refactor-cleaner.md # 废弃代码清理
  161. | |-- doc-updater.md # 文档同步更新
  162. | |-- go-reviewer.md # Go 代码审查
  163. | |-- go-build-resolver.md # Go 构建错误修复
  164. | |-- python-reviewer.md # Python 代码审查 (新增)
  165. | |-- database-reviewer.md # 数据库/Supabase 审查 (新增)
  166. |
  167. |-- skills/ # 工作流定义与领域知识
  168. | |-- coding-standards/ # 语言最佳实践
  169. | |-- clickhouse-io/ # ClickHouse 分析、查询、数据工程
  170. | |-- backend-patterns/ # API、数据库、缓存模式
  171. | |-- frontend-patterns/ # React, Next.js 模式
  172. | |-- frontend-slides/ # HTML 幻灯片与 PPTX 转网页演示工作流 (新增)
  173. | |-- article-writing/ # 使用指定语气进行长文写作,无 AI 腔 (新增)
  174. | |-- content-engine/ # 多平台社交内容与重用工作流 (新增)
  175. | |-- market-research/ # 带源码引用的市场、竞对和投资者研究 (新增)
  176. | |-- investor-materials/ # 商业计划书、一页纸介绍、备忘录和财务模型 (新增)
  177. | |-- investor-outreach/ # 个性化融资对接与后续跟进 (新增)
  178. | |-- continuous-learning/ # 从会话中自动提取模式 (详细指南)
  179. | |-- continuous-learning-v2/ # 基于本能的带置信评分的学习系统
  180. | |-- iterative-retrieval/ # 为子智能体提供的渐进式上下文精炼
  181. | |-- strategic-compact/ # 手动压缩建议 (详细指南)
  182. | |-- tdd-workflow/ # TDD 方法论
  183. | |-- security-review/ # 安全自查表
  184. | |-- eval-harness/ # 验证循环评测 (详细指南)
  185. | |-- verification-loop/ # 持续验证 (详细指南)
  186. | |-- golang-patterns/ # Go 惯用法与最佳实践
  187. | |-- golang-testing/ # Go 测试模式、TDD、基准测试
  188. | |-- cpp-coding-standards/ # 源自 C++ Core Guidelines 的 C++ 编码标准 (新增)
  189. | |-- cpp-testing/ # 使用 GoogleTest, CMake/CTest 的 C++ 测试 (新增)
  190. | |-- django-patterns/ # Django 模式、模型、视图 (新增)
  191. | |-- django-security/ # Django 安全最佳实践 (新增)
  192. | |-- django-tdd/ # Django TDD 工作流 (新增)
  193. | |-- django-verification/ # Django 验证循环 (新增)
  194. | |-- python-patterns/ # Python 惯用法与最佳实践 (新增)
  195. | |-- python-testing/ # 使用 pytest 的 Python 测试 (新增)
  196. | |-- springboot-patterns/ # Java Spring Boot 模式 (新增)
  197. | |-- springboot-security/ # Spring Boot 安全 (新增)
  198. | |-- springboot-tdd/ # Spring Boot TDD (新增)
  199. | |-- springboot-verification/ # Spring Boot 验证 (新增)
  200. | |-- configure-ecc/ # 交互式安装向导 (新增)
  201. | |-- security-scan/ # AgentShield 安全审计集成 (新增)
  202. | |-- java-coding-standards/ # Java 编码标准 (新增)
  203. | |-- jpa-patterns/ # JPA/Hibernate 模式 (新增)
  204. | |-- postgres-patterns/ # PostgreSQL 优化模式 (新增)
  205. | |-- nutrient-document-processing/ # 使用 Nutrient API 处理文档 (新增)
  206. | |-- project-guidelines-example/ # 项目特定技能模板
  207. | |-- database-migrations/ # 迁移模式 (Prisma, Drizzle, Django, Go) (新增)
  208. | |-- api-design/ # REST API 设计、分页、错误响应 (新增)
  209. | |-- deployment-patterns/ # CI/CD, Docker, 健康检查, 回滚 (新增)
  210. | |-- docker-patterns/ # Docker Compose, 网络, 卷, 容器安全 (新增)
  211. | |-- e2e-testing/ # Playwright E2E 模式与页面对象模型 (POM) (新增)
  212. | |-- content-hash-cache-pattern/ # 用于文件处理的 SHA-256 内容哈希缓存 (新增)
  213. | |-- cost-aware-llm-pipeline/ # LLM 成本优化、模型路由、预算追踪 (新增)
  214. | |-- regex-vs-llm-structured-text/ # 决策框架:正则 vs LLM 解析文本 (新增)
  215. | |-- swift-actor-persistence/ # 使用 Actor 的线程安全 Swift 数据持久化 (新增)
  216. | |-- swift-protocol-di-testing/ # 基于协议的 DI 用于可测试的 Swift 代码 (新增)
  217. | |-- search-first/ # 编码前研究工作流 (新增)
  218. | |-- skill-stocktake/ # 审核技能与命令的质量 (新增)
  219. | |-- liquid-glass-design/ # iOS 26 Liquid Glass 设计系统 (新增)
  220. | |-- foundation-models-on-device/ # 使用 FoundationModels 的 Apple 端侧 LLM (新增)
  221. | |-- swift-concurrency-6-2/ # Swift 6.2 易用并发 (新增)
  222. | |-- autonomous-loops/ # 自主循环模式:顺序流水线、PR 循环、DAG 编排 (新增)
  223. | |-- plankton-code-quality/ # 使用 Plankton 钩子在编写时强制执行代码质量 (新增)
  224. |
  225. |-- commands/ # 用于快速执行的斜杠命令 (Slash commands)
  226. | |-- tdd.md # /tdd - 测试驱动开发
  227. | |-- plan.md # /plan - 实现规划
  228. | |-- e2e.md # /e2e - E2E 测试生成
  229. | |-- code-review.md # /code-review - 质量审查
  230. | |-- build-fix.md # /build-fix - 修复构建错误
  231. | |-- refactor-clean.md # /refactor-clean - 废弃代码移除
  232. | |-- learn.md # /learn - 会话中提取模式 (详细指南)
  233. | |-- learn-eval.md # /learn-eval - 提取、评测并保存模式 (新增)
  234. | |-- checkpoint.md # /checkpoint - 保存验证状态 (详细指南)
  235. | |-- verify.md # /verify - 运行验证循环 (详细指南)
  236. | |-- setup-pm.md # /setup-pm - 配置包管理器
  237. | |-- go-review.md # /go-review - Go 代码审查 (新增)
  238. | |-- go-test.md # /go-test - Go TDD 工作流 (新增)
  239. | |-- go-build.md # /go-build - 修复 Go 构建错误 (新增)
  240. | |-- skill-create.md # /skill-create - 从 git 历史生成技能 (新增)
  241. | |-- instinct-status.md # /instinct-status - 查看已学本能 (新增)
  242. | |-- instinct-import.md # /instinct-import - 导入本能 (新增)
  243. | |-- instinct-export.md # /instinct-export - 导出本能 (新增)
  244. | |-- evolve.md # /evolve - 将相关本能聚类为技能
  245. | |-- pm2.md # /pm2 - PM2 服务生命周期管理 (新增)
  246. | |-- multi-plan.md # /multi-plan - 多智能体任务分解 (新增)
  247. | |-- multi-execute.md # /multi-execute - 编排的多智能体工作流 (新增)
  248. | |-- multi-backend.md # /multi-backend - 后端多服务编排 (新增)
  249. | |-- multi-frontend.md # /multi-frontend - 前端多服务编排 (新增)
  250. | |-- multi-workflow.md # /multi-workflow - 通用多服务工作流 (新增)
  251. | |-- orchestrate.md # /orchestrate - 多智能体协调
  252. | |-- sessions.md # /sessions - 会话历史管理
  253. | |-- eval.md # /eval - 根据准则评测
  254. | |-- test-coverage.md # /test-coverage - 测试覆盖率分析
  255. | |-- update-docs.md # /update-docs - 更新文档
  256. | |-- update-codemaps.md # /update-codemaps - 更新代码映射 (codemaps)
  257. | |-- python-review.md # /python-review - Python 代码审查 (新增)
  258. |
  259. |-- rules/ # 必须遵守的准则 (复制到 ~/.claude/rules/)
  260. | |-- README.md # 结构概览与安装指南
  261. | |-- common/ # 语言无关原则
  262. | | |-- coding-style.md # 不变性、文件组织
  263. | | |-- git-workflow.md # 提交格式、PR 流程
  264. | | |-- testing.md # TDD, 80% 覆盖率要求
  265. | | |-- performance.md # 模型选择、上下文管理
  266. | | |-- patterns.md # 设计模式、骨架项目
  267. | | |-- hooks.md # 钩子架构、TodoWrite
  268. | | |-- agents.md # 何时委派给子智能体
  269. | | |-- security.md # 强制性安全检查
  270. | |-- typescript/ # TypeScript/JavaScript 特定
  271. | |-- python/ # Python 特定
  272. | |-- golang/ # Go 特定
  273. |
  274. |-- hooks/ # 基于触发器的自动化
  275. | |-- README.md # 钩子文档、配方与自定义指南
  276. | |-- hooks.json # 所有钩子配置 (PreToolUse, PostToolUse, Stop 等)
  277. | |-- memory-persistence/ # 会话生命周期钩子 (详细指南)
  278. | |-- strategic-compact/ # 压缩建议 (详细指南)
  279. |
  280. |-- scripts/ # 跨平台 Node.js 脚本 (新增)
  281. | |-- lib/ # 共享实用工具
  282. | | |-- utils.js # 跨平台文件/路径/系统实用程序
  283. | | |-- package-manager.js # 包管理器检测与选择
  284. | |-- hooks/ # 钩子实现
  285. | | |-- session-start.js # 会话开始时加载上下文
  286. | | |-- session-end.js # 会话结束时保存状态
  287. | | |-- pre-compact.js # 压缩前状态保存
  288. | | |-- suggest-compact.js # 策略性压缩建议
  289. | | |-- evaluate-session.js # 从会话中提取模式
  290. | |-- setup-package-manager.js # 交互式 PM 设置
  291. |
  292. |-- tests/ # 测试套件 (新增)
  293. | |-- lib/ # 库测试
  294. | |-- hooks/ # 钩子测试
  295. | |-- run-all.js # 运行所有测试
  296. |
  297. |-- contexts/ # 动态系统提示词注入上下文 (详细指南)
  298. | |-- dev.md # 开发模式上下文
  299. | |-- review.md # 代码审查模式上下文
  300. | |-- research.md # 研究/探索模式上下文
  301. |
  302. |-- examples/ # 示例配置与会话
  303. | |-- CLAUDE.md # 示例项目级配置
  304. | |-- user-CLAUDE.md # 示例用户级配置
  305. | |-- saas-nextjs-CLAUDE.md # 真实 SaaS (Next.js + Supabase + Stripe)
  306. | |-- go-microservice-CLAUDE.md # 真实 Go 微服务 (gRPC + PostgreSQL)
  307. | |-- django-api-CLAUDE.md # 真实 Django REST API (DRF + Celery)
  308. | |-- rust-api-CLAUDE.md # 真实 Rust API (Axum + SQLx + PostgreSQL) (新增)
  309. |
  310. |-- mcp-configs/ # MCP 服务器配置
  311. | |-- mcp-servers.json # GitHub, Supabase, Vercel, Railway 等
  312. |
  313. |-- marketplace.json # 自托管市场配置 (用于 /plugin marketplace add)
  314. ```
  315. ---
  316. ## 🛠️ 生态工具 (Ecosystem Tools)
  317. ### 技能生成器 (Skill Creator)
  318. 有两种方法可以从你的仓库生成 Claude Code 技能 (Skills):
  319. #### 选项 A:本地分析(内置)
  320. 使用 `/skill-create` 命令进行本地分析,无需外部服务:
  321. ```bash
  322. /skill-create # 分析当前仓库
  323. /skill-create --instincts # 同时生成用于持续学习的本能 (instincts)
  324. ```
  325. 这将本地分析你的 git 历史并生成 SKILL.md 文件。
  326. #### 选项 B:GitHub 应用(高级)
  327. 适用于高级功能(10k+ 提交、自动 PR、团队共享):
  328. [安装 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools)
  329. ```bash
  330. # 在任何 issue 下留言:
  331. /skill-creator analyze
  332. # 或者在推送到默认分支时自动触发
  333. ```
  334. 两个选项都会创建:
  335. - **SKILL.md 文件** - 可供 Claude Code 直接使用的技能
  336. - **本能集合 (Instinct collections)** - 适用于 continuous-learning-v2
  337. - **模式提取 (Pattern extraction)** - 从你的提交历史中学习
  338. ### AgentShield — 安全审计器 (Security Auditor)
  339. > 在 Claude Code 黑客松(Cerebral Valley x Anthropic, 2026年2月)中构建。包含 1282 项测试,98% 覆盖率,102 条静态分析规则。
  340. 扫描你的 Claude Code 配置是否存在漏洞、错误配置和注入风险。
  341. ```bash
  342. # 快速扫描(无需安装)
  343. npx ecc-agentshield scan
  344. # 自动修复安全问题
  345. npx ecc-agentshield scan --fix
  346. # 使用三个 Opus 4.6 智能体进行深度分析
  347. npx ecc-agentshield scan --opus --stream
  348. # 从头开始生成安全配置
  349. npx ecc-agentshield init
  350. ```
  351. **扫描范围:** CLAUDE.md, settings.json, MCP 配置, 钩子 (Hooks), 智能体定义以及 5 个类别的技能 —— 密钥检测(14 种模式)、权限审计、钩子注入分析、MCP 服务器风险分析以及智能体配置审查。
  352. **`--opus` 标志** 在红队/蓝队/审计员流水线中运行三个 Claude Opus 4.6 智能体。攻击者寻找攻击链,防御者评估防护措施,审计员将两者整合为优先排序的风险评估。这是对抗性推理,而非简单的模式匹配。
  353. **输出格式:** 终端(彩色分级 A-F)、JSON(CI 流水线)、Markdown、HTML。发现严重问题时退出代码为 2,用于构建门禁。
  354. 在 Claude Code 中使用 `/security-scan` 运行,或通过 [GitHub Action](https://github.com/affaan-m/agentshield) 添加到 CI。
  355. [GitHub](https://github.com/affaan-m/agentshield) | [npm](https://www.npmjs.com/package/ecc-agentshield)
  356. ### 🔬 Plankton — 编写时代码质量强制执行
  357. Plankton(鸣谢:@alxfazio)是推荐的代码编写时质量强制执行伙伴。它通过 PostToolUse 钩子在每次文件编辑时运行格式化程序和 20+ 个 linter,然后产生 Claude 子进程(根据违规复杂程度路由至 Haiku/Sonnet/Opus)来修复主智能体遗漏的问题。三阶段架构:静默自动格式化(解决 40-50% 的问题)、收集剩余违规为结构化 JSON、将修复委派给子进程。包含配置保护钩子,防止智能体为了通过检查而修改 linter 配置。支持 Python, TypeScript, Shell, YAML, JSON, TOML, Markdown 和 Dockerfile。配合 AgentShield 使用,可实现安全 + 质量覆盖。完整集成指南请见 `skills/plankton-code-quality/`。
  358. ### 🧠 持续学习 v2 (Continuous Learning v2)
  359. 基于本能的学习系统会自动学习你的模式:
  360. ```bash
  361. /instinct-status # 显示已学习的本能及其置信度
  362. /instinct-import <file> # 导入他人的本能
  363. /instinct-export # 导出你的本能进行分享
  364. /evolve # 将相关本能聚类为技能 (Skills)
  365. ```
  366. 完整文档请见 `skills/continuous-learning-v2/`。
  367. ---
  368. ## 📋 要求 (Requirements)
  369. ### Claude Code CLI 版本
  370. **最低版本:v2.1.0 或更高**
  371. 由于插件系统处理钩子 (Hooks) 方式的变更,该插件需要 Claude Code CLI v2.1.0+。
  372. 检查你的版本:
  373. ```bash
  374. claude --version
  375. ```
  376. ### 重要提示:钩子自动加载行为
  377. > ⚠️ **致贡献者:** 请勿在 `.claude-plugin/plugin.json` 中添加 `"hooks"` 字段。这已通过回归测试强制执行。
  378. Claude Code v2.1+ 会按约定从任何已安装的插件中**自动加载** `hooks/hooks.json`。在 `plugin.json` 中显式声明会导致重复检测错误:
  379. ```
  380. Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
  381. ```
  382. **历史背景:** 这在该仓库中曾导致反复的修复/回滚循环([#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103))。由于 Claude Code 版本间的行为变更导致了混淆。我们现在已加入回归测试以防此类问题再次出现。
  383. ---
  384. ## 📥 安装 (Installation)
  385. ### 选项 1:作为插件安装(推荐)
  386. 使用本仓库最简单的方法 —— 作为 Claude Code 插件安装:
  387. ```bash
  388. # 将本仓库添加为市场
  389. /plugin marketplace add affaan-m/everything-claude-code
  390. # 安装插件
  391. /plugin install everything-claude-code@everything-claude-code
  392. ```
  393. 或者直接添加到你的 `~/.claude/settings.json`:
  394. ```json
  395. {
  396. "extraKnownMarketplaces": {
  397. "everything-claude-code": {
  398. "source": {
  399. "source": "github",
  400. "repo": "affaan-m/everything-claude-code"
  401. }
  402. }
  403. },
  404. "enabledPlugins": {
  405. "everything-claude-code@everything-claude-code": true
  406. }
  407. }
  408. ```
  409. 这将使你立即获得对所有命令、智能体、技能和钩子的访问权限。
  410. > **注意:** Claude Code 插件系统目前不支持通过插件分发 `rules`(规则)([上游限制](https://code.claude.com/docs/en/plugins-reference))。你需要手动安装规则:
  411. >
  412. > ```bash
  413. > # 首先克隆仓库
  414. > git clone https://github.com/affaan-m/everything-claude-code.git
  415. >
  416. > # 选项 A:用户级规则(适用于所有项目)
  417. > mkdir -p ~/.claude/rules
  418. > cp -r everything-claude-code/rules/common/* ~/.claude/rules/
  419. > cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # 选择你的技术栈
  420. > cp -r everything-claude-code/rules/python/* ~/.claude/rules/
  421. > cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
  422. >
  423. > # 选项 B:项目级规则(仅适用于当前项目)
  424. > mkdir -p .claude/rules
  425. > cp -r everything-claude-code/rules/common/* .claude/rules/
  426. > cp -r everything-claude-code/rules/typescript/* .claude/rules/ # 选择你的技术栈
  427. > ```
  428. ---
  429. ### 🔧 选项 2:手动安装
  430. 如果你更喜欢手动控制安装内容:
  431. ```bash
  432. # 克隆仓库
  433. git clone https://github.com/affaan-m/everything-claude-code.git
  434. # 将智能体复制到你的 Claude 配置目录
  435. cp everything-claude-code/agents/*.md ~/.claude/agents/
  436. # 复制规则(通用规则 + 特定语言规则)
  437. cp -r everything-claude-code/rules/common/* ~/.claude/rules/
  438. cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/ # 选择你的技术栈
  439. cp -r everything-claude-code/rules/python/* ~/.claude/rules/
  440. cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
  441. # 复制命令
  442. cp everything-claude-code/commands/*.md ~/.claude/commands/
  443. # 复制技能(核心 vs 细分领域)
  444. # 推荐(新用户):仅安装核心/通用技能
  445. cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
  446. cp -r everything-claude-code/skills/search-first ~/.claude/skills/
  447. # 可选:仅在需要时添加细分/框架特定技能
  448. # for s in django-patterns django-tdd springboot-patterns; do
  449. # cp -r everything-claude-code/skills/$s ~/.claude/skills/
  450. # done
  451. ```
  452. #### 将钩子添加到 settings.json
  453. 将 `hooks/hooks.json` 中的钩子复制到你的 `~/.claude/settings.json` 中。
  454. #### 配置 MCPs
  455. 将 `mcp-configs/mcp-servers.json` 中所需的 MCP 服务器复制到你的 `~/.claude.json` 中。
  456. **重要提示:** 请将 `YOUR_*_HERE` 占位符替换为你真实的 API 密钥。
  457. ---
  458. ## 🎯 核心概念 (Key Concepts)
  459. ### 智能体 (Agents)
  460. 子智能体 (Subagents) 处理范围内受限的委派任务。示例:
  461. ```markdown
  462. ---
  463. name: code-reviewer
  464. description: 审查代码的质量、安全性和可维护性
  465. tools: ["Read", "Grep", "Glob", "Bash"]
  466. model: opus
  467. ---
  468. 你是一名资深代码审查员...
  469. ```
  470. ### 技能 (Skills)
  471. 技能是由命令或智能体调用的工作流定义:
  472. ```markdown
  473. # TDD 工作流
  474. 1. 先定义接口
  475. 2. 编写失败的测试 (RED)
  476. 3. 实现最简代码 (GREEN)
  477. 4. 重构 (IMPROVE)
  478. 5. 验证 80%+ 的覆盖率
  479. ```
  480. ### 钩子 (Hooks)
  481. 钩子在工具事件上触发。示例 —— 警告 console.log:
  482. ```json
  483. {
  484. "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
  485. "hooks": [{
  486. "type": "command",
  487. "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
  488. }]
  489. }
  490. ```
  491. ### 规则 (Rules)
  492. 规则是必须遵守的准则,组织在 `common/`(语言无关)+ 特定语言目录中:
  493. ```
  494. rules/
  495. common/ # 通用原则(始终安装)
  496. typescript/ # TS/JS 特定模式与工具
  497. python/ # Python 特定模式与工具
  498. golang/ # Go 特定模式与工具
  499. ```
  500. 安装和结构细节请参见 [`rules/README.md`](rules/README.md)。
  501. ---
  502. ## 🗺️ 我该使用哪个智能体 (Agent)?
  503. 不确定从哪里开始?请参考此快速指南:
  504. | 我想... | 使用此命令 | 使用的智能体 (Agent) |
  505. |--------------|-----------------|------------|
  506. | 规划新功能 | `/everything-claude-code:plan "添加认证"` | planner |
  507. | 设计系统架构 | `/everything-claude-code:plan` + architect 智能体 | architect |
  508. | 先写测试再写代码 | `/tdd` | tdd-guide |
  509. | 审查我刚写的代码 | `/code-review` | code-reviewer |
  510. | 修复构建失败 | `/build-fix` | build-error-resolver |
  511. | 运行端到端 (E2E) 测试 | `/e2e` | e2e-runner |
  512. | 查找安全漏洞 | `/security-scan` | security-reviewer |
  513. | 移除废弃代码 | `/refactor-clean` | refactor-cleaner |
  514. | 更新文档 | `/update-docs` | doc-updater |
  515. | 审查 Go 代码 | `/go-review` | go-reviewer |
  516. | 审查 Python 代码 | `/python-review` | python-reviewer |
  517. | 审计数据库查询 | *(自动委派)* | database-reviewer |
  518. ### 常见工作流 (Common Workflows)
  519. **开始新功能:**
  520. ```
  521. /everything-claude-code:plan "使用 OAuth 添加用户身份验证"
  522. → planner 创建实现蓝图
  523. /tdd → tdd-guide 强制执行先写测试
  524. /code-review → code-reviewer 检查你的工作
  525. ```
  526. **修复 Bug:**
  527. ```
  528. /tdd → tdd-guide: 编写一个复现问题的失败测试
  529. → 实现修复,验证测试通过
  530. /code-review → code-reviewer: 捕捉回归问题
  531. ```
  532. **准备生产发布:**
  533. ```
  534. /security-scan → security-reviewer: OWASP Top 10 审计
  535. /e2e → e2e-runner: 关键用户流程测试
  536. /test-coverage → 验证 80%+ 覆盖率
  537. ```
  538. ---
  539. ## ❓ 常见问题 (FAQ)
  540. <details>
  541. <summary><b>如何检查安装了哪些智能体/命令?</b></summary>
  542. ```bash
  543. /plugin list everything-claude-code@everything-claude-code
  544. ```
  545. 这将显示插件中所有可用的智能体、命令和技能。
  546. </details>
  547. <details>
  548. <summary><b>我的钩子 (Hooks) 没生效 / 我看到了 "Duplicate hooks file" 错误</b></summary>
  549. 这是最常见的问题。**请勿在 `.claude-plugin/plugin.json` 中添加 `"hooks"` 字段。** Claude Code v2.1+ 会自动从已安装的插件中加载 `hooks/hooks.json`。显式声明会导致重复检测错误。参见 [#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)。
  550. </details>
  551. <details>
  552. <summary><b>我的上下文窗口正在缩小 / Claude 耗尽了上下文</b></summary>
  553. 过多的 MCP 服务器会消耗你的上下文。每个 MCP 工具描述都会从你 200k 的窗口中消耗令牌,可能会将其减少到 ~70k。
  554. **解决方法:** 按项目禁用不使用的 MCP:
  555. ```json
  556. // 在项目的 .claude/settings.json 中
  557. {
  558. "disabledMcpServers": ["supabase", "railway", "vercel"]
  559. }
  560. ```
  561. 保持启用少于 10 个 MCP,且活动工具少于 80 个。
  562. </details>
  563. <details>
  564. <summary><b>我能只使用部分组件吗(例如只用智能体)?</b></summary>
  565. 可以。使用选项 2(手动安装)并仅复制你需要的部分:
  566. ```bash
  567. # 仅智能体
  568. cp everything-claude-code/agents/*.md ~/.claude/agents/
  569. # 仅规则
  570. cp -r everything-claude-code/rules/common/* ~/.claude/rules/
  571. ```
  572. 每个组件都是完全独立的。
  573. </details>
  574. <details>
  575. <summary><b>这是否适用于 Cursor / OpenCode / Codex?</b></summary>
  576. 是的。ECC 是跨平台的:
  577. - **Cursor**: 预翻译的配置位于 `.cursor/`。参见 [Cursor IDE 支持](#cursor-ide-支持)。
  578. - **OpenCode**: 完整的插件支持位于 `.opencode/`。参见 [OpenCode 支持](#-opencode-支持)。
  579. - **Codex**: 具有适配器偏移保护和 SessionStart 降级的一流支持。参见 PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257)。
  580. - **Claude Code**: 原生支持 —— 这是主要目标。
  581. </details>
  582. <details>
  583. <summary><b>如何贡献新的技能或智能体?</b></summary>
  584. 参见 [CONTRIBUTING.md](CONTRIBUTING.md)。简短版本:
  585. 1. Fork 本仓库
  586. 2. 在 `skills/your-skill-name/SKILL.md`(带 YAML Frontmatter)中创建你的技能
  587. 3. 或在 `agents/your-agent.md` 中创建智能体
  588. 4. 提交 PR,并清晰描述其功能及使用场景
  589. </details>
  590. ---
  591. ## 🧪 运行测试 (Running Tests)
  592. 插件包含一个全面的测试套件:
  593. ```bash
  594. # 运行所有测试
  595. node tests/run-all.js
  596. # 运行单个测试文件
  597. node tests/lib/utils.test.js
  598. node tests/lib/package-manager.test.js
  599. node tests/hooks/hooks.test.js
  600. ```
  601. ---
  602. ## 🤝 贡献 (Contributing)
  603. **欢迎并鼓励各类贡献。**
  604. 本仓库旨在成为社区资源。如果你有:
  605. - 有用的智能体 (Agents) 或技能 (Skills)
  606. - 巧妙的钩子 (Hooks)
  607. - 更好的 MCP 配置
  608. - 改进的规则 (Rules)
  609. 请贡献出来!准则请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
  610. ### 贡献想法
  611. - 特定语言技能(Rust, C#, Swift, Kotlin)—— 已包含 Go, Python, Java
  612. - 特定框架配置(Rails, Laravel, FastAPI, NestJS)—— 已包含 Django, Spring Boot
  613. - DevOps 智能体(Kubernetes, Terraform, AWS, Docker)
  614. - 测试策略(不同框架、视觉回归)
  615. - 特定领域知识(机器学习、数据工程、移动端)
  616. ---
  617. ## Cursor IDE 支持 (Cursor IDE Support)
  618. ECC 提供了**完整的 Cursor IDE 支持**,包含适配 Cursor 原生格式的钩子、规则、智能体、技能、命令和 MCP 配置。
  619. ### 快速开始 (Cursor)
  620. ```bash
  621. # 为你的语言安装
  622. ./install.sh --target cursor typescript
  623. ./install.sh --target cursor python golang swift
  624. ```
  625. ### 包含内容
  626. | 组件 | 数量 | 详情 |
  627. |-----------|-------|---------|
  628. | 钩子事件 | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt, 以及另外 10 个 |
  629. | 钩子脚本 | 16 | 极简 Node.js 脚本,通过共享适配器委派给 `scripts/hooks/` |
  630. | 规则 (Rules) | 29 | 9 条通用规则 (alwaysApply) + 20 条语言特定规则 (TypeScript, Python, Go, Swift) |
  631. | 智能体 (Agents) | 共享 | 通过根目录的 AGENTS.md(被 Cursor 原生读取) |
  632. | 技能 (Skills) | 共享 + 打包 | 通过根目录的 AGENTS.md 以及 `.cursor/skills/` 中翻译的补充内容 |
  633. | 命令 (Commands) | 共享 | 如果安装,位于 `.cursor/commands/` |
  634. | MCP 配置 | 共享 | 如果安装,位于 `.cursor/mcp.json` |
  635. ### 钩子架构(DRY 适配器模式)
  636. Cursor 拥有的**钩子事件比 Claude Code 更多**(20 个 vs 8 个)。`.cursor/hooks/adapter.js` 模块将 Cursor 的 stdin JSON 转换为 Claude Code 的格式,从而允许重用现有的 `scripts/hooks/*.js` 而无需重复。
  637. ```
  638. Cursor stdin JSON → adapter.js → 转换 → scripts/hooks/*.js
  639. (与 Claude Code 共享)
  640. ```
  641. 关键钩子:
  642. - **beforeShellExecution** —— 阻止 tmux 之外的开发服务器运行 (exit 2),审查 git push
  643. - **afterFileEdit** —— 自动格式化 + TypeScript 检查 + console.log 警告
  644. - **beforeSubmitPrompt** —— 在提示词中检测密钥(sk-, ghp_, AKIA 等模式)
  645. - **beforeTabFileRead** —— 阻止 Tab 读取 .env, .key, .pem 文件 (exit 2)
  646. - **beforeMCPExecution / afterMCPExecution** —— MCP 审计日志记录
  647. ### 规则格式 (Rules Format)
  648. Cursor 规则使用带有 `description`, `globs` 和 `alwaysApply` 的 YAML Frontmatter:
  649. ```yaml
  650. ---
  651. description: "扩展通用规则的 TypeScript 编码风格"
  652. globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
  653. alwaysApply: false
  654. ---
  655. ```
  656. ---
  657. ## Codex CLI 支持 (Codex CLI Support)
  658. ECC 提供了**一流的 Codex CLI 支持**,包含参考配置、Codex 特定的 AGENTS.md 补充以及 16 个移植的技能。
  659. ### 快速开始 (Codex)
  660. ```bash
  661. # 将参考配置复制到你的用户目录
  662. cp .codex/config.toml ~/.codex/config.toml
  663. # 在仓库中运行 Codex —— 将自动检测 AGENTS.md
  664. codex
  665. ```
  666. ### 包含内容
  667. | 组件 | 数量 | 详情 |
  668. |-----------|-------|---------|
  669. | 配置 | 1 | `.codex/config.toml` —— 模型、权限、MCP 服务器、持久化指令 |
  670. | AGENTS.md | 2 | 根目录(通用)+ `.codex/AGENTS.md`(Codex 特定补充) |
  671. | 技能 (Skills) | 16 | `.agents/skills/` —— 每个技能包含 SKILL.md + agents/openai.yaml |
  672. | MCP 服务器 | 4 | GitHub, Context7, Memory, Sequential Thinking (基于命令) |
  673. | 配置文件 (Profiles) | 2 | `strict`(只读沙箱)和 `yolo`(全自动确认) |
  674. ### 技能 (Skills)
  675. `.agents/skills/` 下的技能会被 Codex 自动加载:
  676. | 技能 | 描述 |
  677. |-------|-------------|
  678. | tdd-workflow | 80%+ 覆盖率的测试驱动开发 |
  679. | security-review | 全面的安全自查表 |
  680. | coding-standards | 通用编码标准 |
  681. | frontend-patterns | React/Next.js 模式 |
  682. | frontend-slides | HTML 幻灯片、PPTX 转换、视觉风格探索 |
  683. | article-writing | 基于笔记和语音参考的长文写作 |
  684. | content-engine | 平台原生的社交内容与重用 |
  685. | market-research | 带源码引用的市场与竞对研究 |
  686. | investor-materials | 商业计划书、备忘录、模型和一页纸介绍 |
  687. | investor-outreach | 个性化对接、后续跟进和介绍短文 |
  688. | backend-patterns | API 设计、数据库、缓存 |
  689. | e2e-testing | Playwright E2E 测试 |
  690. | eval-harness | 评测驱动开发 |
  691. | strategic-compact | 上下文管理 |
  692. | api-design | REST API 设计模式 |
  693. | verification-loop | 构建、测试、lint、类型检查、安全 |
  694. ### 关键限制
  695. Codex CLI **目前尚不支持钩子** (OpenAI Codex Issue #2109, 430+ 赞)。安全强制执行是通过 config.toml 中的 `persistent_instructions` 以及沙箱权限系统基于指令实现的。
  696. ---
  697. ## 🔌 OpenCode 支持 (OpenCode Support)
  698. ECC 提供了**完整的 OpenCode 支持**,包括插件和钩子 (Hooks)。
  699. ### 快速开始
  700. ```bash
  701. # 安装 OpenCode
  702. npm install -g opencode
  703. # 在仓库根目录运行
  704. opencode
  705. ```
  706. 配置将自动从 `.opencode/opencode.json` 检测。
  707. ### 功能对齐 (Feature Parity)
  708. | 功能 | Claude Code | OpenCode | 状态 |
  709. |---------|-------------|----------|--------|
  710. | 智能体 (Agents) | ✅ 13 个 | ✅ 12 个 | **Claude Code 领先** |
  711. | 命令 (Commands) | ✅ 33 个 | ✅ 24 个 | **Claude Code 领先** |
  712. | 技能 (Skills) | ✅ 50+ 个 | ✅ 37 个 | **Claude Code 领先** |
  713. | 钩子 (Hooks) | ✅ 8 种事件类型 | ✅ 11 个事件 | **OpenCode 更多!** |
  714. | 规则 (Rules) | ✅ 29 条规则 | ✅ 13 条指令 | **Claude Code 领先** |
  715. | MCP 服务器 | ✅ 14 个 | ✅ 完整支持 | **功能持平** |
  716. | 自定义工具 | ✅ 通过钩子实现 | ✅ 6 个原生工具 | **OpenCode 更好** |
  717. ### 通过插件支持钩子
  718. OpenCode 的插件系统比 Claude Code 更复杂,拥有 20 多种事件类型:
  719. | Claude Code 钩子 | OpenCode 插件事件 |
  720. |-----------------|----------------------|
  721. | PreToolUse | `tool.execute.before` |
  722. | PostToolUse | `tool.execute.after` |
  723. | Stop | `session.idle` |
  724. | SessionStart | `session.created` |
  725. | SessionEnd | `session.deleted` |
  726. **额外的 OpenCode 事件**:`file.edited`, `file.watcher.updated`, `message.updated`, `lsp.client.diagnostics`, `tui.toast.show` 等。
  727. ### 可用命令 (32 个)
  728. | 命令 | 描述 |
  729. |---------|-------------|
  730. | `/plan` | 创建实现计划 |
  731. | `/tdd` | 强制执行 TDD 工作流 |
  732. | `/code-review` | 审查代码变更 |
  733. | `/build-fix` | 修复构建错误 |
  734. | `/e2e` | 生成 E2E 测试 |
  735. | `/refactor-clean` | 移除废弃代码 |
  736. | `/orchestrate` | 多智能体工作流 |
  737. | `/learn` | 从会话中提取模式 |
  738. | `/checkpoint` | 保存验证状态 |
  739. | `/verify` | 运行验证循环 |
  740. | `/eval` | 根据准则评测 |
  741. | `/update-docs` | 更新文档 |
  742. | `/update-codemaps` | 更新代码映射 (codemaps) |
  743. | `/test-coverage` | 分析覆盖率 |
  744. | `/go-review` | Go 代码审查 |
  745. | `/go-test` | Go TDD 工作流 |
  746. | `/go-build` | 修复 Go 构建错误 |
  747. | `/python-review` | Python 代码审查 (PEP 8, 类型提示, 安全) |
  748. | `/multi-plan` | 多模型协同规划 |
  749. | `/multi-execute` | 多模型协同执行 |
  750. | `/multi-backend` | 侧重后端的多模型工作流 |
  751. | `/multi-frontend` | 侧重前端的多模型工作流 |
  752. | `/multi-workflow` | 全面的多模型开发工作流 |
  753. | `/pm2` | 自动生成 PM2 服务命令 |
  754. | `/sessions` | 管理会话历史 |
  755. | `/skill-create` | 从 git 生成技能 |
  756. | `/instinct-status` | 查看已学本能 (instincts) |
  757. | `/instinct-import` | 导入本能 |
  758. | `/instinct-export` | 导出本能 |
  759. | `/evolve` | 将本能聚类为技能 |
  760. | `/promote` | 将项目本能提升至全局范围 |
  761. | `/projects` | 列出已知项目及本能统计 |
  762. | `/learn-eval` | 在保存前提取并评测模式 |
  763. | `/setup-pm` | 配置包管理器 |
  764. ### 插件安装
  765. **选项 1:直接使用**
  766. ```bash
  767. cd everything-claude-code
  768. opencode
  769. ```
  770. **选项 2:作为 npm 包安装**
  771. ```bash
  772. npm install ecc-universal
  773. ```
  774. 然后添加到你的 `opencode.json`:
  775. ```json
  776. {
  777. "plugin": ["ecc-universal"]
  778. }
  779. ```
  780. ### 文档
  781. - **迁移指南**: `.opencode/MIGRATION.md`
  782. - **OpenCode 插件 README**: `.opencode/README.md`
  783. - **整合规则**: `.opencode/instructions/INSTRUCTIONS.md`
  784. - **LLM 文档**: `llms.txt`(为 LLM 提供的完整 OpenCode 文档)
  785. ---
  786. ## 跨工具功能对齐 (Cross-Tool Feature Parity)
  787. ECC 是**首个最大化利用各大主要 AI 编程工具的插件**。以下是各框架的对比:
  788. | 功能 | Claude Code | Cursor IDE | Codex CLI | OpenCode |
  789. |---------|------------|------------|-----------|----------|
  790. | **智能体 (Agents)** | 13 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |
  791. | **命令 (Commands)** | 33 | 共享 | 基于指令 | 24 |
  792. | **技能 (Skills)** | 50+ | 共享 | 10 (原生格式) | 37 |
  793. | **钩子事件** | 8 种类型 | 15 种类型 | 尚无 | 11 种类型 |
  794. | **钩子脚本** | 9 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 |
  795. | **规则 (Rules)** | 29 (通用+语言) | 29 (YAML Frontmatter) | 基于指令 | 13 条指令 |
  796. | **自定义工具** | 通过钩子实现 | 通过钩子实现 | N/A | 6 个原生工具 |
  797. | **MCP 服务器** | 14 | 共享 (mcp.json) | 4 (基于命令) | 完整支持 |
  798. | **配置格式** | settings.json | hooks.json + rules/ | config.toml | opencode.json |
  799. | **上下文文件** | CLAUDE.md + AGENTS.md | AGENTS.md | AGENTS.md | AGENTS.md |
  800. | **密钥检测** | 基于钩子 | beforeSubmitPrompt 钩子 | 基于沙箱 | 基于钩子 |
  801. | **自动格式化** | PostToolUse 钩子 | afterFileEdit 钩子 | N/A | file.edited 钩子 |
  802. | **版本** | 插件 | 插件 | 参考配置 | 1.6.0 |
  803. **关键架构决策:**
  804. - 根目录下的 **AGENTS.md** 是通用的跨工具文件(被所有 4 种工具读取)
  805. - **DRY 适配器模式** 让 Cursor 能够重用 Claude Code 的钩子脚本而无需重复
  806. - **技能格式**(带 YAML Frontmatter 的 SKILL.md)可跨 Claude Code, Codex 和 OpenCode 使用
  807. - Codex 缺乏钩子的弱点通过 `persistent_instructions` 和沙箱权限得到了弥补
  808. ---
  809. ## 📖 背景 (Background)
  810. 我从实验性发布阶段就开始使用 Claude Code。在 2025 年 9 月与 [@DRodriguezFX](https://x.com/DRodriguezFX) 一起,完全使用 Claude Code 开发了 [zenith.chat](https://zenith.chat),并赢得了 Anthropic x Forum Ventures 黑客松。
  811. 这些配置在多个生产级应用中经过了实战测试。
  812. ---
  813. ## 令牌(Token)优化
  814. 如果你不管理令牌消耗,使用 Claude Code 可能会很昂贵。以下设置可以在不牺牲质量的前提下显著降低成本。
  815. ### 推荐设置
  816. 添加到 `~/.claude/settings.json`:
  817. ```json
  818. {
  819. "model": "sonnet",
  820. "env": {
  821. "MAX_THINKING_TOKENS": "10000",
  822. "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  823. }
  824. }
  825. ```
  826. | 设置 | 默认值 | 推荐值 | 影响 |
  827. |---------|---------|-------------|--------|
  828. | `model` | opus | **sonnet** | 约 60% 成本降低;可处理 80%+ 的编程任务 |
  829. | `MAX_THINKING_TOKENS` | 31,999 | **10,000** | 每次请求的隐藏思考成本降低约 70% |
  830. | `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 95 | **50** | 更早进行压缩 —— 在长会话中保持更好质量 |
  831. 仅在需要深度架构推理时切换到 Opus:
  832. ```
  833. /model opus
  834. ```
  835. ### 日常工作流命令
  836. | 命令 | 何时使用 |
  837. |---------|-------------|
  838. | `/model sonnet` | 大多数任务的默认选择 |
  839. | `/model opus` | 复杂架构、调试、深度推理 |
  840. | `/clear` | 在无关任务之间(免费、即时重置) |
  841. | `/compact` | 在逻辑任务断点(研究完成、里程碑达成) |
  842. | `/cost` | 监控会话期间的令牌支出 |
  843. ### 策略性压缩 (Strategic Compaction)
  844. 本插件包含的 `strategic-compact` 技能建议在逻辑断点处执行 `/compact`,而不是依赖 95% 上下文时的自动压缩。完整决策指南请参见 `skills/strategic-compact/SKILL.md`。
  845. **何时进行压缩:**
  846. - 研究/探索后,实现代码前
  847. - 完成一个里程碑后,开始下一个前
  848. - 调试完成后,继续功能开发前
  849. - 方案失败后,尝试新方案前
  850. **何时不要压缩:**
  851. - 实现过程中(你会丢失变量名、文件路径、部分状态)
  852. ### 上下文窗口管理
  853. **至关重要:** 不要一次性启用所有 MCP。每个 MCP 工具描述都会从你 200k 的窗口中消耗令牌,可能会将其减少到 ~70k。
  854. - 每个项目保持启用少于 10 个 MCP
  855. - 保持活动工具少于 80 个
  856. - 在项目配置中使用 `disabledMcpServers` 来禁用不使用的服务
  857. ### 智能体团队 (Agent Teams) 成本警告
  858. 智能体团队会产生多个上下文窗口。每个团队成员独立消耗令牌。仅在并行化能带来明显价值的任务中使用(多模块工作、并行审查)。对于简单的顺序任务,子智能体 (Subagents) 更节省令牌。
  859. ---
  860. ## ⚠️ 重要注意事项
  861. ### 令牌(Token)优化
  862. 达到每日限额了?请参阅 **[令牌优化指南](docs/token-optimization.md)** 以获取推荐设置和工作流建议。
  863. 快速见效方案:
  864. ```json
  865. // ~/.claude/settings.json
  866. {
  867. "model": "sonnet",
  868. "env": {
  869. "MAX_THINKING_TOKENS": "10000",
  870. "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
  871. "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  872. }
  873. }
  874. ```
  875. 在无关任务间使用 `/clear`,在逻辑断点使用 `/compact`,并使用 `/cost` 监控支出。
  876. ### 自定义
  877. 这些配置适用于我的工作流。你应该:
  878. 1. 从产生共鸣的部分开始
  879. 2. 根据你的技术栈进行修改
  880. 3. 移除不使用的部分
  881. 4. 添加你自己的模式
  882. ---
  883. ## 💜 赞助者 (Sponsors)
  884. 本项目免费且开源。赞助者的支持有助于维持其维护和成长。
  885. [**成为赞助者**](https://github.com/sponsors/affaan-m) | [赞助等级](SPONSORS.md)
  886. ---
  887. ## 🌟 星标历史 (Star History)
  888. [![星标历史图表](https://api.star-history.com/svg?repos=affaan-m/everything-claude-code&type=Date)](https://star-history.com/#affaan-m/everything-claude-code&Date)
  889. ---
  890. ## 🔗 链接 (Links)
  891. - **简明指南(从这里开始):** [Everything Claude Code 简明指南](https://x.com/affaanmustafa/status/2012378465664745795)
  892. - **详细指南(高级):** [Everything Claude Code 详细指南](https://x.com/affaanmustafa/status/2014040193557471352)
  893. - **关注:** [@affaanmustafa](https://x.com/affaanmustafa)
  894. - **zenith.chat:** [zenith.chat](https://zenith.chat)
  895. - **技能目录:** awesome-agent-skills(社区维护的智能体技能目录)
  896. ---
  897. ## 📄 许可证 (License)
  898. MIT - 自由使用,根据需要修改,如果可以请回馈贡献。
  899. ---
  900. **如果本项目对你有帮助,请点亮 Star。阅读两份指南。构建伟大的产品。**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.