Everything Claude Code 文档

王小酱
97 阅读12分钟

一、项目概述

Everything Claude Code（ECC） 是一个 AI Agent 工作框架性能优化系统，由 Anthropic Hackathon 获奖者 Affaan Mustafa 开发，历经 10 个月以上的生产环境实战积累。

它不只是配置文件的集合，而是一套完整的系统，包含：

  • Skills（技能）：可复用的工作流定义
  • Instincts（直觉）：持续学习，自动从会话中提取模式
  • Memory Optimization（记忆优化）：跨会话上下文持久化
  • Security Scanning（安全扫描）：AgentShield 集成，102 条规则
  • Research-first Development（研究优先开发）：先调研再编码

支持平台：Claude Code、Codex CLI、Cursor IDE、OpenCode、Cowork 及其他 AI Agent 工作框架。

二、核心架构

目录结构总览

everything-claude-code/
├── .claude-plugin/         # 插件和市场清单（plugin.json, marketplace.json）
├── agents/                 # 13 个专业子代理（.md 文件）
├── .agents/skills/         # 技能定义（SKILL.md + openai.yaml）
├── commands/               # 32 个斜杠命令（.md 文件）
├── rules/                  # 编码规范（common/ + typescript/ + python/ + golang/）
├── hooks/                  # 触发式自动化（hooks.json + 脚本）
├── scripts/                # 跨平台 Node.js 脚本
├── contexts/               # 动态系统提示注入上下文
├── examples/               # CLAUDE.md 配置示例（Next.js、Go、Django 等）
├── mcp-configs/            # MCP 服务器配置（GitHub、Supabase、Vercel 等）
├── .cursor/                # Cursor IDE 适配层
├── .codex/                 # Codex CLI 适配层
├── .opencode/              # OpenCode 适配层
└── docs/                   # 完整文档

三、快速开始（2 分钟上手）

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

# 添加为市场源
/plugin marketplace add affaan-m/everything-claude-code

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

或者直接在 ~/.claude/settings.json 中添加：

