ECC：185k 星的 Claude Code 调教手册，到底在卷什么

发表于 分类于
Everything Claude Code（ECC）GitHub 18.5 万星，v2.0 引入 Hermes operator，把 Claude Code/Codex/Cursor 装进一个统一 harness。

ECC：185k 星的 Claude Code 调教手册，到底在卷什么

早上刷 GitHub Trending，首页第三个就是 affaan-m/ecc，单日 2141 星，总数已经 18.5 万。点进去看了一眼它的 README，第一句话就写着「The agent harness performance optimization system」。

我心里一咯噔：又卷新词了？等真读完 v2.0.0-rc.1 的 release notes 和 Hermes setup 文档，发现这个项目不是在造新概念，是把「怎么让 Claude Code 真的好用」这件事做成了一套可装可拆的开源工作流。我作为常年靠 Claude Code 写代码的人，必须得写一篇。

ECC 是什么

它不是一个新的 AI agent，而是一个配置 + 技能 + 习惯的合集，由 Affaan Mustafa 维护。这位老哥在 Anthropic x Forum Ventures NYC 黑客松上拿过奖，用 Claude Code 8 小时搭出了 zenith.chat，拿到 1.5 万美金的 API credits。后来他把这套配置开源成 ECC，X 上那篇「The Shorthand Guide」几天内被看了 90 多万次，10k+ 收藏。

到今天，ECC 仓库里塞了：

  • 63 个 subagent（planner、architect、code-reviewer、build-error-resolver、tdd-guide、e2e-runner…）
  • 249 个 skill（backend-patterns、frontend-patterns、mcp-server-patterns、article-writing…）
  • 79 个 legacy command shim
  • 一套跨平台的 hook runtime
  • 一个叫 NanoClaw v2 的内置编排引擎
  • 997 个内部测试
  • 170+ 贡献者
  • MIT 协议

一句话总结：它把「怎么让 Claude Code 写好代码」这件事从「每个人自己拍脑袋写 CLAUDE.md」变成了一套可复制的工程方法。

它解决的问题

我自己用 Claude Code 一年多，踩过的坑是：跑同样的 prompt，模型的能力发挥得看 prompt 写得多细、上下文塞得多干净。CLAUDE.md 写好能顶一半，但「好」是个模糊词。

ECC 的思路是：

  1. 把常见的代码场景（planner、code-reviewer、tdd-guide、build-error-resolver）拆成专用 subagent prompt
  2. 把高频工作流（commit、review、refactor、security-scan）做成 slash command
  3. 把跨项目的领域知识（backend-patterns、frontend-patterns、mcp-server-patterns）做成 skill
  4. 用 hook 串起来：PreToolUse 校验、Bash 沙箱、PostToolUse 跑测试
  5. 在所有这些之上，加一个 model router（NanoClaw v2），自动给不同任务挑不同模型

我看到 code-reviewer 的 prompt 写得是真讲究：confidence > 80% 才报，相似问题合并，安全漏洞优先。光这一份 prompt 抄出来，就能把我自己 review 代码的体感拉高一档。

v2.0.0-rc.1 的 Hermes 故事

v2.0.0-rc.1 是 4 月发的，重点是把 ** 操作员层（operator layer）** 公开了。文档里画了这么一张图：

1
2
3
4
5
6
7
Telegram / CLI / TUI
        ↓
      Hermes
        ↓
ECC skills + hooks + MCPs + generated workflow packs
        ↓
Google Drive / GitHub / browser automation / research APIs / media tools / finance tools

Hermes 是 operator shell，ECC 是 reusable system。翻译成大白话：

  • ECC 提供「能干活的零件」（skills、hooks、agents、commands）
  • Hermes 提供「统一的前门」（一个入口，能从 Telegram、CLI、TUI 进来）
  • 零件按 operator 的工作流（内容、外联、研究、销售、账务、工程）打包成 workflow packs

这套架构对经常切换设备的人特别友好。我经常在多台设备之间切换，设备换得勤，入口越统一越好。从 Telegram 一条命令触发「抓 GitHub trending → 选项目 → 写文章 → git push」这种流程，正是 ECC + Hermes 设计的场景。

三种安装姿势

仓库里给了三种安装方式，选一个，别叠。叠装会触发 duplicate hook 错误（这是 GitHub Issue #29、#52、#103 反复出现的坑）。

