263,725 颗星、292 个 Skill:ECC 想把 AI 编程 Agent 的“马具”做成一套可基准测试的工程系统
如果你最近在刷 GitHub Trending,大概率见过一个叫 ECC 的仓库。263,725 颗星、39,454 个 Fork、单日新增 700+ star,这个由独立开发者 Affaan Mustafa 维护的项目,已经是 GitHub 上星标最高的 Claude Code 相关配置系统。但把它简单理解成”又一个 Prompt 合集”就错了——它真正想解决的,是 AI 编程里一个被长期忽视的工程问题。
问题不在模型,在”马具”
ECC 全称 Everything Claude Code,作者自己的定位是 “agent harness performance optimization system”(智能体马具性能优化系统)。
这句话有点绕,翻译成人话:决定 AI 编程质量的,早就不只是底层模型有多强,而是你给它套了一套什么样的”马具”——它该怎么规划、什么时候该先搜索代码库、写完要不要自测、怎么记住上次踩过的坑。同一个模型,马具设计得当,token 消耗和返工率能差出一大截。
ECC 的作者是从真实痛点反推出来的。他参加过一场 Anthropic 黑客松,8 小时交付了一个完整产品,全程没手敲一行代码,拿了约 1.5 万美元的平台额度。后面的故事更关键:他把打磨了十个多月的整套工作系统直接开源了,MIT 协议,就是现在的 ECC。
项目地址:https://github.com/affaan-m/ECC
它到底装了什么
按官方仓库当前的清点,ECC 2.2 版本打包了:
- 68 个 Agent:规划、代码审查、构建修复、安全、架构等专门角色
- 292 个 Skill:TDD、研究、安全、文档、前端、数据、ML、运维等按需加载
- 94 个命令:作为过渡期的便捷入口,整体正在向 skills-first 迁移
- Hooks 与记忆层:运行时行为约束、会话摘要、持续学习、跨会话本能
- AgentShield 安全扫描:覆盖 CLAUDE.md、MCP 配置、钩子、技能、权限、密钥的 1,282 项安全测试
核心工作流是一条闭环:plan → test → implement → review → verify → remember → improve。它强调”编辑前先研究”(research before edits),用持续的测试验证替换掉不可靠的假设,并且把每次成功的经验沉淀成可复用的 skill。作者在文档里的原话是:”优化上下文窗口,其余全部持久化。”
安装门槛
官方推荐的引导式安装只需要一行:
npx ecc-universal@2.2.2 setup
环境要求不高,但有限制:Node.js 18+,Claude Code 插件方式还需要 Git 和 Claude Code 2.1+。pnpm、Yarn 2+、Bun 也有对应的一键命令,文档里写得很清楚。
需要留意的是官方反复强调的一点:只从验证过的渠道安装——GitHub 仓库、npm 包 ecc-universal 和 ecc-agentshield、GitHub App ecc-tools、插件名 ecc@ecc、官网 ecc.tools。第三方转载和镜像不受维护,可能有恶意代码。这是很实在的提醒,因为这类”配置全家桶”太容易被二次打包塞私货了。
真实边界:它不是万能的
这里必须泼点冷水,几个容易被营销话术盖住的边界:
第一,Claude Code 的体验最好,其他框架是”能力受限的适配层”。 README 里明确给了 support status matrix:Codex 有受支持的同步路径,而 Cursor、OpenCode、Gemini、Zed、GitHub Copilot、Antigravity、Qwen 等只是能力有限的 adapter。别默认所有 harness 功能对齐。
第二,指令本身有开销。 社区评测文章(如 dev.to 上 “Why affaan-m/ECC Is Gaining Attention Among Agent Harness Engineers”)提到一个真实权衡:技能包越大,占用的上下文越多,反而可能增加延迟。正确做法不是无脑全装,而是先挑能解决你具体失败模式的 skill——比如测试生成不稳定、agent 乱跑 shell、代码审查前后不一致——然后对比 baseline 和 ECC 启用前后的 wall-clock、工具调用次数、token 用量、测试通过率。
第三,规则冲突风险。 你项目里已有的 CLAUDE.md 指令可能和 ECC 的约定打架,尤其是破坏性命令和安全检查的优先级,必须显式定义。好在 ECC 2.2.1 这个安全补丁系列就是在收紧这块:GateGuard 现在能识别 PowerShell 的破坏性命令,相对路径豁免不能逃出项目根目录,卸载尊重 ECC_DRY_RUN=1,安装器不再覆盖用户自己的未跟踪文件。
第四,商业边界清晰但存在。 OSS 永久 MIT 免费,但私有仓库要用托管的 GitHub App,ECC Pro 是 $19/seat/月。一个人维护、每周跨 7 个 harness 发版,商业化是合理选择,但你得知道自己哪天会碰到付费墙。
适合谁,不适合谁
适合:重度使用 Claude Code 的个人开发者和小团队;想把”资深工程师的直觉和框架约束”固化下来、让多个 agent 行为可预测的团队;愿意花时间做 A/B 对比、把 agent 配置当成性能系统来调的人。
不适合:只想找一份轻量 prompt 模板的人(这个太重了);完全不用 Claude Code 的人;期待装上就自动变强、不愿读文档调优先级的人。
下一步建议
如果你决定试,我建议这样走:
- 先读作者的三份指南(精简版、详细版、安全版,X 上都能找到),别跳过精简版的”设置与理念”。
- 用
git clone拉一份代码到本地仓库,先find . -maxdepth 2 -type f | sort看看结构,别急着往生产配置里灌。 - 只挑 2-3 个针对你真实痛点的 skill 先跑,记录 baseline 的 token 与延迟数据。
- 跑一轮
ecc-universal doctor和 AgentShield 扫描,确认没有和现有配置冲突。 - 稳定后再逐步扩展,把”哪些规则真正改善了结果”沉淀成你自己的项目文档。
ECC 最有价值的其实不是那 292 个 skill,而是它提出的一个框架:agent 配置应该像其他性能关键系统一样被基准测试,而不是当成一堆没人验证的 prompt 堆着。 这一点,比任何具体功能都值得带走。
评论区
登录后可评论。