Everything Claude Code 完全指南：AI 代理 Harness 性能优化系统

写在前面：这是 Anthropic x Forum Ventures 黑客马拉松的获奖项目，经过 10+ 个月构建真实产品的密集使用演化而来。50K+ Stars，6K+ Forks，30+ 贡献者，支持 5 种编程语言。

一、什么是 Everything Claude Code？

1.1 核心定位

Everything Claude Code (ECC) 是一个AI 代理 Harness 性能优化系统，提供：

✅ Skills（技能） - 工作流定义和领域知识
✅ Instincts（直觉） - 基于直觉的学习系统
✅ Memory（记忆） - 跨会话持久化
✅ Security（安全） - 安全扫描和检查
✅ Research-first（研究优先） - 先研究后开发

不是配置文件集合，而是一个完整的系统。

GitHub 项目：https://github.com/affaan-m/everything-claude-code
官方文档：https://ecc.tools
安装指南：https://github.com/affaan-m/everything-claude-code

1.2 核心优势

优势	说明
生产验证	在多个生产应用中经过实战测试
跨 Harness	支持 Claude Code、Codex、Cursor、OpenCode
持续学习	自动从会话中提取模式到可重用技能
内存持久化	跨会话自动保存/加载上下文
验证循环	持续评估、评分器、pass@k 指标
并行化	Git worktrees、级联方法、多实例扩展
子代理编排	迭代检索模式，解决上下文问题

1.3 适用场景

场景	说明
Token 优化	模型选择、系统提示精简、后台进程
内存持久化	跨会话保存/加载上下文的钩子
持续学习	从会话中自动提取模式到可重用的技能
验证循环	检查点 vs 持续评估、评分器类型、pass@k 指标
并行化	Git worktrees、级联方法、何时扩展实例
子代理编排	上下文问题、迭代检索模式

二、快速开始

2.1 系统要求

系统	要求
Claude Code	已安装并登录
Node.js	16+
包管理器	npm/pnpm/yarn/bun
Git	已安装
内存	4GB+

2.2 安装步骤

方法 1：插件安装（推荐）

# 1. 添加市场
/plugin marketplace add affaan-m/everything-claude-code

# 2. 安装插件
/plugin install everything-claude-code@everything-claude-code

# 3. 验证安装
/plugin list everything-claude-code@everything-claude-code

✨ 完成！你现在可以使用 16 个代理、65 个技能和 40 个命令。

方法 2：手动安装

