文档大纲

面向 AI 工程师的 Agent Harness 性能优化系统 —— affaan-m/ECC 286 Skills + 68 Agents 全栈架构深度解析

一、ECC 是什么

affaan-m/ECC（Emerald Cloud Controller）是一个面向 AI 工程师的 Agent Harness 性能优化系统，覆盖 14 家主流 Harness（含 Claude Code、Codex、Kimi Code、Cursor、OpenCode、Gemini、Zed、GitHub Copilot、Antigravity、Qwen、OpenClaw、Hermes、CodeBuddy、JoyCode），是目前 Agent Harness 赛道当之无愧的 No.1 项目。

与"配置包"或"Skill 集合"不同，ECC 提供的是完整的 Agent 操作系统：

plan → test → implement → review → verify → remember → improve

核心哲学：
Optimize the context window. Persist everything else.
优化上下文窗口，其余一切持久化。

二、四件套架构

2.1 Skills（286 个可复用能力）

Skills 是 ECC 的能力原子，覆盖 TDD、安全、文档、前端、数据、ML、运维等 9 大领域。开发者无需在每次 Prompt 里重复描述工作流，一次安装即可让 Agent 拥有完整工程能力。

代表 Skills：

Skill用途
pytorch-patterns深度学习工作流（数据加载 / 训练 / 评估）
security-scanAgentShield 集成，扫描 prompt / hook / MCP 配置 / secrets
frontend-slides零依赖 HTML 演示构建（离线可用）
article-writing长文结构化写作（大纲→草稿→润色）
market-research市场情报自动收集
ito-market-intelligence预测市场情报包（Itô Markets 联名）

2.2 Instincts（持续学习机制）

Instincts 是 ECC 的"经验沉淀层"。它会在每次 Session 结束后，自动识别重复出现的成功模式，并将其转化为新的 Skill。

Session 完成 → 模式识别 → 高置信模式 → 写入 Skill 库 → 下次直接调用

这意味着 ECC 越用越聪明，而不是每次都从零开始。对比 OpenClaw 当前的 self-improving-agent 流程，ECC 的 Instincts 已经实现了自动化模式提取 + Skill 化输出的完整闭环。

2.3 Memory（跨 Session 持久化）

ECC 通过 Hook 机制在 Session 开始时自动加载上下文，结束时自动保存关键信息。开发者无需手动管理 "memory 文件"。

维度ECC传统方案
加载时机Session 开始自动手动注入 Prompt
保存时机Session 结束自动手动写文件
颗粒度任务级 + 主题级文件级
检索能力向量化 + 标签文件名匹配

2.4 AgentShield（安全扫描）

AgentShield 是 ECC 内置的安全层，包含 102+ 规则，覆盖：

  • Prompt 注入检测 — 识别恶意指令
  • Hook 权限审计 — 防止越权操作
  • MCP 配置审查 — 检查外部工具授权
  • Secrets 扫描 — 防止密钥泄露
  • Agent 文件校验 — 完整性 + 来源验证

三、ECC 2.2 新特性

2026 年 8 月发布的 ECC 2.2 带来了三项重要升级：

1. 引导式安装（Guided Package Setup）

  • Claude Code / Codex / Kimi Code 三家用户首次安装体验优化
  • 自动检测已安装环境，避免重复安装冲突

2. 原生 Codex Plugin 支持

  • 不再依赖旧的 sync 脚本
  • 通过 codex plugin marketplace add affaan-m/ECC 即可

3. 通用管理 CLI

node scripts/ecc.js list-installed    # 列出已安装组件
node scripts/ecc.js doctor            # 健康检查
node scripts/ecc.js repair            # 智能修复（无需重装）

四、安装指南（Claude Code 优先）

推荐路径（Claude Code 用户）：

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

npm 全局安装：

npm install -g ecc-universal         # 主包
npm install -g ecc-agentshield       # 安全扫描独立包

安装铁律：每个 Harness 只选一种安装方式，不要叠加。

组合状态
Claude plugin + Codex native plugin✅ 推荐
Claude plugin + Codex sync（兼容模式）✅ 可用
Claude plugin + 完整 manual install❌ 避免
Codex sync + Codex marketplace plugin❌ 避免

五、OpenClaw 用户的接入路径

ECC README 明确将 OpenClaw 列为 adapter 之一。这意味着 OpenClaw 用户可以直接复用 ECC 的能力栈：

Step 1：评估接入成本

git clone https://github.com/affaan-m/ECC
cd ECC
node scripts/ecc.js doctor

Step 2：借鉴架构思想（不直接接入）

ECC 特性OpenClaw 对应模块可借鉴度
Instincts 自动模式提取self-improving-agent⭐⭐⭐⭐⭐
AgentShield 安全校验AGENTS.md Red Lines⭐⭐⭐⭐
Hook 持久化Memory 系统 L0/L1/L2⭐⭐⭐
多 Harness 抽象单 Harness（OpenClaw 专属）⭐⭐

Step 3：落地优先级

  • P1：Instincts 模式提取 → 自动化生成 OpenClaw Skill
  • P2：AgentShield 扫描 → 集成到 OpenClaw 红线自动化校验
  • P3：跨 Session 上下文传递 → 优化 Memory 分层

六、与同类项目对比

维度ECCclaude-memUnderstand-Anythingcodegraph
定位Harness 操作系统跨 Session 记忆知识图谱生成代码库分析
Skills 数286❌❌❌
Agents 数68❌❌❌
多 Harness✅ 14 家✅ 主流❌❌
安全扫描✅ AgentShield❌❌❌
持续学习✅ Instincts❌❌❌
Token 优化✅ 内置❌❌增量同步
Stars244K78K35K3K

结论：在 Agent Harness 性能优化赛道，ECC 没有直接对手。其他项目（如 claude-mem）只解决了 ECC 4 件套中的 1 件（Memory）。

七、商业模型与生态

OSS 永久免费（MIT 协议）。

ECC Pro（GitHub App 形态）：

  • 解锁私仓支持
  • 定价：$19/seat/月
  • 提供托管安装 + 自动更新

Sponsors 生态：

  • 企业级：CodeRabbit / Greptile / Atlas Cloud / Moonshot AI (Kimi) / Itô Markets
  • 社区级：5 位个人 Sponsor
  • 这种"OSS 免费 + Pro 增值 + Sponsor 捐赠"的三轨模式，让单人维护者能够支撑 14 家 Harness 的周更节奏。

八、总结

affaan-m/ECC 的核心价值不在于"有多少 Skill"，而在于它提供了一套完整的 Agent 工程化方法论：让 Agent 拥有计划、测试、实施、审查、验证、记忆、改进的完整闭环。

对于 AI 工程师来说，ECC 的价值有三层：

  1. 直接使用：在 Claude Code / Codex / Kimi Code / OpenClaw 等 Harness 中安装，立即获得 286 个 Skill + 68 个 Agent
  2. 架构借鉴：Instincts / AgentShield / Memory Hook 三件套的设计思想，可移植到任何 Agent 系统
  3. 生态接入：随着 ECC 2.2 的多 Harness 支持矩阵成型，它正在成为 Agent 时代的"操作系统级"基础设施
  • GitHub：https://github.com/affaan-m/ECC
  • 官网：https://ecc.tools
  • Pro 定价：$19/seat/月
  • Discord：https://discord.gg/36yGMHGFbR

阅读量： 334

网站备案号：沪ICP备2025137870号