everything-claude-code

面向AI编程agent的优化系统，为Claude Code、Cursor、Codex等agent harness提供统一的技能、规则、hooks和安全性扫描。亮点：长期迭代、兼容多平台、包含持续学习机制和AgentShield安全审计，社区活跃（182K+ stars）。

README

Everything Claude Code

Everything Claude Code — AI agent harness 性能优化系统

Shell TypeScript Python Java Perl Markdown

182K+ stars | 28K+ forks | 170+ 贡献者 | 12+ 语言生态 | Anthropic Hackathon 获奖项目

Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ

AI agent harness 的性能优化系统。源于 Anthropic hackathon 获奖项目。

不只是配置文件。它是一个完整的系统：技能（skills）、直觉（instincts）、内存优化（memory optimization）、持续学习（continuous learning）、安全扫描（security scanning）和以研究为先的开发（research-first development）。经过 10 个多月高强度的日常使用，构建真实产品而演进的生产级 agent、技能、hooks、规则、MCP 配置和旧版命令 shim。

适用于 Claude Code、Codex、Cursor、OpenCode、Gemini、GitHub Copilot 以及其他 AI agent harness。

ECC v2.0.0-rc.1 在该可复用层之上新增了公开的 Hermes operator 故事：从 Hermes 设置指南开始，然后查看 rc.1 发布说明和跨 harness 架构。

ECC Pro
私有仓库 · GitHub App · $19/席位/月

赞助
资助开源 · 从 $5/月起

社区
讨论 · 问答 · 展示与分享

GitHub App
安装 · PR 审计 · 免费套餐

开源保持免费。 本仓库永久使用 MIT 许可证。ECC Pro 是面向私有仓库的托管 GitHub App。赞助者和 Pro 订阅者支持本项目的开发工作 — 这也是为什么单一维护者能每周在 7 个 harness 上发布更新。

指南

本仓库仅包含原始代码。指南文档会解释一切。


速查指南设置、基础、理念。请先阅读此篇。	详细指南 Token 优化、内存持久化、评估、并行化。	安全指南攻击向量、沙箱、清理、CVE、AgentShield。

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

快速开始

在 2 分钟内启动并运行：

仅选择一种安装路径

大多数 Claude Code 用户应只使用一种安装路径：

推荐默认： 安装 Claude Code 插件，然后只复制你实际需要的规则文件夹。
仅在以下情况使用手动安装： 你需要更细粒度的控制、完全不想走插件路径，或者你的 Claude Code 构建无法解析自托管 marketplace 条目。
不要叠加安装方法。 最常见的损坏设置是：先运行 /plugin install，然后又运行 install.sh --profile full 或 npx ecc-install --profile full。

如果你已经叠加了多个安装并且出现重复，请直接跳到重置 / 卸载 ECC。

低上下文 / 无 hooks 路径

如果 hooks 感觉过于全局，或者你只想要 ECC 的规则、agent、命令和核心工作流技能，请跳过插件并使用最小手动配置：

./install.sh --profile minimal --target claude

.\install.ps1 --profile minimal --target claude
# 或者
npx ecc-install --profile minimal --target claude

此配置特意排除了 hooks-runtime。

如果你想要正常的核心配置但需要关闭 hooks，请使用：

./install.sh --profile core --without baseline:hooks --target claude

稍后仅在你需要运行时强制时才添加 hooks：

./install.sh --target claude --modules hooks-runtime

先找到合适的组件

如果你不确定要安装哪个 ECC 配置或组件，请从任何项目中运行打包的 advisor：

npx ecc consult "security reviews" --target claude

它会返回匹配的组件、相关配置以及预览/安装命令。如果你想在安装前检查确切的文件计划，请先使用预览命令。

对于生产 ML/MLOps 工作流，请保持安装为选择性加入且限定组件范围：

npx ecc consult "mlops training model deployment" --target claude
npx ecc install --profile minimal --target claude --with capability:machine-learning

第一步：安装插件（推荐）

注意：插件很方便，但如果你的 Claude Code 构建无法解析自托管 marketplace 条目，以下的开源安装程序仍然是更可靠的路径。

# 添加 marketplace
/plugin marketplace add https://github.com/affaan-m/everything-claude-code

# 安装插件
/plugin install ecc@ecc

命名 + 迁移说明

ECC 现在有三个公开标识符，它们不可互换：

