affaan-m / ECC

affaan-m/ECC

open_in_new前往仓库

面向Claude Code、Codex、Opencode、Cursor等工具的代理框架性能优化系统，涵盖技能、直觉、记忆、安全与研究优先开发。

项目概览

项目概述

ECC（Everything Claude Code）是一个面向 AI 编程代理（agent）的“代理框架性能优化系统”，旨在为 Claude Code、Codex、OpenCode、Cursor 等主流编码代理提供一套协调的工程化体系与工具箱。它通过“规划→测试→实现→审查→验证→记忆→改进”的闭环流程，帮助代理在编码前进行规划、用测试验证变更、从全新上下文审查自身工作、记住重要信息，并将重复的成功经验转化为可复用的技能与工作流。ECC 采用 MIT 开源许可证，核心以 JavaScript/TypeScript 编写，并支持多种代理框架。

核心功能

  • 68 个专业代理（Agents）：涵盖规划、审查、构建修复、安全、架构及领域工作等。
  • 285 个技能（Skills）：包括 TDD、研究、安全、文档、前端、数据、ML、运维等。
  • 94 个命令（Commands）：作为向技能优先界面迁移的便捷入口。
  • 钩子与记忆（Hooks & Memory）：提供执行强制、会话摘要、持续学习、直觉与上下文控制。
  • 规则（Rules）：按语言或项目选择性加载的常驻标准。
  • AgentShield 安全扫描：对提示、钩子、MCP 配置、权限、密钥及代理文件进行安全审计。
  • 跨框架支持：原生支持 Claude Code，支持 Codex 同步，并为 Cursor、OpenCode、Gemini、Zed、GitHub Copilot 等提供适配器。
  • 统一记忆库（Memory Vault）：跨框架共享的本地 Markdown 格式持久上下文与交接。
  • Plan Canvas：基于浏览器的计划审查画布，支持标注、聊天与审批。

适用与不适用场景

适用场景：

  • 希望为 AI 编码代理建立标准化、可重复的工程流程（如 TDD、代码审查、安全扫描）的开发者或团队。
  • 需要跨多个编码代理（Claude Code、Codex、Cursor 等）统一工作流与上下文的用户。
  • 希望优化代理上下文窗口使用、降低 token 成本并提升输出质量的场景。
  • 需要为代理配置增加安全审计（AgentShield）的团队。

不适用场景：

  • 仅需单一、轻量级提示词配置的简单个人项目（ECC 功能较重，可能过度）。
  • 对代理框架无自定义需求、仅使用默认行为的用户。
  • 需要完全离线、无任何外部依赖的极端环境（部分功能依赖 npm 包或网络）。
  • 希望完全避免学习曲线、快速上手的用户（ECC 安装与配置有一定复杂度）。

技术架构与依赖

  • 核心语言：JavaScript（Node.js），部分组件使用 TypeScript、Python、Shell。
  • 运行时：Node.js（要求 Claude Code CLI v2.1.0+）。
  • 包管理：npm（提供 ecc-universal、ecc-agentshield 包）。
  • 依赖：仓库资料未提供完整的依赖清单，但涉及 npm 生态、Git、以及各代理框架的原生接口。
  • 架构：采用“代理框架适配层”设计，核心组件（agents、skills、commands、hooks、rules）通过安装器映射到不同框架的配置目录（如 .claude/、.codex/、.cursor/）。
  • 可选组件：ccg-workflow 运行时（用于 multi-* 命令）、ecc-memory-mcp（可选 MCP 服务器）、Itô 计算 CLI 桥接（用于 GPU 资源）。

安装与快速开始

推荐方式（Claude Code 插件）：

npx ecc-universal setup

多框架安装向导：

npx ecc-universal install --guided

手动安装（Claude Code）：

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

其他框架（示例）：

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile minimal --target cursor

快速开始：

  • 使用 /ecc:plan "描述功能" 开始规划。
  • 使用 tdd-workflow 技能进行测试驱动开发。
  • 使用 /code-review 进行代码审查。
  • 使用 /security-scan 进行安全扫描。

典型使用方法

新功能开发流程：

/ecc:plan "添加用户认证"
-> 确认或编辑计划
-> 激活 tdd-workflow 技能
-> 先写失败测试（RED）
-> 实现至通过（GREEN）
-> /code-review 审查
-> 修复发现的问题并添加回归测试
-> 验证构建、lint、类型与测试

跨框架记忆共享：

npm install -g ecc-universal
ecc memory init --scope project
ecc memory handoff --from hermes --target codex --title "继续认证迁移" --body-file ./handoff.md
ecc memory search "认证迁移" --target-harness codex

安全扫描：

npx -y ecc-agentshield scan --path .

配置与部署要点

  • 安装路径选择：每个框架只能选择一种安装方式，避免叠加导致技能/钩子重复。
  • 规则安装：Claude Code 插件不自动分发 rules，需手动复制所需语言包（如 rules/common + rules/typescript）。
  • 钩子配置：插件安装后，Claude Code v2.1+ 自动加载 hooks/hooks.json，切勿在 settings.json 中重复声明。
  • MCP 配置：默认仅启用 chrome-devtools 连接器，其他 MCP 需手动启用；注意控制启用数量以节省上下文。
  • 环境变量：可通过 ECC_HOOK_PROFILE、ECC_DISABLED_HOOKS、ECC_SESSION_START_MAX_CHARS 等调整运行时行为。
  • 多框架数据隔离：使用 ECC_AGENT_DATA_HOME 为不同框架设置独立数据目录，避免会话文件互相覆盖。
  • 模型网关：可通过 ANTHROPIC_BASE_URL 等环境变量接入自定义 API 端点或自托管模型。

限制、风险与许可证

  • 许可证：MIT 许可证，可自由使用、修改与分发。
  • 平台支持差异：不同框架（Claude Code、Codex、Cursor 等）的功能支持程度不同，Codex 无钩子运行时，GitHub Copilot 仅支持指令层。
  • Windows 支持：核心功能支持，但部分可选功能（如持续学习 v2 的观察者守护进程）存在已知缺陷。
  • 安全风险：钩子、MCP 服务器、项目指令可能包含可执行配置，需谨慎对待；建议使用 AgentShield 定期扫描。
  • 安装风险：叠加安装可能导致重复配置，需遵循官方安装指南。
  • 第三方依赖：部分功能依赖第三方服务（如 Itô 计算、Atlas Cloud），需自行评估信任与安全。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 affaan-m/ECC 的 README、CHANGELOG、文档目录（docs/）及发布信息。
  • 分析时间：2026-07-27（基于最新发布版本日期）。
  • 注意：仓库内容可能随时间变化，建议以官方仓库最新信息为准。