{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

步骤二：安装规则（必须手动）

⚠️ Claude Code 插件系统不支持自动分发规则文件，需手动安装。

git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# 使用安装脚本（推荐）
./install.sh typescript          # TypeScript 项目
./install.sh python              # Python 项目
./install.sh typescript python   # 多语言项目

# 针对 Cursor
./install.sh --target cursor typescript

步骤三：开始使用

# 规划新功能
/everything-claude-code:plan "Add user authentication"

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

安装完成后你即可使用：13 个 Agents + 56 个 Skills + 32 个 Commands。

四、核心模块详解

4.1 Agents（专业子代理）—— 13 个

Agent描述
planner功能实现规划
architect系统设计决策
tdd-guide测试驱动开发指导
code-reviewer代码质量与安全审查
security-reviewer漏洞分析（OWASP Top 10）
build-error-resolver构建错误修复
e2e-runnerPlaywright E2E 测试
refactor-cleaner死代码清理
doc-updater文档同步更新
go-reviewerGo 代码审查
go-build-resolverGo 构建错误修复
python-reviewerPython 代码审查
database-reviewer数据库/Supabase 审查

调用示例：

/everything-claude-code:plan "Add OAuth authentication"  # 触发 planner
/code-review                                              # 触发 code-reviewer
/security-scan                                            # 触发 security-reviewer

4.2 Skills（技能库）—— 56+ 个

Skills 是可复用的工作流定义，按领域分类：

通用开发：

  • coding-standards — 语言最佳实践
  • tdd-workflow — TDD 方法论（先写测试，80% 覆盖率）
  • security-review — 安全检查清单
  • eval-harness / verification-loop — 验证循环评估
  • search-first — 先调研再编码工作流
  • api-design — REST API 设计与分页、错误响应
  • deployment-patterns — CI/CD、Docker、健康检查、回滚

前端：

  • frontend-patterns — React、Next.js 模式
  • frontend-slides — 零依赖 HTML 演示文稿（含 PPTX 转换）
  • e2e-testing — Playwright E2E 测试 + Page Object Model

后端 & 数据库：

  • backend-patterns — API、数据库、缓存模式
  • clickhouse-io — ClickHouse 分析查询
  • postgres-patterns — PostgreSQL 优化
  • database-migrations — Prisma、Drizzle、Django、Go 迁移
  • docker-patterns — Docker Compose、网络、卷、容器安全

Python / Django：

  • django-patterns / django-security / django-tdd / django-verification
  • python-patterns / python-testing

Java Spring Boot：

  • springboot-patterns / springboot-security / springboot-tdd / springboot-verification
  • java-coding-standards / jpa-patterns

Go：

  • golang-patterns / golang-testing

Swift / iOS：

  • swift-actor-persistence — 基于 Actor 的线程安全数据持久化
  • swift-protocol-di-testing — 协议依赖注入可测试 Swift 代码
  • liquid-glass-design — iOS 26 Liquid Glass 设计系统
  • foundation-models-on-device — Apple 设备端 LLM
  • swift-concurrency-6-2 — Swift 6.2 并发特性

C++：

  • cpp-coding-standards — C++ Core Guidelines
  • cpp-testing — GoogleTest + CMake/CTest

学习与优化：

  • continuous-learning / continuous-learning-v2 — 自动从会话提取模式（含置信度评分）
  • strategic-compact — 手动压缩建议
  • cost-aware-llm-pipeline — LLM 成本优化、模型路由、预算追踪
  • iterative-retrieval — 子代理的渐进式上下文精炼

内容创作（新增）：

  • article-writing — 无 AI 腔调的长文写作
  • content-engine — 多平台社交内容工作流
  • market-research — 带来源标注的市场研究
  • investor-materials — 融资 Pitch Deck、备忘录、财务模型
  • investor-outreach — 个性化融资外联与跟进

4.3 Commands（斜杠命令）—— 32 个

开发流程：

命令用途
/plan "..."创建功能实现计划
/tdd强制执行 TDD 工作流
/code-review审查代码变更
/build-fix修复构建错误
/e2e生成 E2E 测试
/refactor-clean清除死代码
/security-scan安全漏洞扫描
/test-coverage测试覆盖率分析

Go 专项：

命令用途
/go-reviewGo 代码审查
/go-testGo TDD 工作流
/go-build修复 Go 构建错误

多代理编排：

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

持续学习系统：

命令用途
/learn会话中提取模式
/learn-eval提取、评估并保存模式
/instinct-status查看已学习的直觉（含置信度）
/instinct-import <file>导入他人直觉
/instinct-export导出直觉供分享
/evolve将相关直觉聚类为技能

其他实用命令：

命令用途
/checkpoint保存验证状态
/verify运行验证循环
/eval按标准评估
/sessions会话历史管理
/update-docs更新文档
/skill-create从 Git 历史生成技能
/setup-pm配置包管理器

4.4 Hooks（触发式自动化）

Hooks 在工具事件发生时自动触发，示例：

{
  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\.(ts|tsx|js|jsx)$\"",
  "hooks": [{
    "type": "command",
    "command": "grep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
  }]
}

内置 Hook 脚本（Node.js，全平台兼容）：

  • session-start.js — 会话开始时自动加载上下文
  • session-end.js — 会话结束时自动保存状态
  • pre-compact.js — 压缩前保存状态
  • suggest-compact.js — 建议压缩时机
  • evaluate-session.js — 从会话中提取模式

4.5 Rules（编码规范）

按语言分目录组织，安装时按需选择：

rules/
├── common/            # 通用原则（必装）
│   ├── coding-style.md    # 不可变性、文件组织
│   ├── git-workflow.md    # Commit 格式、PR 流程
│   ├── testing.md         # TDD、80% 覆盖率要求
│   ├── performance.md     # 模型选择、上下文管理
│   ├── patterns.md        # 设计模式
│   ├── hooks.md           # Hook 架构
│   ├── agents.md          # 子代理委托时机
│   └── security.md        # 强制安全检查
├── typescript/        # TypeScript/JavaScript 专项
├── python/            # Python 专项
└── golang/            # Go 专项

五、生态工具

5.1 AgentShield — 安全审计工具

在 Anthropic x Cerebral Valley Hackathon（2026年2月） 上构建，1282 个测试，98% 覆盖率，102 条静态分析规则。

# 快速扫描（无需安装）
npx ecc-agentshield scan

# 自动修复安全问题
npx ecc-agentshield scan --fix

# 深度分析（三个 Opus 4.6 代理：红队/蓝队/审计员）
npx ecc-agentshield scan --opus --stream

# 从零生成安全配置
npx ecc-agentshield init

扫描范围： CLAUDE.md、settings.json、MCP 配置、hooks、agent 定义、skills，覆盖 5 大类别：

  • 密钥检测（14 种模式）
  • 权限审计
  • Hook 注入分析
  • MCP 服务器风险评估
  • Agent 配置审查

输出格式： 终端彩色（A-F 评级）、JSON（CI 管道）、Markdown、HTML。

--opus 模式会运行三个 Claude Opus 4.6 代理组成红队/蓝队/审计员流水线：攻击者寻找漏洞链，防御者评估保护，审计员综合出优先级风险报告。这是对抗性推理，而非单纯的模式匹配。

在 Claude Code 中直接运行：/security-scan

5.2 Skill Creator — 技能生成器

方式 A：本地分析（内置）

/skill-create                  # 分析当前仓库
/skill-create --instincts      # 同时生成直觉

方式 B：GitHub App（高级）

适用于 10k+ commits、自动 PR、团队共享：

  • 安装：github.com/marketplace…
  • 在任意 Issue 中评论：/skill-creator analyze
  • 支持 push 到主分支时自动触发

5.3 持续学习系统 v2

/instinct-status    # 查看已学习的直觉及置信度
/instinct-import    # 导入他人的直觉
/instinct-export    # 导出自己的直觉分享给团队
/evolve             # 将相关直觉聚类成可复用技能

六、多平台支持详情

6.1 各平台功能对比

功能Claude CodeCursor IDECodex CLIOpenCode
Agents✅ 13 个共享（AGENTS.md）共享✅ 12 个
Commands✅ 33 个共享指令式✅ 24 个
Skills✅ 50+共享10 个✅ 37 个
Hook 事件数8 种15 种❌ 暂不支持11 种
Rules✅ 29 条✅ 29 条（YAML）指令式13 条
MCP 服务器✅ 14 个共享4 个完整
自定义工具通过 Hook通过 Hook❌✅ 6 个原生

6.2 Cursor IDE 快速接入

./install.sh --target cursor typescript
./install.sh --target cursor python golang swift

Cursor 的 Hook 使用 DRY 适配器模式，adapter.js 将 Cursor 的 stdin JSON 转换为 Claude Code 格式，复用现有脚本无需重写。

关键 Hook：

  • beforeShellExecution — 阻止在 tmux 外启动开发服务器，审查 git push
  • afterFileEdit — 自动格式化 + TypeScript 检查 + console.log 警告
  • beforeSubmitPrompt — 检测提示词中的密钥（sk-、ghp_、AKIA 等）
  • beforeTabFileRead — 阻止读取 .env、.key、.pem 文件

6.3 Codex CLI 快速接入

cp .codex/config.toml ~/.codex/config.toml
codex  # AGENTS.md 自动被检测

⚠️ Codex CLI 暂不支持 Hooks（GitHub Issue #2109，430+ 赞），安全策略通过 persistent_instructions 和沙箱权限系统实现。

6.4 OpenCode 快速接入

npm install -g opencode
opencode  # 从仓库根目录运行，自动检测 .opencode/opencode.json

OpenCode 的插件系统比 Claude Code 更强大，支持 20+ 事件类型（包括 file.edited、message.updated、lsp.client.diagnostics 等）。

七、Token 优化指南

推荐配置（加入 ~/.claude/settings.json）

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}
设置默认值推荐值效果
modelopussonnet约降低 60% 成本
MAX_THINKING_TOKENS31,99910,000约降低 70% 隐藏推理成本
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE9550更早压缩，长会话质量更好