# 1. 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# 2. 复制代理
cp agents/*.md ~/.claude/agents/

# 3. 复制规则（通用 + 语言特定）
cp -r rules/common/* ~/.claude/rules/
cp -r rules/typescript/* ~/.claude/rules/  # 选择你的技术栈
cp -r rules/python/* ~/.claude/rules/
cp -r rules/golang/* ~/.claude/rules/
cp -r rules/perl/* ~/.claude/rules/

# 4. 复制命令
cp commands/*.md ~/.claude/commands/

# 5. 复制技能
cp -r skills/* ~/.claude/skills/

# 6. 复制钩子配置
# 将 hooks/hooks.json 中的钩子复制到 ~/.claude/settings.json

2.3 验证安装

# 尝试一个命令
/plan "添加用户认证"

# 查看可用命令
/plugin list everything-claude-code@everything-claude-code

# 查看可用代理
/agents list

# 查看可用技能
/skills list

三、核心组件详解

3.1 项目结构

everything-claude-code/
├── .claude-plugin/        # 插件和市场清单
│   ├── plugin.json        # 插件元数据
│   └── marketplace.json   # 市场目录
│
├── agents/                # 专业子代理（16 个）
│   ├── planner.md         # 功能实现规划
│   ├── architect.md       # 系统设计决策
│   ├── tdd-guide.md       # 测试驱动开发
│   ├── code-reviewer.md   # 质量和安全审查
│   ├── security-reviewer.md # 漏洞分析
│   ├── build-error-resolver.md
│   ├── e2e-runner.md      # Playwright E2E 测试
│   ├── refactor-cleaner.md # 死代码清理
│   ├── doc-updater.md     # 文档同步
│   ├── go-reviewer.md     # Go 代码审查
│   ├── go-build-resolver.md # Go 构建错误解决
│   └── ...
│
├── skills/                # 工作流定义和领域知识（65+）
│   ├── coding-standards/  # 语言最佳实践
│   ├── backend-patterns/  # API、数据库、缓存模式
│   ├── frontend-patterns/ # React、Next.js 模式
│   ├── continuous-learning/ # 自动提取模式
│   ├── continuous-learning-v2/ # 基于直觉的学习
│   ├── iterative-retrieval/ # 渐进式上下文细化
│   ├── strategic-compact/ # 压缩建议
│   ├── tdd-workflow/      # TDD 方法论
│   ├── security-review/   # 安全检查清单
│   ├── eval-harness/      # 验证循环评估
│   ├── verification-loop/ # 持续验证
│   └── ...
│
├── commands/              # 斜杠命令（40+）
│   ├── tdd.md             # /tdd - 测试驱动开发
│   ├── plan.md            # /plan - 实现规划
│   ├── e2e.md             # /e2e - E2E 测试生成
│   ├── code-review.md     # /code-review - 质量审查
│   ├── build-fix.md       # /build-fix - 修复构建错误
│   ├── refactor-clean.md  # /refactor-clean - 死代码移除
│   ├── learn.md           # /learn - 会话中提取模式
│   ├── checkpoint.md      # /checkpoint - 保存验证状态
│   ├── verify.md          # /verify - 运行验证循环
│   └── ...
│
├── rules/                 # 始终遵循的指南
│   ├── README.md          # 安装指南
│   ├── common/            # 通用原则（8 个）
│   │   ├── coding-style.md
│   │   ├── git-workflow.md
│   │   ├── testing.md
│   │   ├── performance.md
│   │   ├── patterns.md
│   │   ├── hooks.md
│   │   ├── agents.md
│   │   └── security.md
│   ├── typescript/        # TS/JS特定
│   ├── python/            # Python 特定
│   ├── golang/            # Go 特定
│   └── perl/              # Perl 特定
│
├── hooks/                 # 基于触发器的自动化
│   ├── hooks.json         # 所有钩子配置
│   ├── memory-persistence/ # 会话生命周期钩子
│   └── strategic-compact/ # 压缩建议
│
├── scripts/               # 跨平台 Node.js 脚本
│   ├── lib/
│   │   ├── utils.js
│   │   └── package-manager.js
│   └── hooks/
│       ├── session-start.js
│       ├── session-end.js
│       └── ...
│
├── tests/                 # 测试套件（997 个测试）
│   ├── lib/
│   ├── hooks/
│   └── run-all.js
│
├── contexts/              # 动态系统提示注入
│   ├── dev.md
│   ├── review.md
│   └── research.md
│
├── mcp-configs/           # MCP 服务器配置
│   └── mcp-servers.json
│
└── examples/              # 示例配置
    ├── CLAUDE.md
    └── user-CLAUDE.md

3.2 代理系统（16 个）

核心代理

代理	用途	模型
planner	功能实现规划	opus
architect	系统设计决策	opus
tdd-guide	测试驱动开发	sonnet
code-reviewer	质量和安全审查	sonnet
security-reviewer	漏洞分析	opus

专用代理

代理	用途
build-error-resolver	修复构建错误
e2e-runner	Playwright E2E 测试
refactor-cleaner	死代码清理
doc-updater	文档同步
go-reviewer	Go 代码审查
go-build-resolver	Go 构建错误解决
python-reviewer	Python 代码审查
database-reviewer	数据库/Supabase 审查

使用示例：

# 委托给规划代理
@planner "实现用户认证功能"

# 委托给架构代理
@architect "设计微服务架构"

# 委托给代码审查代理
@code-reviewer "审查这个 PR"

3.3 技能系统（65+）

核心技能

技能	说明
continuous-learning	从会话中自动提取模式
continuous-learning-v2	基于直觉的学习与置信度评分
iterative-retrieval	子代理的渐进式上下文细化
strategic-compact	手动压缩建议
tdd-workflow	TDD 方法论
security-review	安全检查清单
eval-harness	验证循环评估
verification-loop	持续验证

语言特定技能

技能	说明
golang-patterns	Go 惯用语和最佳实践
golang-testing	Go 测试模式、TDD、基准测试
python-patterns	Python 惯用语和最佳实践
python-testing	Python 测试 with pytest
springboot-patterns	Java Spring Boot 模式
django-patterns	Django 模式
cpp-coding-standards	C++ 编码标准
perl-patterns	Modern Perl 5.36+ 惯用语

业务技能（新增）

技能	说明
frontend-slides	HTML 演示文稿构建器
article-writing	长文写作
content-engine	多平台内容引擎
market-research	市场和竞争者研究
investor-materials	融资材料
investor-outreach	投资者外联

使用示例：

# 调用技能
/skill continuous-learning

# 运行 TDD 工作流
/tdd

# 运行验证循环
/verify

3.4 命令系统（40+）

开发命令

命令	说明
`/plan`	实现规划
`/tdd`	测试驱动开发
`/e2e`	E2E 测试生成
`/code-review`	质量审查
`/build-fix`	修复构建错误
`/refactor-clean`	死代码移除

学习命令

命令	说明
`/learn`	会话中提取模式
`/learn-eval`	提取、评估和保存模式
`/checkpoint`	保存验证状态
`/verify`	运行验证循环

直觉命令（持续学习 v2）

命令	说明
`/instinct-status`	查看学习的直觉
`/instinct-import`	导入直觉
`/instinct-export`	导出直觉
`/evolve`	将直觉聚类到技能中
`/promote`	将项目级直觉提升为全局
`/projects`	查看已识别项目与统计

运维命令（新增）

命令	说明
`/pm2`	PM2 服务生命周期管理
`/multi-plan`	多代理任务分解
`/multi-execute`	协调多代理工作流
`/multi-backend`	后端多服务编排
`/multi-frontend`	前端多服务编排
`/multi-workflow`	通用多服务工作流

使用示例：

# 规划功能
/plan "添加用户登录功能"

# 运行 TDD
/tdd "实现用户服务"

# 代码审查
/code-review

# 提取模式
/learn

# 查看直觉
/instinct-status

# 导出直觉
/instinct-export my-instincts.json

3.5 规则系统

通用规则（8 个）

规则	说明
coding-style.md	不可变性、文件组织
git-workflow.md	提交格式、PR 流程
testing.md	TDD、80% 覆盖率要求
performance.md	模型选择、上下文管理
patterns.md	设计模式、骨架项目
hooks.md	钩子架构、TodoWrite
agents.md	何时委托给子代理
security.md	强制性安全检查

语言特定规则

语言	规则数	说明
TypeScript	15+	TS/JS 特定模式和工具
Python	10+	Python 特定模式和工具
Golang	8+	Go 特定模式和工具
Perl	6+	Perl 特定模式和工具
Swift	8+	Swift 特定模式和工具
PHP	6+	PHP 特定模式和工具

安装规则：

# 用户级规则（应用于所有项目）
cp -r rules/* ~/.claude/rules/

# 项目级规则（仅应用于当前项目）
mkdir -p .claude/rules
cp -r rules/* .claude/rules/

3.6 钩子系统

钩子架构

{
  "hooks": [
    {
      "name": "session-start",
      "trigger": "SessionStart",
      "type": "script",
      "script": "hooks/session-start.js"
    },
    {
      "name": "session-end",
      "trigger": "Stop",
      "type": "script",
      "script": "hooks/session-end.js"
    },
    {
      "name": "pre-compact",
      "trigger": "PreToolUse",
      "matcher": "tool == 'Edit'",
      "type": "script",
      "script": "hooks/pre-compact.js"
    }
  ]
}

核心钩子

钩子	触发器	说明
session-start	SessionStart	会话开始时加载上下文
session-end	Stop	会话结束时保存状态
pre-compact	PreToolUse	压缩前状态保存
suggest-compact	PostToolUse	战略性压缩建议
evaluate-session	Stop	从会话中提取模式

钩子运行时控制：

# 设置钩子配置文件
export ECC_HOOK_PROFILE=minimal  # minimal|standard|strict

# 禁用特定钩子
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

四、核心功能详解

4.1 持续学习系统

v1：基础学习

# 从会话中提取模式
/learn

# 保存到技能
/skill-create

v2：基于直觉的学习

# 查看学习的直觉
/instinct-status

# 输出示例：
📊 直觉状态

已学习直觉：25
- 高置信度 (>0.8): 15
- 中置信度 (0.5-0.8): 8
- 低置信度 (<0.5): 2

项目分布:
- project-a: 12
- project-b: 8
- global: 5

直觉工作流：

# 1. 学习直觉（自动）
# 每次会话结束时自动提取

# 2. 查看直觉
/instinct-status

# 3. 导出直觉
/instinct-export my-instincts.json

# 4. 导入直觉（从他人）
/instinct-import teammate-instincts.json

# 5. 进化直觉到技能
/evolve

# 6. 提升为全局直觉
/promote my-instinct

4.2 验证循环

检查点 vs 持续评估

# 保存验证状态
/checkpoint

# 运行验证循环
/verify

# 评估标准
/eval "代码覆盖率 > 80%"

评分器类型

评分器	说明
Pass/Fail	二元评分
Numeric	数值评分（0-100）
Rubric	多维度评分
LLM-based	LLM 评分

pass@k 指标

# 运行 pass@k 评估
/eval --pass-at-k 10 "功能正确性"

# 输出：
pass@1: 85%
pass@5: 92%
pass@10: 96%

4.3 并行化

Git worktrees

# 创建多个 worktree 并行开发
/git worktree add ../feature-a feature-a
/git worktree add ../feature-b feature-b

# 在多个 worktree 中并行开发

级联方法

1 2	# 级联执行多个任务 /cascade "任务 1" "任务 2" "任务 3"

多实例扩展

# 使用 PM2 管理多实例
/pm2 start ecosystem.config.js

# 查看状态
/pm2 status

# 重启实例
/pm2 restart all

4.4 子代理编排

上下文问题

问题：单个代理上下文有限（200K tokens）

解决方案：迭代检索模式

# 1. 主代理接收任务
# 2. 分解为子任务
# 3. 委托给子代理
# 4. 迭代检索上下文
# 5. 汇总结果

迭代检索模式

# 使用迭代检索技能
/skill iterative-retrieval

# 流程：
# 1. 初始检索（宽泛）
# 2. 评估相关性
# 3. 细化查询
# 4. 再次检索
# 5. 重复直到满足阈值

五、高级技巧

5.1 Token 优化

模型选择

# 简单任务使用 Haiku
claude --model claude-haiku "简单任务"

# 复杂任务使用 Opus
claude --model claude-opus "复杂任务"

# 平衡使用 Sonnet
claude --model claude-sonnet "中等任务"

系统提示精简

# 使用精简的系统提示
/context dev  # 开发模式
/context review  # 代码审查模式
/context research  # 研究模式

后台进程

1 2	# 使用后台进程处理耗时任务 & /long-running-task

5.2 内存持久化

会话生命周期钩子

# 会话开始：自动加载上下文
# hooks/session-start.js

# 会话结束：自动保存状态
# hooks/session-end.js

战略压缩

# 建议压缩
/suggest-compact

# 手动压缩
/compact "压缩这个会话"

5.3 MCP 配置

最佳实践

⚠️ 不要一次启用所有 MCP

经验法则：
- 配置 20-30 个 MCP
- 每个项目保持启用少于 10 个
- 活动工具少于 80 个

在项目配置中使用 disabledMcpServers 来禁用未使用的。

5.4 包管理器配置

自动检测

1 2	# 检测当前包管理器 node scripts/setup-package-manager.js --detect

手动设置

# 全局设置
node scripts/setup-package-manager.js --global pnpm

# 项目设置
node scripts/setup-package-manager.js --project bun

# 环境变量
export CLAUDE_PACKAGE_MANAGER=pnpm

优先级

环境变量：CLAUDE_PACKAGE_MANAGER
项目配置：.claude/package-manager.json
package.json: packageManager 字段
锁文件检测
全局配置：~/.claude/package-manager.json
回退：第一个可用的包管理器

六、实战案例

6.1 快速原型开发

# 1. 规划功能
/plan "创建博客系统，包含用户、文章、评论功能"

# 2. 架构设计
@architect "设计博客系统架构"

# 3. TDD 开发
/tdd "实现用户模型"
/tdd "实现文章 CRUD"
/tdd "实现评论系统"

# 4. 代码审查
/code-review

# 5. E2E 测试
/e2e "博客系统完整流程"

# 6. 文档更新
/update-docs

6.2 Bug 修复流程

# 1. 定位问题
"分析错误日志，定位问题"

# 2. 修复 Bug
/build-fix "修复登录接口 500 错误"

# 3. 添加测试
/tdd "添加回归测试"

# 4. 验证修复
/verify "登录功能正常"

# 5. 提取教训
/learn "从这次 Bug 中学到什么"

6.3 代码重构

# 1. 分析代码质量
/code-review "分析这个模块的技术债务"

# 2. 制定重构计划
/plan "重构用户服务，使用依赖注入"

# 3. 执行重构
/refactor-clean "提取公共函数"
/refactor-clean "拆分大文件"

# 4. 验证功能
/verify "所有测试通过"

# 5. 更新文档
/update-docs

6.4 持续学习工作流

# 日常开发
# ... 正常工作 ...

# 会话结束：自动提取模式
# hooks/session-end.js 自动运行

# 定期回顾
/instinct-status  # 查看学习的直觉

# 导出分享
/instinct-export team-instincts.json

# 导入团队智慧
/instinct-import best-practices.json

# 进化到技能
/evolve

七、测试与质量保证

7.1 运行测试

# 运行所有测试
node tests/run-all.js

# 运行单个测试文件
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

# 输出示例：
✓ 997 tests passing
✓ Full suite green after hook/runtime refactor

7.2 测试覆盖率

# 运行测试覆盖率
/test-coverage

# 输出示例：
代码覆盖率：92%
- 代理：95%
- 技能：90%
- 命令：93%
- 钩子：89%

7.3 质量门禁

# 运行质量门禁
/quality-gate

# 检查项：
✓ 代码覆盖率 > 80%
✓ 所有测试通过
✓ 无 ESLint 错误
✓ 无 TypeScript 错误
✓ 文档已更新

八、故障排查

8.1 安装问题

Q: 插件安装失败？

# 清除缓存
rm -rf ~/.claude/cache

# 重新安装
/plugin uninstall everything-claude-code
/plugin install everything-claude-code@everything-claude-code

Q: 命令不识别？

# 检查插件状态
/plugin list

# 重新加载
/plugin reload everything-claude-code

8.2 钩子问题

Q: 钩子不触发？

# 检查钩子配置
cat ~/.claude/settings.json | jq '.hooks'

# 检查钩子文件
ls -la ~/.claude/hooks/

# 启用钩子日志
export ECC_HOOK_PROFILE=strict

Q: 钩子报错？

# 查看钩子日志
cat ~/.claude/logs/hooks.log

# 禁用特定钩子
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder"

8.3 性能问题

Q: 响应变慢？

# 检查 MCP 数量
# 如果启用了太多 MCP，可能缩小上下文窗口

# 禁用未使用的 MCP
# 在项目配置中使用 disabledMcpServers

# 清理会话
/compact "压缩这个会话"

Q: 内存占用过高？

# 重启 Claude Code
claude quit

# 清除缓存
rm -rf ~/.claude/cache

# 重新启动
claude

九、贡献指南

9.1 贡献类型

欢迎以下贡献：

✅ 特定语言的技能（Rust、C#、Kotlin、Java）
✅ 特定框架的配置（Django、Rails、Laravel）
✅ DevOps 代理（Kubernetes、Terraform、AWS）
✅ 测试策略（不同框架）
✅ 特定领域的知识（ML、数据工程、移动）

9.2 提交 PR

# 1. Fork 项目
# 2. 创建分支
git checkout -b feature/my-skill

# 3. 添加技能/代理/命令
# 4. 编写测试
# 5. 提交 PR

# PR 模板见 CONTRIBUTING.md

9.3 测试要求

# 所有 PR 必须：
✓ 通过现有测试
✓ 添加新测试（如适用）
✓ 代码覆盖率不下降
✓ 文档已更新

十、总结

10.1 核心要点

完整系统 - 不是配置文件，而是生产级性能优化系统
持续学习 - 自动从会话中提取模式到可重用技能
验证循环 - 持续评估确保代码质量
跨 Harness - 支持 Claude Code、Codex、Cursor、OpenCode
社区驱动 - 30+ 贡献者，5 种语言支持

10.2 使用建议

从简单开始 - 先安装基础组件，逐步添加
定制配置 - 根据你的技术栈修改
删除未使用 - 保持配置精简
贡献回馈 - 分享你的技能和经验

10.3 学习资源

资源	链接
精简指南	https://x.com/affaanmustafa/status/2012378465664745795
详细指南	https://x.com/affaanmustafa/status/2014040193557471352
官方文档	https://ecc.tools
GitHub 项目	https://github.com/affaan-m/everything-claude-code
作者 Twitter	@affaanmustafa

参考资源

本文是 AI 工具系列的特别篇，详细介绍了 Everything Claude Code 性能优化系统。感谢 @affaan-m 和 30+ 贡献者的杰出工作！

Everything Claude Code 完全指南：AI 代理 Harness 性能优化系统

一、什么是 Everything Claude Code？

1.1 核心定位

1.2 核心优势

1.3 适用场景

二、快速开始

2.1 系统要求

2.2 安装步骤

方法 1：插件安装（推荐）

方法 2：手动安装

2.3 验证安装

三、核心组件详解

3.1 项目结构

3.2 代理系统（16 个）

核心代理

专用代理

3.3 技能系统（65+）

核心技能

语言特定技能

业务技能（新增）

3.4 命令系统（40+）

开发命令

学习命令

直觉命令（持续学习 v2）

运维命令（新增）

3.5 规则系统

通用规则（8 个）

语言特定规则

3.6 钩子系统

钩子架构

核心钩子

四、核心功能详解

4.1 持续学习系统

v1：基础学习

v2：基于直觉的学习

4.2 验证循环

检查点 vs 持续评估

评分器类型

pass@k 指标

4.3 并行化

Git worktrees

级联方法

多实例扩展

4.4 子代理编排

上下文问题

迭代检索模式

五、高级技巧

5.1 Token 优化

模型选择

系统提示精简

后台进程

5.2 内存持久化

会话生命周期钩子

战略压缩

5.3 MCP 配置

推荐配置

最佳实践

5.4 包管理器配置

自动检测

手动设置

优先级

六、实战案例

6.1 快速原型开发

6.2 Bug 修复流程

6.3 代码重构

6.4 持续学习工作流

七、测试与质量保证

7.1 运行测试

7.2 测试覆盖率

7.3 质量门禁

八、故障排查

8.1 安装问题

8.2 钩子问题

8.3 性能问题

九、贡献指南

9.1 贡献类型

9.2 提交 PR

9.3 测试要求

十、总结

10.1 核心要点