1. 插件安装（推荐）

1
2
/plugin marketplace add affaan-m/ecc
/plugin install everything-claude-code@ecc

2. 一键脚本

1
2
3
./install.sh --profile full
# 或者
npx ecc-install --profile full

3. 最小手工配置

如果你不想用 plugin，只想要 rules、agents、commands 和核心 skill，跳过 plugin 用 minimal manual profile。它故意不装 hooks-runtime，避免上面说的冲突。

Hook 运行时控制（v1.8.0 起）

ECC 早期版本最常被吐槽的就是 hooks 装上之后改不掉。1.8.0 加了运行时控制：

1
2
export ECC_HOOK_PROFILE=minimal     # minimal | standard | strict
export ECC_DISABLED_HOOKS=foo,bar    # 按 ID 关掉指定 hook

之前要改 hooks.json 直接编辑，改完一次以后每次 git pull 都打架。现在用环境变量切，对常驻脚本（比如我这种 cron 任务）友好太多。

跨平台：一个 repo 装四套

同一个仓库提供四套配置：

  • Claude Code → 通过 plugin system
  • Cursor → .cursor/ 目录
  • OpenCode → .opencode/ 目录
  • Codex → .codex/ + AGENTS.md

我之前在 Claude Code 上写好的 subagent prompt，现在可以无缝搬到 Codex 或 Cursor 上继续用。对工具党来说是个大杀器：不用再为每个 IDE 维护一份 prompt 库了。

三个我能直接抄的实操

1. code-reviewer subagent 的 prompt 结构

把 review 拆成三步：过滤（confidence > 80%）→ 合并（同类问题归一）→ 排序（安全 > 性能 > 风格）。我以前写的 review prompt 总是一坨塞进去，让模型自己悟。现在改成这个结构，误报少了一半。

2. build-error-resolver 套路

build 报错不要让主 agent 自己修。ECC 配了 build-error-resolver 这个专用 subagent，提示词里明确写着「minimal, surgical fixes」，只改必要的、最小范围的代码。我以前遇到一堆 npm/yarn 报错，主 agent 经常顺手「重构」我别的代码，气得要死。

3. security-scan

/security-scan 命令会调用 AgentShield 跑安全审计，把可能的 prompt injection、shell 注入、敏感信息泄露列出来。这条对在公共 WiFi 下连 VPN 干活的我来说是刚需。

三个争议也别装看不见

Reddit 上 r/ClaudeCode 和 r/ChatGPTCoding 对 ECC 的吐槽集中在三点：

  1. 过度工程化。997 个测试、多语言 rule、内置编排引擎，对绝大多数人来说一份好 CLAUDE.md 就够了。我同意，但「好 CLAUDE.md」的标准谁来定？ECC 至少给了一个 reference 实现。
  2. Plugin 不能分发 rules。agents/skills/hooks/commands 都能装，rules 不行，得手动复制到 .claude/rules/。这破坏了「装一次拿全部」的承诺，作者自己承认。
  3. 星数注水质疑。18 万星对 Claude Code 配置类项目来说太夸张；Discussions 几乎不动，但 Issues 每天在开。我倾向于看活跃度而不是星数：997 个 CI 测试、170+ 贡献者、4 月还在发 v2.0.0-rc.1，说明项目真在维护。

我自己准备怎么用

我不打算全装 ECC，工具链要轻。我会挑三样抄过来：

  1. code-reviewer /build-error-resolver/tdd-guide 这三个 subagent 的 prompt 骨架。我之前自己写的 prompt 比起 ECC 的差在结构化。
  2. hook 套路：PreToolUse 校验 bash 命令、PostToolUse 自动跑 lint。我现在 90% 的 lint 漏跑就是因为没有 hook 强制。
  3. slash command 模板：把高频操作（commit、refactor、security-scan）固化下来。/commit 这种命令我早就在用，但 ECC 的版本更细。

装 ECC 全家桶我持保留意见，这玩意一旦钩子出错，整个工作流会卡住。等我把 Hermes 那一层也摸熟，再回来写一篇「如何跨多台电脑同步 ECC 工作流」。

相关阅读

项目地址：github.com/affaan-m/ecc
v2.0.0-rc.1 发布日期：2026 年 4 月
协议：MIT
多设备友好度：⭐⭐⭐⭐（装全量大，挑着用收益最大）