日常工作流命令

命令使用时机
/model sonnet默认，适用于大多数任务
/model opus复杂架构设计、深度调试
/clear切换到无关联任务时（免费、即时重置）
/compact完成里程碑后、开始下一任务前
/cost监控会话中的 Token 消耗

上下文窗口管理

⚠️ 不要同时启用所有 MCP 服务器。 每个 MCP 工具描述都会消耗 200k 上下文窗口中的 Token，可能将可用上下文压缩到 ~70k。

// 在项目 .claude/settings.json 中禁用不需要的 MCP
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

建议：每个项目启用 不超过 10 个 MCP，活跃工具不超过 80 个。

八、典型工作流示例

开发新功能

# 1. 规划
/everything-claude-code:plan "Add user authentication with OAuth"
# → planner 代理创建实现蓝图

# 2. 测试驱动开发
/tdd
# → tdd-guide 强制先写测试

# 3. 代码审查
/code-review
# → code-reviewer 检查回归问题

修复 Bug

# 1. 写一个能复现 bug 的失败测试
/tdd
# → tdd-guide：先写失败测试

# 2. 实现修复，验证测试通过

# 3. 审查
/code-review
# → code-reviewer：捕获潜在回归

上线前检查

/security-scan      # → 安全漏洞审计（OWASP Top 10）
/e2e                # → 关键用户流程 E2E 测试
/test-coverage      # → 验证 80%+ 覆盖率