GitHub 源仓库：affaan-m/everything-claude-code
Claude marketplace/插件标识符：ecc@ecc
npm 包：ecc-universal

这是有意为之。Anthropic marketplace/插件安装由规范的插件标识符键控，因此 ECC 使用 ecc@ecc 以使工具名称和斜杠命令命名空间足够短，以满足严格的 Desktop/API 验证器。旧帖子可能仍显示之前的长 marketplace 标识符；请仅将其视为旧别名。另外，npm 包保留为 ecc-universal，因此 npm 安装和 marketplace 安装有意使用不同的名称。

第二步：仅在需要时安装规则

警告：重要提示： Claude Code 插件无法自动分发 rules。

如果你已通过 /plugin install 安装 ECC，请勿在其后运行 ./install.sh --profile full、.\install.ps1 --profile full 或 npx ecc-install --profile full。插件已加载 ECC 技能、命令和 hooks。在插件安装后运行完整安装程序会将相同的表面复制到你的用户目录，可能导致重复技能和重复运行时行为。

对于插件安装，请手动仅复制你想要的 rules/ 目录到 ~/.claude/rules/ecc/。从 rules/common 加上一个你实际使用的语言或框架包开始。除非你显式希望将所有上下文都放入 Claude，否则不要复制所有规则目录。

仅在你进行完全手动 ECC 安装（而非插件路径）时使用完整安装程序。

如果你的本地 Claude 设置被清除或重置，这并不意味着你需要重新购买 ECC。首先运行 node scripts/ecc.js list-installed，然后运行 node scripts/ecc.js doctor 和 node scripts/ecc.js repair，然后再重新安装任何东西。这通常能恢复 ECC 管理的文件，而无需重建你的设置。如果问题是 ECC Tools 的账户或 marketplace 访问，请单独处理计费/账户恢复。

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

# 安装依赖（选择你的包管理器）
npm install        # 或：pnpm install | yarn install | bun install

# 插件安装路径：仅将 ECC 规则复制到 ECC 拥有的命名空间
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/

# 完全手动 ECC 安装路径（使用此路径而非 /plugin install）
# ./install.sh --profile full

# Windows PowerShell

# 插件安装路径：仅将 ECC 规则复制到 ECC 拥有的命名空间
New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules/ecc" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.claude/rules/ecc/"
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"

# 完全手动 ECC 安装路径（使用此路径而非 /plugin install）
# .\install.ps1 --profile full
# npx ecc-install --profile full

手动安装说明请参阅 rules/ 文件夹中的 README。手动复制规则时，请复制整个语言目录（例如 rules/common 或 rules/golang），而不是其中的文件，这样相对引用才能继续工作，并且文件名不会冲突。

完全手动安装（回退）

仅在你有意跳过插件路径时使用此方法：

./install.sh --profile full

.\install.ps1 --profile full
# 或者
npx ecc-install --profile full

如果你选择此路径，请到此为止。不要再运行 /plugin install。

重置 / 卸载 ECC

如果 ECC 感觉重复、侵入性或损坏，不要一直在其上层重新安装。

插件路径： 从 Claude Code 中移除插件，然后删除你在 ~/.claude/rules/ecc/ 下手动复制的特定规则文件夹。
手动安装程序 / CLI 路径： 从仓库根目录，先预览移除：

node scripts/uninstall.js --dry-run

然后移除 ECC 管理的文件：

node scripts/uninstall.js

你也可以使用生命周期包装器：

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run

ECC 只删除其安装状态中记录的文件。它不会删除它未安装的不相关文件。

如果你叠加了多种方法，请按此顺序清理：

移除 Claude Code 插件安装。
从仓库根目录运行 ECC 卸载命令，移除安装状态管理的文件。
删除你手动复制且不再需要的任何额外规则文件夹。
使用单一路径重新安装一次。

第三步：开始使用

# 技能是主要的工作流表面。
# 现有的斜杠式命令名称在 ECC 从 commands/ 迁移期间仍有效。

# 插件安装使用规范的命名空间形式
/ecc:plan "Add user authentication"

# 手动安装保留较短的斜杠形式：
# /plan "Add user authentication"

# 检查可用命令
/plugin list ecc@ecc

就这样！ 你现在可以访问 60 个 agent、230 个技能和 75 个旧版命令 shim。

仪表盘 GUI

启动桌面仪表盘以可视化探索 ECC 组件：

