ECC(Enhanced Claude Code) — Harness 原生的 Agent 性能优化系统,面向 Claude Code、Codex、Cursor、OpenCode、Gemini、GitHub Copilot 等多 harness 的生产级 Agent 工程工作流。207k stars,单维护者持续迭代 10+ 个月,MIT 开源,Pro 版($19/seat/mo)提供私有仓库 + GitHub App。
“Not just configs. A complete system: skills, instincts, memory optimization, continuous learning, security scanning, and research-first development.”
核心组件(v2.0.0-rc.1)
| 组件 | 数量 | 说明 |
|---|---|---|
| Agents | 63 | 委托子任务的专职子 Agent(code-reviewer、security-auditor 等) |
| Skills | 249 | 主要工作流入口,可直接调用或自动触发 |
| Rules | 多目录 | 始终遵循的规则,按语言分层(common/ts/python/go/swift/php/etc) |
| Hooks | 27+ 事件类型 | 工具事件触发器(Edit/Bash/SessionStart/Stop 等) |
| Legacy command shims | 79 | 旧 /command 格式的向后兼容层 |
| Instincts | - | 从 session 自动提取的可复用行为模式 |
六大能力维度
| 能力 | 内容 |
|---|---|
| Token 优化 | 模型选择策略、system prompt 瘦身、后台进程管理 |
| Memory 持久化 | SessionStart/Stop Hook 自动保存/加载跨 session 上下文 |
| 持续学习 | 从 session 自动提取 pattern → Instinct,有置信度评分 |
| 验证闭环 | Checkpoint / 持续 eval,grader 类型,pass@k 指标 |
| 并行化 | Git worktree + cascade 方法,多实例扩展时机判断 |
| 子 Agent 编排 | 上下文问题解法、迭代检索 pattern、observer 防循环 |
安装方式
推荐:Claude Code Plugin(最简)
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc⚠️ Plugin 安装后不要再跑
install.sh --profile full,会产生重复 skill。Rules 需手动复制到~/.claude/rules/ecc/,从rules/common开始。
Manual 安装(更精细控制)
# 最小化(无 hook)
./install.sh --profile minimal --target claude
# 核心 + 关闭 hook
./install.sh --profile core --without baseline:hooks --target claude
# 按需咨询
npx ecc consult "security reviews" --target claude
npx ecc install --profile minimal --target claude --with capability:machine-learningnpm 包
npx ecc-universal # npm 包名(与 plugin identifier 不同)
npx ecc-agentshield # 安全扫描专项三个公开标识符(不可混用):GitHub repo =
affaan-m/ECC,plugin =ecc@ecc,npm =ecc-universal
安全:AgentShield
内置安全扫描能力,1282 测试 / 102 规则:
/security-scan # 直接从 Claude Code 运行 AgentShield覆盖:攻击向量、沙箱化、输入净化、已知 CVE。
ECC 2.0 Alpha(Rust 控制平面)
ecc2/ 目录下的 Rust 原型,已可本地构建,暴露以下命令:
ecc dashboard | start | sessions | status | stop | resume | daemon
ecc status --markdown --write status.md # 生成可移植的状态快照
ecc work-items upsert ... # 手动写入工作项
ecc work-items sync-github --repo owner/repo版本演进
| 版本 | 时间 | 核心变化 |
|---|---|---|
| v2.0.0-rc.1 | 2026-04 | Dashboard GUI、Operator 工作流、Rust 控制平面 alpha、63 agents/249 skills |
| v1.9.0 | 2026-03 | 选择性安装架构、SQLite 状态存储、12 语言生态 |
| v1.8.0 | 2026-03 | Harness 性能系统定位、Hook 可靠性重构、NanoClaw v2 |
| v1.7.0 | 2026-02 | Codex app/CLI 支持、frontend-slides skill |
| v1.6.0 | 2026-02 | Codex CLI、AgentShield、GitHub Marketplace |
| v1.4.0 | 2026-02 | 安装向导、PM2 多 Agent 编排、多语言 Rules 架构 |
| v1.3.0 | 2026-02 | OpenCode 全面支持(12 agents/24 commands/16 skills) |
适用 Harness
Claude Code、OpenAI Codex(app/CLI)、Cursor、OpenCode、Gemini CLI、GitHub Copilot、Zed,及其他支持 AGENTS.md 的 harness。
关联页面
- superpowers — 同类工程方法论 Skill 集,14 个强制工程纪律 Skill
- claude-plugins-official — Anthropic 官方 Plugin 目录,ECC 通过
/plugin安装 - skills-cli — npx skills CLI,ECC 亦可通过 skills 生态分发
- agent-skill-loading — Skill 在 Claude Code 中的加载机制
- claude-code-permissions — settings.json Hook 配置,与 ECC 的 Hook 系统直接相关