项目简介
ECC（即「the agent harness performance optimization system」，可理解为智能体编程框架性能优化系统）是一套开源、采用 MIT 许可的工程化配置与工具集合，面向 Claude Code、Codex、OpenCode、Cursor 等智能体编程框架。它把「先规划、用测试验证、从全新上下文自审、记住重点、把重复的胜利沉淀为可复用技能」的工程方法，做成了一次安装、长期生效的系统性能力，而不必在每条提示词里重复搭建流程。项目出自 Anthropic 黑客马拉松获奖者，经过 10 余个月的真实产品开发与高频日常使用打磨。其核心循环可概括为：规划 → 测试 → 实现 → 评审 → 验证 → 记忆 → 改进。
目前 ECC 对 Claude Code 支持最完整，Codex 提供受支持的同步路径，并为 Cursor、OpenCode、Gemini、Zed、GitHub Copilot、Antigravity、Qwen 等框架提供能力受限的适配层。整套系统包含 68 个专职智能体、293 项技能、94 个兼容旧命令的垫片，以及钩子、规则、记忆、持续学习与 AgentShield 安全扫描。
功能特色
- 专职智能体（Agents）：68 个分工明确的子智能体，覆盖规划、评审、构建修复、安全、架构与领域任务，可按受限 scope 委派，避免同一上下文既写代码又审代码。
- 技能体系（Skills）：293 项可复用工作流，是主要的流程入口；可被直接调用、按场景自动建议，并被智能体复用。新工作流优先落入 skills/ 目录。
- 测试驱动开发（TDD）：把「请用 TDD」从一句易被遗忘的指令，升级为带证据的门控流程 RED → GREEN → REFACTOR，每次改动都留下规划、失败测试、通过测试、评审结论与最终验证的证据链。
- 钩子（Hooks）：在工具事件触发时执行确定性检查（例如拦截 console.log），把质量门禁移出提示词，由运行时强制执行。
- 规则（Rules）：始终遵循的准则，按 common/ 通用层与 TypeScript、Python、Go、Swift、PHP、ArkTS 等语言专属层组织，按需安装。
- 记忆与持续学习：会话被提炼为摘要、本能与可复用技能，并通过项目保险库（vault）在多个框架之间共享同一份记忆。
- AgentShield 安全扫描：扫描提示词、钩子、MCP 配置、权限、密钥与智能体文件等攻击面；GateGuard 在命令执行前拦截 rm、强制 git checkout 等破坏性 shell 操作。
- 跨框架通用：同一套工作流通过平台适配器打包或映射，而非各自维护副本；核心 CLI 与安装器支持 Windows、macOS、Linux。
安装与配置
- 通用引导安装（推荐）：需 Node.js 18 及以上，运行
npx ecc-universal@2.2.3 setup，按提示完成 Claude Code 插件、更新与钩子配置；Windows 用户可在 PowerShell 中走同样的引导流程。 - Claude Code 插件：安装后在 Claude Code 中启用
ecc@ecc插件，运行/plugin list核验已启用。 - 源码安装：克隆仓库后按目标框架运行
./install.sh --profile minimal --target <框架>（Windows 用.install.ps1），例如 cursor、opencode、gemini、zed、kimi 等。 - 仅取配置不装钩子：使用
npx ecc-universal@2.2.3 install --profile minimal --target claude取得规则、技能与流程，而不启用运行时钩子。
使用方法
- 初始化记忆：建立项目保险库（vault），让会话间的重点与经验沉淀、共享。
- 用技能驱动任务：例如以
/ecc:plan "新增按量计费告警"先产出可编辑的计划，再激活 tdd-workflow 捕获 RED 证据、实现至 GREEN、从新上下文评审、补回归测试，最终校验构建、类型与测试。 - 安全自检：在 Claude Code 中运行
/security-scan调用 AgentShield 扫描自身配置面；上下文过重时运行/context-budget收紧。 - 沉淀团队能力：用
/skill-create基于本仓库 git 历史本地生成新技能；团队级能力可接入 ecc-tools GitHub App 实现自动 PR 与共享。
适用场景与人群
- 重度使用 Claude Code / Codex 的开发者：把零散的「请做 TDD、请自审」固化为系统能力，提升交付质量与一致性。
- 维护多框架的团队：同一套 ECC 工作流经适配器映射到 Cursor、OpenCode、Gemini 等，统一工程规范，避免各框架各搞一套。
- 重视安全的工程团队：AgentShield 与 GateGuard 在提交前扫描提示词、钩子、MCP 与密钥面，降低智能体被劫持与误执行破坏性命令的风险。
- 想把习惯沉淀为资产的个人：把重复的胜利转成技能与本能，跨会话、跨框架复用，越用越顺手。
- 开源与自托管爱好者：采用 MIT 许可，可自由使用与改造，并支持自托管模型与自定义端点。
