affaan-m/ECC —— AI Agent 性能优化系统

## 这是什么

ECC（Everything Claude Code，原项目仓库名称为affaan-m/ECC）是一个跨AI代理工具链的专用工作流引擎系统。官方GitHub仓库（211.9K+星、32.5K+分支）以MIT协议开源，核心提供261个技能、66个代理、84个遗留命令shim以及完整的钩子（hooks）和MCP配置。核心层包括技能（skills）、本能（instincts）、内存优化、持续学习、安全扫描和研究优先的开发流程。v2.0.0版本稳定毕业，新增Hermes操作员故事层（Hermes operator story），并在ecc2/目录下提供Rust控制平面原型，支持dashboard、start、sessions、status、stop、resume、daemon等命令。整个系统可无缝集成到Claude Code、Codex、Cursor、OpenCode、Gemini、Zed和GitHub Copilot等七大代理工具链中，官方还提供ecc-universal、ecc-agentshield、ECC Discord社区和GitHub App（ECC Tools）托管服务。

## 解决的问题

AI代理工具链的日常工程工作存在三大痛点：

1. 记忆碎片化导致上下文爆炸，每次新任务都要手动重构prompt；
2. 安全和一致性漏洞频发，配置文件（CLAUDE.md、.cursorrules、agents.json）易被注入或误配；
3. 跨工具链的运维碎片化，同一个项目在不同Harness（Claude Code vs Cursor vs Codex）上重复写规则和shim。

ECC通过一整套可复用的Operator系统替代散乱的配置包，将真实的多Harness工程工作流固化成生产级组件，自动实现记忆压缩、持续自我优化、安全扫描和跨平台标准化。

## 核心功能

• 控制平面子系统：SQLite状态存储 + 会话适配器（session adapters），支持结构化会话记录、会话分支/导出/压缩、NanoClaw v2模型路由与技能热加载。
• Operator工作流引擎：统一编排器（orch-*家族）+ 工作树生命周期服务（worktree-lifecycle），提供确定性冲突预测与安全垃圾回收；新增品牌语音、社交图排序器、连接优化器、客户账单运维、Google Workspace运维、项目流程运维和工作区表面审计等8个域技能。
• 安全扫描与防护：内置AgentShield（102条规则、1282个测试），可在Claude Code内直接运行/security-scan，扫描CLAUDE.md、MCP服务器和提示注入向量。
• 自学习与记忆优化：连续学习v2本能系统（continuous-learning-v2），观察会话后生成原子行为并打分；内存爆炸防护采用节流+尾部采样。
• 安装与状态管理：Manifest驱动的增量安装（install-plan.js、install-apply.js）；ecc status命令输出就绪性、活跃会话、技能运行健康、治理事件和Linear/GitHub工单手交；支持ecc work-items upsert、ecc work-items sync-github和ecc status --exit-code。
• 钩子与运行时控制：SessionStart根回退、Stop阶段总结、脚本式钩子替换内联一行；新增ENV变量ECC_HOOK_PROFILE=minimal|standard|strict和ECC_DISABLED_HOOKS。
• 媒体与内容生成工具链：Manim视频生成、Remotion视频制作、Zero-dependency HTML PPTX转换器等。
• 多语言支持：12个生态规则（新增Java、PHP、Perl、Kotlin/Android/KMP、C++、Rust）；6个新代理（typescript-reviewer、pytorch-build-resolver等）覆盖10种语言。
• v2.0控制平面原型：Rust实现的可本地构建的dashboard与命令行工具，可作为alpha使用。
• 社区与发布：自动发布到Discord（#announcements、#pr-and-issues）；每周通过单一维护者跨七大Harness发布；支持Itô预测市场技能包（ito-market-intelligence等）和优化技能包（parallel-execution-optimizer等）。

## 亮点 / 与同类相比

ECC是目前GitHub上星数最高的Claude Code相关配置仓库（224.8K+星），其核心差异在于“Harness-native Operator System”而非单纯的prompt配置包：

• 单一代码库同时适配Claude Code、Codex、Cursor、OpenCode、Gemini、Zed、GitHub Copilot七大工具链，无需为每个Harness重复编写规则。
• v2.0控制平面（Rust prototype + session adapters + MCP inventory）实现真正的跨Harness会话可见性与编排，远超传统“粘贴CLAUDE.md”的方案。
• 内置AgentShield提供可审计的红蓝队扫描，替代很多工具的“黑盒安全”；997+内部测试+19次CI失败修复确保每一次发布都绿色通过。
• 社区驱动：230+贡献者、15.3K+贡献者、Discord社区和GitHub App（免费层已上线）形成闭环；Pro订阅和赞助商直接资助每周多Harness发布。
• 与Cursor规则集、Claude自定义指令、OpenCode或独立工具（如Cursor规则、单独的代码审查代理）相比，ECC无需切换工具链即可获得一致性、安全扫描、持续学习和跨平台运维能力。

## 适合谁用 / 上手

适合人群：

• 中大型工程团队（尤其是多工具链混合使用场景），需要标准化TDD、代码审查、安全审查和跨Harness一致性的开发者。
• 需要构建可复用Operator的工作流（品牌语音、社交图排名、预测市场分析、并行执行优化等）的产品和研究团队。
• 追求高安全性和低维护成本的工程组织，已在使用Claude Code/Cursor/ Codex等工具，但希望避免每次新任务都从零配置。
• 开发者或开源爱好者，喜欢将GitHub历史记录自动转化为技能和本能的团队。

上手步骤（官方推荐路径，5分钟可跑通）：

1. 访问ecc.tools，选择公共仓库直接安装免费GitHub App（/ecc-tools analyze评论即可触发）。
2. 或者在终端执行：npm install -g ecc-universal（或npx ecc-universal），选择Core/Developer/Security/Full Profile。
3. 推荐安装：npm install -g ecc-agentshield + 核心插件 /plugin marketplace add https://github.com/affaan-m/ECC。
4. 完成安装后运行ecc status查看健康状态，立即可用。
5. 进阶：开启ECC 2.0控制平面（cd ecc2 && cargo build），或加入ECC Discord社区讨论/贡献新技能。

整个过程不依赖特定LLM，安装后可立即在Claude Code中输入/security-scan或/tdd-workflow获得生产级效果。