代理选择速查表

我想要...使用命令调用代理
规划新功能/plan "Add auth"planner
系统架构设计/plan + 架构师模式architect
TDD 写代码/tddtdd-guide
审查刚写的代码/code-reviewcode-reviewer
修复失败构建/build-fixbuild-error-resolver
E2E 测试/e2ee2e-runner
安全漏洞扫描/security-scansecurity-reviewer
清理死代码/refactor-cleanrefactor-cleaner
更新文档/update-docsdoc-updater
审查 Go 代码/go-reviewgo-reviewer
审查 Python 代码/python-reviewpython-reviewer

九、版本更新历史

v1.7.0（2026年2月）— 跨平台扩展 + 演示文稿构建器

  • Codex app + CLI 支持 — 基于 AGENTS.md 的直接 Codex 支持
  • frontend-slides 技能 — 零依赖 HTML 演示文稿构建器，含 PPTX 转换指导
  • 5 个新通用业务技能 — article-writing、content-engine、market-research、investor-materials、investor-outreach
  • 更广泛的工具覆盖 — Cursor、Codex 和 OpenCode 支持更完善
  • 992 内部测试 — 扩展了插件、Hooks、技能和打包的验证覆盖

v1.6.0（2026年2月）— Codex CLI、AgentShield 与市场

  • Codex CLI 支持 — 新增 /codex-setup 命令生成 codex.md
  • 7 个新技能 — search-first、swift-actor-persistence、swift-protocol-di-testing、regex-vs-llm-structured-text 等
  • AgentShield 集成 — /security-scan 可直接运行 AgentShield（1282 测试，102 规则）
  • GitHub Marketplace — ECC Tools GitHub App 上线，含免费/专业/企业层级
  • 30+ 社区 PR 合并

v1.4.0（2026年2月）— 多语言规则、安装向导 & PM2

  • 交互式安装向导 — configure-ecc 技能提供引导式设置
  • PM2 & 多代理编排 — 6 个新命令
  • 多语言规则架构 — common/ + typescript/ + python/ + golang/
  • 中文（zh-CN）翻译 — 80+ 文件完整翻译
  • GitHub Sponsors 支持

v1.3.0（2026年2月）— OpenCode 插件支持

  • 完整 OpenCode 集成 — 12 个代理、24 个命令、16 个技能（含 Hook 支持）
  • 3 个原生自定义工具 — run-tests、check-coverage、security-audit
  • LLM 文档 — llms.txt 提供完整 OpenCode 文档

v1.2.0（2026年2月）— 统一命令 & 技能

  • Python/Django 支持 — Django 模式、安全、TDD、验证技能
  • Java Spring Boot 技能 — 模式、安全、TDD、验证
  • 会话管理 — /sessions 命令
  • 持续学习 v2 — 基于直觉的学习，含置信度评分

十、系统要求

  • Claude Code CLI：最低版本 v2.1.0+
  • 检查版本：claude --version

⚠️ 贡献者注意：不要在 .claude-plugin/plugin.json 中添加 "hooks" 字段。Claude Code v2.1+ 会从已安装插件自动加载 hooks/hooks.json，显式声明会导致重复检测错误（详见 Issue #29、#52、#103）。

十一、常见问题

Q：如何查看已安装的 agents/commands？

/plugin list everything-claude-code@everything-claude-code

Q：Hooks 不工作 / 出现"Duplicate hooks file"错误？ 检查 .claude-plugin/plugin.json 中是否有 "hooks" 字段，有则删除。

Q：上下文窗口迅速缩小？ 禁用未使用的 MCP 服务器（见第七节），保持活跃 MCP 不超过 10 个。

Q：可以只使用部分组件吗？ 可以，使用手动安装方式（Option 2），按需复制文件。每个组件完全独立。

Q：如何贡献新技能？ Fork 仓库 → 在 skills/your-skill-name/SKILL.md 创建技能（含 YAML frontmatter）→ 提交 PR。

avatar
文章
阅读
粉丝