npm run dashboard
# 或者
python3 ./ecc_dashboard.py

功能：

标签式界面：Agents、Skills、Commands、Rules、Settings
深色/浅色主题切换
字体自定义（系列和大小）
标题栏和任务栏中的项目 logo
跨所有组件的搜索和过滤

多模型命令需要额外设置

警告：multi-* 命令不包含在上述基础插件/规则安装中。

要使用 /multi-plan、/multi-execute、/multi-backend、/multi-frontend 和 /multi-workflow，你还必须安装 ccg-workflow 运行时。

使用 npx ccg-workflow 初始化它。

该运行时提供这些命令所需的外部依赖，包括：

~/.claude/bin/codeagent-wrapper

~/.claude/.ccg/prompts/*

没有 ccg-workflow，这些 multi-* 命令将无法正确运行。

跨平台支持

此插件现已完全支持 Windows、macOS 和 Linux，并与主流 IDE（Cursor、OpenCode、Antigravity）和 CLI harness 紧密集成。所有 hooks 和脚本已重写为 Node.js，以实现最大兼容性。

包管理器检测

插件会自动检测你首选的包管理器（npm、pnpm、yarn 或 bun），优先级如下：

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

设置你偏好的包管理器：

# 通过环境变量
export CLAUDE_PACKAGE_MANAGER=pnpm

# 通过全局配置
node scripts/setup-package-manager.js --global pnpm

# 通过项目配置
node scripts/setup-package-manager.js --project bun

# 检测当前设置
node scripts/setup-package-manager.js --detect

或者在 Claude Code 中使用 /setup-pm 命令。

Hook 运行时控制

使用运行时标志来调整严格度或临时禁用特定 hooks：

# Hook 严格度配置（默认：standard）
export ECC_HOOK_PROFILE=standard

# 逗号分隔的要禁用的 hook ID
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

# 限制 SessionStart 附加上下文（默认：8000 字符）
export ECC_SESSION_START_MAX_CHARS=4000

# 完全禁用 SessionStart 附加上下文（适用于低上下文/本地模型设置）
export ECC_SESSION_START_CONTEXT=off

内部构成

此仓库是一个 Claude Code 插件 - 你可以直接安装或手动复制组件。

everything-claude-code/
|-- .claude-plugin/   # 插件和 marketplace 清单
|   |-- plugin.json         # 插件元数据和组件路径
|   |-- marketplace.json    # marketplace 目录，用于 /plugin marketplace add
|
|-- agents/           # 60 个用于委派的专业子 agent
|   |-- 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       # 文档同步
|   |-- docs-lookup.md       # 文档/API 查找
|   |-- chief-of-staff.md    # 沟通分类和草稿
|   |-- loop-operator.md     # 自主循环执行
|   |-- harness-optimizer.md # Harness 配置调优
|   |-- cpp-reviewer.md      # C++ 代码审查
|   |-- cpp-build-resolver.md # C++ 构建错误解决
|   |-- fsharp-reviewer.md   # F# 函数式代码审查
|   |-- go-reviewer.md       # Go 代码审查
|   |-- go-build-resolver.md # Go 构建错误解决
|   |-- python-reviewer.md   # Python 代码审查
|   |-- database-reviewer.md # 数据库/Supabase 审查
|   |-- typescript-reviewer.md # TypeScript/JavaScript 代码审查
|   |-- java-reviewer.md     # Java/Spring Boot 代码审查
|   |-- java-build-resolver.md # Java/Maven/Gradle 构建错误
|   |-- kotlin-reviewer.md   # Kotlin/Android/KMP 代码审查
|   |-- kotlin-build-resolver.md # Kotlin/Gradle 构建错误
|   |-- harmonyos-app-resolver.md # HarmonyOS/ArkTS 应用开发
|   |-- rust-reviewer.md     # Rust 代码审查
|   |-- rust-build-resolver.md # Rust 构建错误解决
|   |-- pytorch-build-resolver.md # PyTorch/CUDA 训练错误
|   |-- mle-reviewer.md      # 生产 ML 管道、评估、服务、监控审查
|
|-- skills/           # 工作流定义和领域知识
|   |-- coding-standards/           # 语言最佳实践
|   |-- clickhouse-io/              # ClickHouse 分析、查询、数据工程
|   |-- backend-pattern

_[原 README 过长已截断]_

开源项目affaan-m2026-05-10原文

打开互动版

everything-claude-code

README