速览
- 「Everything Claude Code」是 Affaan Mustafa 维护的 Claude Code 配置合集——agents、skills、commands、rules、hooks 与 MCP 配置。它不是 Anthropic 的产品。
- 仓库已改名:github.com/affaan-m/everything-claude-code 现在 301 跳转到 affaan-m/ECC,插件标识是 ecc@ecc,不再是 everything-claude-code@everything-claude-code。
- 在 commit d2ef2680(2026-11-06)的目录树里:71 个 agent、314 个 SKILL.md 目录、98 个命令文件、22 套规则包、68 个脚本、8 类 hook 事件。
- 每个 harness 只装一次——要么用引导向导(npx ecc-universal@2.2.3 setup),要么用原生 /plugin 命令。两种叠加正是 README 写明的 skill 重复、hook 触发两次的原因。
仓库状态核对于 2026-11-12:GitHub 上 301,569 star,最新 release v2.2.3 发布于 2026-10-01,最新 commit d2ef2680(2026-11-06)。star 数每天都在变,按快照理解。本页的目录计数、版本号和安装命令取自仓库目录树与 manifest,不是从博客转述的。
这个合集到底是什么
它是一个插件,不是模型,也不是 Claude Code 的分支。仓库里是 `.claude-plugin/` 清单加五类纯文本资产——子 agent 定义、skills、斜杠命令、规则文件和 hook 脚本——由 Claude Code 从你的配置目录加载。
项目自称是「Anthropic 黑客松获胜者的配置」:作者 2025 年 9 月赢了 Anthropic x Forum Ventures 黑客松,并说这些配置来自日常使用。它采用 MIT 协议,属于第三方、社区维护的项目,Anthropic 既不发布也不审核它。
从 2.x 起,同一份根目录还通过 `.codex/`、`.opencode/`、`.cursor/` 等适配目录映射到别的 harness——Codex、OpenCode、Cursor、Gemini CLI、Copilot CLI、Qwen、Kimi Code 等。各 harness 的功能并不对等,README 里专门留了一张支持矩阵。
- 版本
- v2.2.3 · 2026-10-01
- 最新 commit
- d2ef2680
- 许可证
- MIT
- star(快照)
- 301,569
仓库里有什么
下表计数取自 commit d2ef2680 的仓库目录树(6,449 个条目,未截断),而不是 README 的汇总表。目录名就是 Claude Code 用来匹配的标识符,所以保持原文不译。
| 目录 | 条目数 | 内容 |
|---|---|---|
agents/ | 71 | 带 frontmatter 的 markdown 子 agent 定义:planner、architect、code-reviewer、security-reviewer,各语言 reviewer(Go、Python、Rust、Java、Kotlin、TypeScript、Ruby、F#),以及各语言的构建错误修复 agent。 |
skills/ | 314 | 一个 skill 一个目录,每个都有 SKILL.md:TDD 流程、安全审查、验证循环、eval harness、策略性压缩、各语言与框架的写法,还有 ML、数据、运维等领域的 skill。 |
commands/ | 98 | 斜杠命令文件。项目正在转向以 skills 为主,所以这些被描述为「维护中的兼容入口」,而不是主要入口。 |
rules/ | 22 | 始终加载的规范,分成 `common/`(与语言无关)和每种技术栈一个目录——typescript、python、golang、rust、java、kotlin、swift、php、csharp、cpp、ruby、perl、react、react-native、vue、nuxt、angular、dart、fsharp、arkts、web。共 122 个 markdown 文件。 |
hooks/ | 7 | hooks.json 加上 memory-persistence 脚本。接了 8 类事件:PreToolUse(10 个 matcher)、UserPromptSubmit、PreCompact、SessionStart(2)、PostToolUse(2)、PostToolUseFailure(2)、Stop(8)、SessionEnd。 |
scripts/ | 68 | 跨平台 Node.js 工具:安装器、doctor、repair、uninstall、会话检查、memory、eval harness,以及 Codex 与 OpenCode 适配器。 |
contexts/ | 3 | dev.md、review.md、research.md——可以按会话注入的替代系统提示上下文。 |
mcp-configs/ | 1 | 一份 `mcp-servers.json`,把里面的 MCP 服务器定义替换占位密钥后复制进 `~/.claude.json`。 |
legacy-command-shims/ | 12 | 退役的短命令,留着供显式启用,比如 /tdd、/e2e、/eval、/verify、/orchestrate。每个都指向取代它的 skill。 |
规则和 skills 是刻意设计成可选的:插件安装无法分发 rules,因为 Claude Code 插件没有 rules 通道。README 因此要求你手动复制规则目录。
在 Claude Code 里怎么装
三条路径,全部照 README 原样抄录。每个 harness 选一条——README 自己的警告是:叠加两种安装方式会让 skills、命令和 hooks 重复。
路径 1——引导向导(推荐)
把 `ecc@ecc` 插件安装、更新或迁移到你选的作用域(user、project 或 local),并设置 hook 档位。需要 Node.js 18 以上,不需要克隆仓库。pnpm、Yarn 2+ 和 Bun 的等价命令是 `pnpm dlx` / `yarn dlx` / `bunx`,参数相同。
npx ecc-universal@2.2.3 setup路径 2——原生插件命令
在 Claude Code 会话里(2.1 及以上)执行。它会装上 skills、agents、commands 和插件自带的 hooks,到此为止——之后不要再跑一次完整的手动安装。
/plugin marketplace add https://github.com/affaan-m/ECC/plugin install ecc@ecc路径 3——规则,插件装不了
Claude Code 插件无法分发 rules,所以 README 让你克隆仓库后自己复制想要的包。先从 `rules/common` 加一个语言包开始;代码块里第二行 cp 就是要换成你技术栈的那行。
git clone https://github.com/affaan-m/ECC.gitcd ECCmkdir -p ~/.claude/rules/ecccp -R rules/common ~/.claude/rules/ecc/cp -R rules/typescript ~/.claude/rules/ecc/ # replace with your stack确认装好了
在 Claude Code 里 `/plugin list ecc@ecc` 应显示插件已启用,插件命令带命名空间——是 `/ecc:plan`,不是 `/plan`。如果叠加安装出现重复,README 给的解法是卸载后只装一次。
装之前需要什么
- 1PATH 里有 Claude Code 2.1 以上。README 写明最低 v2.1.0,原因是插件系统加载 hooks 的方式变了。
- 2Node.js 18 以上,供引导向导和 hook 脚本使用——脚本已改写为 Node.js,以便在 Windows、macOS、Linux 上都能跑。
- 3Git;如果打算复制规则或在启用前读 hook 脚本,还需要一份审阅过的检出。
哪些部分值得用
这个仓库是目录,不是产品,作者自己也这么说:「从打动你的开始,按你的技术栈改,用不上的删掉。」按这个标准,价值主要集中在这四块。
- 1
子 agent 定义
审查或规划角色很好评估:打开 agents/code-reviewer.md 或 agents/planner.md,读一遍提示词,再决定要不要让这种语气进你的会话。把单个文件复制到 ~/.claude/agents/ 零成本,也不需要装插件。
- 2
TDD 与验证类 skill
tdd-workflow、verification-loop、eval-harness 是作者指南围绕的工作流:它们把「先写失败的测试」和「说完成之前先验证」写成步骤,而不是建议。装之前先读——它们会改变会话怎么跑。
- 3
规则包
rules/common 是仓库里最可移植的产物:短小、始终加载,讲测试、安全、git 流程和代码风格。因为就是纯 markdown,任何读规则或记忆文件的 agent 都能用,也是最适合改成你自己团队风格的部分。
- 4
hook 运行时——挑着开
hooks 是这个合集真正能强制做事的地方:Stop 时跑格式与类型检查、PreToolUse 拦截危险 shell 命令、会话开始/结束时存记忆。它也是暴露面最大的部分,所以一个个开,先读脚本。ECC_HOOK_PROFILE(minimal / standard / strict)和 ECC_DISABLED_HOOKS 就是为这个准备的。
装之前的几个注意点
这些都是 README 和仓库结构本身能看出来的取舍,不是假想。
- 第三方、非官方。MIT 协议的社区作品,不是 Anthropic 产品。README 自己就警告:只有 GitHub 仓库、ecc-universal 与 ecc-agentshield 两个 npm 包、ecc@ecc 这个标识和 ecc.tools 是维护中的渠道,镜像站可能带恶意代码。
- 上下文成本是真实的。skills 按需加载,但始终加载的规则和 SessionStart 上下文每一轮都要付费:README 默认把 SessionStart 追加内容限制在 8,000 字符,并提供 ECC_SESSION_START_MAX_CHARS 与 ECC_SESSION_START_CONTEXT=off 来调低。同一份 README 还警告 MCP 工具开太多会把 200k 窗口压到约 70k。
- 可能和你现有的配置撞车。规则进 ~/.claude/rules/ecc/,agents 进 ~/.claude/agents/,hooks 进插件自己的 hooks.json——如果你已经有 CLAUDE.md 约定或自己的 hooks,做好「合并」而不是「照搬」的准备。
- 标识符变过。老文章里的 everything-claude-code@everything-claude-code 来自 affaan-m/everything-claude-code;现在两者都指向 affaan-m/ECC 和 ecc@ecc。README 把长写法称作旧别名。
- hooks 是可执行配置。它们会在工具事件上于你机器上跑 shell 命令。启用前读 hooks/hooks.json 和 scripts/hooks/ 下的脚本,也不要在插件安装之上把 hooks.json 再复制进 settings.json——README 明确写了那会导致 hook 重复报错。
如果只拿走一样东西
拿走规则,再加一两个 skill。这个合集的价值不在 314 个 skill 的目录——没人会审 314 个 skill——而在于那几个把你本来就认同的流程写成步骤的文件,以及那句提醒:始终加载的上下文是有代价的。其余的部分,等某次会话真的出问题再说。
