# everything-claude-code (ECC) 研究

> 来源: https://github.com/affaan-m/everything-claude-code
> 研究日期: 2026-05-04

## 项目概览

- **140K+ stars, 21K+ forks, 170+ contributors**
- Anthropic Hackathon 获奖项目
- 当前版本: **v2.0.0-rc.1**
- 定位: **AI Agent Harness 性能优化系统**（不只是配置文件）

## 核心能力

| 能力 | 说明 |
|------|------|
| Token 优化 | 模型选择、系统提示瘦身、后台进程管理 |
| 记忆持久化 | Hooks 自动跨会话保存/加载上下文 |
| 持续学习 | 自动从会话中提取模式生成可复用技能 |
| 验证循环 | Checkpoint vs 持续评估、grader 类型、pass@k 指标 |
| 并行化 | Git worktrees、级联方法、实例扩展 |
| 子代理编排 | 上下文问题管理、迭代检索模式 |

## 支持的 Agent Harness

Claude Code, Codex, Cursor, OpenCode, Gemini 等

## 规模

- **48 个 agents**（覆盖 10+ 编程语言）
- **182 个 skills**
- **68 个 legacy command shims**
- **12 种语言生态**（TypeScript, Python, Go, Java, PHP, Perl, Kotlin/Android/KMP, C++, Rust 等）

## 安装方式

### 1. Claude Code 插件（推荐）
```bash
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code
```

### 2. 手动安装
```bash
# 最小配置（不含 hooks）
./install.sh --profile minimal --target claude

# 核心配置（不含 hooks）
./install.sh --profile core --without baseline:hooks --target claude

# 完整版
./install.sh --profile full
```

### 3. npm
```bash
npx ecc-install --profile minimal --target claude
```

### 4. 咨询工具
```bash
npx ecc consult "security reviews" --target claude
```

## 关键架构

### 三个公共标识（不可互换）
- GitHub 源码: `affaan-m/everything-claude-code`
- Claude 插件: `everything-claude-code@everything-claude-code`
- npm 包: `ecc-universal`

### Hook 运行时控制
```bash
ECC_HOOK_PROFILE=minimal|standard|strict
ECC_DISABLED_HOOKS=...
```

### 新增 Harness 命令
- `/harness-audit` — 审计评分
- `/loop-start` — 启动循环
- `/loop-status` — 循环状态
- `/quality-gate` — 质量门禁
- `/model-route` — 模型路由

## ECC 2.0 特性（alpha）

- Rust 控制平面原型 (`ecc2/`)
- 新增命令: dashboard, start, sessions, status, stop, resume, daemon
- Dashboard GUI (Tkinter)
- SQLite 状态存储 + 查询 CLI
- Session adapters 结构化记录
- Skill evolution 自改进基础

## 安全

- **AgentShield 集成**: `/security-scan` 技能
- 1282 个测试，102 条规则
- GitHub Marketplace: `github.com/marketplace/ecc-tools`

## 与 OpenClaw 的关联

ECC 的很多理念与 OpenClaw 的 AGENTS.md / SOUL.md / 技能系统类似：
- **Skills 系统** → OpenClaw 的 skills/ 目录
- **Instincts** → 类似 SOUL.md 的个性定义
- **Hooks** → 类似 OpenClaw 的 cron/heartbeat 机制
- **Agents** → 类似 OpenClaw 的 sub-agent 编排

## 注意事项

⚠️ **不要叠加安装方式** — 最常见错误：先 `/plugin install`，再跑 `./install.sh --profile full`，会导致重复技能/运行时。

⚠️ **插件无法自动分发 rules** — 安装插件后仍需手动复制规则文件夹。

## 相关项目

- **NanoClaw v2** — 模型路由、技能热加载、会话分支/搜索/导出/压缩/指标
- **AgentShield** — 安全扫描工具
- **ECC Tools** — GitHub App（免费/专业/企业版）