## 项目概述

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 插件）：**
```bash
npx ecc-universal setup
```

**多框架安装向导：**
```bash
npx ecc-universal install --guided
```

**手动安装（Claude Code）：**
```bash
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
```

**其他框架（示例）：**
```bash
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、类型与测试
```

**跨框架记忆共享：**
```bash
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
```

**安全扫描：**
```bash
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 仓库**：https://github.com/affaan-m/ECC
- **npm 包**：https://www.npmjs.com/package/ecc-universal 、https://www.npmjs.com/package/ecc-agentshield
- **GitHub App**：https://github.com/apps/ecc-tools
- **官方网站**：https://ecc.tools
- **Discord 社区**：https://discord.gg/36yGMHGFbR
- **最新版本**：v2.1.0（2026-07-27 发布）

## 信息来源和分析时间

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