The agent harness performance optimization system for Claude Code, Codex, Opencode, Cursor and beyond

项目概述

Everything Claude Code（ECC） 是一个面向 Claude Code 及兼容 AI Agent 工具的综合性能优化系统。该项目诞生于 Anthropic x Forum Ventures 黑客松冠军方案，经过 10 个月以上的日常开发实战打磨，旨在帮助开发者充分发挥 AI 编码助手的潜力。

ECC 提供了一套完整的工具链，包括生产级专业代理、可复用工作流、斜杠命令、编码规范、事件钩子和外部服务集成配置。这些组件协同工作，优化 Token 使用效率、强制代码质量标准、跨会话持久化记忆，并支持自主工作流程。

GitHub 地址： https://github.com/affaan-m/everything-claude-code

核心功能模块

1. Agents（25个专业子代理）

Agents 是带有 YAML 元数据的 Markdown 文件，定义了不同角色的专业代理。每个代理拥有特定的工具权限和指令，通过主 Claude 实例的 Task 工具调用，实现复杂的任务分解与并行处理。

代理名称	功能描述
planner.md	任务规划与实施计划生成
architect.md	系统设计与架构评估
tdd-guide.md	测试驱动开发指导
code-reviewer.md	代码质量审查
java-build-resolver.md	Java/Maven/Gradle 构建问题诊断
security-reviewer.md	安全漏洞扫描
java-reviewer.md	Java 专项代码审查
devops-engineer.md	DevOps 流程自动化

2. Skills（108个工作流定义）

Skills 封装了可复用的工作流程和领域知识，存放在 skills/*/SKILL.md 文件中。每个 Skill 包含分步骤操作程序、领域知识和有效性证明。

3. Commands（57个斜杠命令）

快速执行的提示模板，通过斜杠命令触发特定工作流程：

命令	功能
/plan	生成实施计划
/tdd	启动 TDD 开发流程
/verify	运行验证循环（构建 → 类型检查 → Lint → 测试 → Git）
/checkpoint	保存验证状态快照
/eval	执行评估测试
/setup-pm	配置项目包管理器

4. Rules（多语言编码规范）

分层的编码约束规则，分为通用规则和语言特定规则。Rules 在每个会话中自动加载，确保一致的代码风格和质量标准。

5. Hooks（事件驱动自动化）

Hooks 在工具执行生命周期中拦截事件，实现验证、质量控制和安全管理。ECC 支持 8 种 Hook 事件类型，覆盖完整的开发流程。

事件类型	触发时机	可阻止操作
PreToolUse	工具执行前	是（exit 2）
PostToolUse	工具执行后	否
SessionStart	会话初始化	否
SessionEnd	会话终止	否
PreCompact	上下文压缩前	否
Stop	每次 Claude 响应后	否
Notification	通知触发	否
UserPromptSubmit	用户提交提示	否

核心 Hook 实现

• post-edit-format.js：自动格式化代码（Biome/Prettier）
• post-edit-typecheck.js：运行 TypeScript 类型检查
• post-edit-console-warn.js：检测调试遗留的 console.log
• insaits-security-monitor.py：安全扫描（凭证暴露、提示注入检测）
• session-start.js：加载前一会话上下文
• session-end.js：会话摘要提取与跨会话记忆

6. MCPs（模型上下文协议）

通过 mcp-configs/ 目录配置外部服务集成，支持 GitHub、PostgreSQL、文件系统等工具连接。

连续学习系统

ECC 内置 Continuous Learning v2 架构，使 Agent 能够从历史会话中持续学习和进化。这套系统模拟人类学习过程，将开发经验转化为可复用的行为模式。

安装与配置

前置要求

要求	验证命令	最低版本
Git	git --version	任意现代版本
Claude Code CLI	claude --version	v2.1.0+
Shell	bash --version	Bash 4.0+
Node.js（Hooks）	node --version	v18+

方法一：插件市场安装（推荐）

# 通过 Claude Code 插件市场一键安装
claude plugin install everything-claude-code

方法二：install.sh 脚本安装

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

# 进入目录
cd everything-claude-code

# 执行安装脚本（支持 Claude Code / Cursor / OpenCode / Codex）
./install.sh --target claude

# 或针对特定语言栈
./install.sh --target claude --languages typescript,python

方法三：手动安装

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

# 2. 复制核心组件到全局配置
mkdir -p ~/.claude
cp -r agents/ ~/.claude/
cp -r skills/ ~/.claude/
cp -r commands/ ~/.claude/
cp -r rules/ ~/.claude/
cp -r scripts/hooks/ ~/.claude/hooks/

# 3. 配置 Hooks（合并 hooks.json 到 settings.json）
# 编辑 ~/.claude/settings.json 添加 hooks 配置

Windows 安装

# PowerShell 安装脚本
.\install.ps1 -Target claude -Languages typescript,python

验证安装

安装完成后，运行内置目录检查工具验证组件是否正确识别：

node scripts/ci/catalog.js

该脚本扫描 agents/、commands/ 和 skills/ 目录，并将组件数量与文档中的定义进行对比。

配置文件结构

ECC 使用多层配置目录结构，支持全局配置（用户级别）和项目特定配置（仓库级别）：

包管理器自动检测

ECC 内置智能包管理器检测系统，优先级如下：

1. 环境变量：CLAUDE_PACKAGE_MANAGER
2. 项目配置文件：.claude/package-manager.json
3. 本地清单文件：package.json 字段或锁文件
4. 全局配置：~/.claude/package-manager.json

支持的包管理器：npm、pnpm、yarn、bun、pip、poetry、maven、gradle 等。

Context Window 管理

MCP 服务器会消耗 Context Window 空间，过多的 MCP 会导致有效上下文从 200k tokens 下降到约 70k。ECC 建议：

指标	建议值
配置的 MCP 数量	20-30
启用的 MCP 数量	5-10
活跃工具数量	< 50

开发工作流示例

完整功能开发流程

# 1. 使用 /plan 命令规划任务
/plan 实现用户认证模块

# 2. 切换到 TDD 模式
/tdd

# 3. Agent 会先编写失败的测试用例
# 4. 实现功能并通过测试
# Agent 会逐步实现功能直到测试通过

# 5. 使用 /verify 验证
/verify
# 执行：构建 → 类型检查 → Lint → 测试 → Git 提交

代码审查流程

# 使用代码审查代理
@code-reviewer

# 或使用安全审查代理
@security-reviewer

会话保存与恢复

# 结束会话时，Hook 自动保存会话摘要
# 下次启动时，session-start hook 自动加载历史上下文

# 手动保存检查点
/checkpoint

安全特性

ECC 内置 AgentShield 安全扫描器，提供多层次的安全防护：

跨平台支持

平台	配置目录	特性支持
Claude Code	~/.claude/	全部功能
Cursor IDE	.cursor/rules/	Rules、Hooks
OpenCode	.opencode/	Rules、Commands
Codex CLI	.codex/	Rules、Commands

测试与质量保证

ECC 维护高标准的质量体系：

• 测试覆盖率要求：最低 80%
• 验证套件：自动化脚本验证每个代理、命令、技能和规则
• CI 流程：跨 Node.js 多版本、多操作系统测试
• 静态分析：102 条静态分析规则

# 运行全部测试
node tests/run-all.js

# 运行特定测试
node tests/hooks/hooks.test.js

# 验证 Hooks 配置
node scripts/ci/validate-hooks.js

适用场景

ECC 适用于以下场景：