⚙️
给 AI 编程 Agent 装上工程系统
ECC：281k Star 的 agent harness 性能优化系统——让 Claude Code / Codex / Cursor 等 Agent 会规划、写测试、做复盘、记记忆、讲安全
MIT
71 Agents
311 Skills
📖 它是什么
ECC（仓库 affaan-m/ECC，官网 ecc.tools）自称是 "The agent harness performance optimization system"——给 AI 编程 Agent 配的工程系统 + 工具箱。你的 Agent 能写代码，但 ECC 给它一整套纪律：先规划再动手、用测试验证改动、换个新上下文复盘自己的产出、记住关键信息、把反复成功的做法沉淀成可复用的 Skills 和工作流。核心一句口号："Optimize the context window. Persist everything else."（优化上下文窗口，其余全部持久化）。
ECC 的内置工作流是一条清晰的闭环：plan → test → implement → review → verify → remember → improve。你不需要在每个 Prompt 里重复这套要求，装一次它就成了 Agent 工作的默认方式。它目前开源 71 个 Agent（规划/复盘/构建修复/安全/架构/领域工作）、311 个 Skills（TDD、研究、安全、文档、前端、数据、ML、运维等）、97 个命令入口，外加 hooks、rules、Memory Vault、instincts 和 AgentShield 安全扫描。
它现在与 Claude Code 配合最佳，有 Codex、Qoder 的原生插件路径，并为 Cursor、OpenCode、Gemini、Zed、GitHub Copilot、Qwen、Kimi、Hermes、OpenClaw 等提供了能力受限的适配器。采用 MIT 协议，当前版本 2.2.3，2026-01 建仓、至今仍在活跃更新（GitHub 已 281,790 Star）。
📎 GitHub：github.com/affaan-m/ECC ｜ 官网：ecc.tools ｜ npm：ecc-universal ｜ GitHub App：github.com/apps/ecc-tools
✨ 核心亮点
🧠
规划→测试→实现→复盘
把"先计划再动手"变成可编辑产物，而非聊天记录
🔁
TDD 变成门禁
RED→GREEN→REFACTOR 带证据的工作流，不再靠模型自觉
💾
Memory Vault 记忆库
会话蒸馏成摘要/instincts/技能，跨 Agent 传递上下文
🛡️
AgentShield 安全扫描
把 Agent 配置本身当攻击面：扫 Prompt、hooks、MCP、密钥
🖥️ 环境要求
| Node.js | 18 或更新（通用包要求） |
| Claude 插件 | 还需 Git + Claude Code 2.1 或更新（需在 PATH 上） |
| 支持平台 | Claude Code（最佳）、Codex、Qoder、Kimi Code；Cursor/OpenCode/Copilot 等适配器 |
| 包管理 | npm/npx、pnpm、Yarn 2+、Bun 均可跑向导 |
🚀 上手步骤
① 准备前置环境（Windows 为例）
node --version
git --version
claude --version装好 Node.js 18+、Git、Claude Code，然后确认三者在 PATH 上。
② 运行官方引导安装（推荐）
npx ecc-universal@2.2.3 setup选 Global user（个人使用）和 Standard hooks 确认即可，不需要克隆仓库。多 Agent（Claude + Codex + Kimi）用 npx ecc-universal@2.2.3 install --guided。
③ 验证是否装好
/plugin list # 应看到 ecc@ecc 已启用装好后用 /ecc:configure-ecc 重新配置，或用 ecc consult "security reviews" --target claude 调起专项技能。
④ 开一条 TDD 工作流（体验核心价值）
/ecc:plan "Add usage-based billing alerts"
-> 确认或编辑计划
-> 激活 tdd-workflow
-> 实现前先捕获 RED 证据
-> 实现到 GREEN
-> 换新上下文做复盘
-> 修复 findings 并补回归测试
-> 验证 build / lint / types / tests产出不只是一段代码，而是一串证据：计划、失败的测试、通过的测试、复盘结论和最终验证。
关键信息速查
| Claude 原生安装 | /plugin marketplace add https://github.com/affaan-m/ECC 然后 /plugin install ecc@ecc |
| Codex 原生 | codex plugin marketplace add affaan-m/ECC + codex plugin add ecc@ecc |
| 其他平台 | git clone 后 ./install.sh --profile minimal --target <cursor|opencode|gemini|...> |
| 记忆库 | npm install -g ecc-universal@2.2.3，然后 ecc memory init/search/read/doctor |
| 安全扫描 | /security-scan 或 agentshield scan --path . |
🎯 典型玩法
🧪 TDD 自动化：把测试先行变成带 RED/GREEN 证据的门禁流程
🔍 代码安全审查：/security-scan 跑 OWASP Top 10 审计，扫 Agent 配置
💾 跨 Agent 记忆：Memory Vault 在 Claude/Codex/Hermes/Kimi 间传上下文
🛠️ 构建修复：专门的 build-repair Agent 快速定位并修好构建
📐 架构规划：先产出可编辑的计划产物，再动手实现
🔁 经验沉淀：instincts 记住反复成功的做法，演变成 Skills
📊 和同类做法比
| 裸用 AI 编程 Agent | 计划消失在聊天记录、"请用 TDD"靠模型自觉、同一上下文写又审、记忆靠存长 transcript |
| 靠人为提醒做质量检查 | 质量靠提示，Agent 配置默认被信任，缺少安全审视 |
| ECC | 计划成产物、TDD 成门禁、新上下文复盘、记忆蒸馏成技能、hooks 强制检查、AgentShield 扫描 |
原理一句话：把"工程纪律"从 Prompt 里抽出来，变成 Agent 外部的系统——计划、测试、复盘、记忆、安全各自成组件（Skills/Agents/Rules/Hooks/Instincts 职责分离），只在任务需要时加载，从而既加能力又不把整个仓库塞进每次会话，同时优化上下文窗口、持久化其余一切。
❓ 常见问题
Q：ECC 是什么？需要重写代码吗？
不是框架或语言，是一套给 AI 编程 Agent（Claude Code/Codex/Cursor 等）的工程系统 + 工具箱，装好后改变 Agent 的工作方式，不需要你改业务代码。
Q：它和直接用 Claude Code 有什么区别？
裸用 Claude Code，工程纪律要靠你反复在 Prompt 里要求；ECC 把这些变成系统：先规划、测试门禁、新上下文复盘、记忆沉淀、hooks 强制检查、AgentShield 扫安全。
Q：支持哪些平台？
Claude Code 配合最佳；有 Codex、Qoder、Kimi Code 原生路径；Cursor、OpenCode、Gemini、Zed、Copilot、Qwen、Hermes、OpenClaw 等有适配器（能力/特性可能不同）。
Q：怎么安装？
最省事：npx ecc-universal@2.2.3 setup（需 Node 18+、Git、Claude Code）。或 Claude 内 /plugin marketplace add ... 再 /plugin install ecc@ecc。装一个平台的只走一条路径，别叠加装。
Q：有安全顾虑吗？
ECC 自带 AgentShield 扫描，且官方明确只建议从 GitHub、npm、GitHub App、ecc@ecc 插件和 ecc.tools 安装，第三方镜像可能夹带恶意代码，务必走官方渠道。
Q：是免费的吗？
ECC 本体 MIT 开源免费。部分进阶（ECC Pro + GitHub App、私有仓库等）有付费档，基础能力开源可用。
Q：装了想卸掉怎么办？
跑 uninstall 命令会顺带给出反馈入口；本地配置若被重置，先 node scripts/ecc.js list-installed 再 doctor、repair，通常能恢复而不用重装。
📎 GitHub 搜索 affaan-m/ECC ｜ 官网 ecc.tools
关注「AI工具匠」，获取更多 AI 工具实操教程