ECC：把 Claude Code / Cursor / Codex 这些 Agent 工具调到最佳状态的开源 Harness

背景

如果你在用 Claude Code、Cursor、Codex 或者 OpenCode 这一类 AI Agent 工具，大概率碰到过这种场景：

- 同样的 prompt，在 Claude Code 里它能稳定工作，换到 Cursor 里就开始乱来
- 写好的 skills / commands 散落在 .claude/、.cursor/、.codex/ 各种目录里，改一处忘了另一处
- 项目上下文靠手动复制粘贴，token 烧得飞快但效果还是一般
- 想要"研发先于写代码"的纪律，但 IDE 不帮你 enforce，写到一半又开始乱写

GitHub 上一个 6 月初还在狂涨 star 的项目 affaan-m/ECC 干的就是这件事：它不是另一个 IDE，也不是另一个 LLM，而是一套 agent harness 性能优化系统——你可以把它理解成 AI Agent 工作流的"操作系统层"。它在 GitHub 上半年时间拿下了 21 万+ star，覆盖了 Claude Code、Codex、Opencode、Cursor、Gemini、Qwen、Kiro、Codebuddy 等几乎所有主流 agent 工具。

ECC 这个名字不是"椭圆曲线加密"，在项目语境里它是 Everything Claude Code 的延伸——把 Claude Code 里那套好用的 skills / instincts / memory / security 范式，移植到所有 agent 工具上，让它们有统一一致的"性格"。

能做什么

ECC 是一个 monorepo 风格的工具集，主要包含以下几层：

1. Skills（技能）
项目自带一套精心调过的 skills，覆盖代码审查、测试、调试、重构、安全扫描等通用场景。每条 skill 都是一个可直接被 agent 加载的 prompt + 工具约定，不是写死的脚本，agent 会按上下文自行调用。

2. Instincts（直觉）
这是 ECC 比较有特色的设计——把"高级工程师的下意识判断"编码成小颗粒的规则。比如"修改公共 API 时必须先检查调用方"、"PR 标题必须包含 issue 编号"、"改动超过 200 行先拆 PR"。这些规则通过 CLAUDE.md / AGENTS.md / .cursor/rules 注入到所有支持的 IDE。

3. Memory（记忆）
ECC 提供分层记忆机制：会话级、项目级、跨项目级。agent 能跨会话记住你的代码风格、命名约定、常用模式，不用每次都重新教。

4. Security（安全）
内置 secrets 检测、危险命令拦截、敏感文件保护。agent 在执行 rm -rf、写 .env、访问 ~/.ssh 之前都会被拦下来确认。

5. Research-first Development
强调"研究先于写代码"。每个任务开始前，agent 先花一轮调研已有代码、依赖、文档，给出方案，等你确认后才动手。对应 .claude-plugin、CLAUDE.md 里的 research-mode 触发器。

6. MCP 集成
仓库自带 .mcp.json 模板，把常用的 filesystem / git / github / postgres / playwright 这些 MCP server 一键接入 Claude Code / Cursor / Codex。

为什么值得

横向对比一下 ECC 和同类方案：

| 维度 | 裸用 Claude Code | 商业 IDE 增强（Cursor Pro / Copilot Workspace） | ECC |
|------|------------------|------------------------------------------------|-----|
| 价格 | API 费 | 订阅费 $20/月起 | MIT 完全免费 |
| 多 IDE 同步 | 每家各自一套 | 只在该 IDE 里 | 8 家 IDE 共享一套规则 |
| Skills 复用 | 自己写 | 没有 | 内置 50+ 开箱即用 |
| 安全约束 | 靠 prompt 暗示 | 黑盒 | 明确拦截规则 |
| 可审计 | 看 CLAUDE.md | 看不了 | 全部 markdown，可 diff 可 PR |

最关键的是 跨 IDE 一致性。你今天在 Claude Code 里写好一套 skills + rules，明天切到 Cursor 不会失灵；公司有合规要求时，安全规则一次写好，所有 agent 工具同时生效。

另外，它是 MIT 协议，可以直接 fork 改造成自己团队的版本。对于想给团队定制 AI 编程工作流、又不想被某个商业产品绑死的团队，这种"开源操作系统"的形态比插件市场更可控。

快速上手（Docker 思路）

ECC 本质是文件 + prompt 的集合，没有独立 daemon，所以"部署"其实只有一步：把仓库克隆到本地，对应的 IDE 会自动读取 .claude/、.cursor/、.codex/ 等目录。

1. 克隆仓库到项目根目录

git clone https://github.com/affaan-m/ECC.git .ecc-tmp
cp -r .ecc-tmp/.claude ./
cp -r .ecc-tmp/.cursor ./
cp -r .ecc-tmp/.codex ./
cp -r .ecc-tmp/.opencode ./
cp -r .ecc-tmp/CLAUDE.md ./
cp -r .ecc-tmp/AGENTS.md ./
rm -rf .ecc-tmp

2. 安装 MCP server（可选）

# 以 filesystem + github 为例
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-github

然后在项目的 .mcp.json 里指定即可，ECC 自带的 .mcp.json 模板已经填好了大部分常用 server。

3. Docker 化一键启动（推荐团队使用）

把 ECC 的 skills/rules 打包进开发镜像，所有人进容器就是同一套 agent 配置：

FROM mcr.microsoft.com/devcontainers/base:ubuntu
RUN apt-get update && apt-get install -y nodejs npm git curl
RUN npm install -g @anthropic-ai/claude-code
注入 ECC 的 rules

COPY .claude /home/vscode/.claude
COPY .cursor /home/vscode/.cursor
COPY CLAUDE.md /home/vscode/CLAUDE.md
COPY AGENTS.md /home/vscode/AGENTS.md
USER vscode
WORKDIR /home/vscode

起容器：

docker build -t team-dev:ecc .
docker run -it --rm -v $(pwd):/workspace team-dev:ecc

4. 验证生效

打开 Cursor 或 Claude Code，在项目里输入 /help 或 What skills do you have?，应该能看到 ECC 注入的 skills 列表。如果能看到 code-review、test-generator、security-scan，说明生效。

适合谁

适合：

- 团队 3 人以上的开发组，想统一 AI 编程规范
- 已经在用 Claude Code / Cursor / Codex 多套工具来回切换的个人开发者
- 对代码安全、合规有要求的金融/医疗/政企团队
- 想 fork 一套私有 skills 库、又不想自己从零开始搭脚手架的人
- 关注 token 消耗、希望靠记忆机制减少重复 prompt 的重度用户

不太适合：

- 刚接触 AI 编程工具的初学者——ECC 默认规则偏严格，上来就被审查、要求写测试，可能会觉得束手束脚
- 只用单一 IDE、且对该 IDE 原生能力满意的小项目——这时候装 ECC 反而是负担
- 完全不接受"机器自动改你 CLAUDE.md"的人——ECC 会根据项目演化建议更新规则，需要你定期 review

链接

- 仓库：https://github.com/affaan-m/ECC
- 官网：https://ecc.tools
- 协议：MIT
- 最近更新：2026-06
- Star 数：21.6 万+
- 支持 IDE：Claude Code / Cursor / Codex / OpenCode / Gemini / Qwen / Kiro / Codebuddy / Zed / Trae

如果对其中某个 IDE 的具体接入细节（比如 Cursor 的 rules 文件格式、Codex 的 plugin 机制）感兴趣，可以在评论区告诉我，下一篇单独拆开讲。