Everything Claude Code 文档

王小酱2026-03-02 15:21

一、项目概述

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 工作框架。

二、核心架构

目录结构总览

bash 复制代码 
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 分钟上手）

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

bash 复制代码 
# 添加为市场源
/plugin marketplace add affaan-m/everything-claude-code

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

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

json 复制代码 
{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

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

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

bash 复制代码 
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

步骤三：开始使用

bash 复制代码 
# 规划新功能
/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-runner Playwright E2E 测试
refactor-cleaner 死代码清理
doc-updater 文档同步更新
go-reviewer Go 代码审查
go-build-resolver Go 构建错误修复
python-reviewer Python 代码审查
database-reviewer 数据库/Supabase 审查

调用示例：

bash 复制代码 
/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-review Go 代码审查
/go-test Go TDD 工作流
/go-build 修复 Go 构建错误

多代理编排：

命令 用途
/multi-plan 多代理任务分解
/multi-execute 编排多代理工作流
/multi-backend 后端多服务编排
/multi-frontend 前端多服务编排
/multi-workflow 通用多服务工作流
/pm2 PM2 服务生命周期管理
/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 在工具事件发生时自动触发，示例：

json 复制代码 
{
  "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（编码规范）

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

bash 复制代码 
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 条静态分析规则。

bash 复制代码 
# 快速扫描（无需安装）
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：本地分析（内置）

bash 复制代码 
/skill-create                  # 分析当前仓库
/skill-create --instincts      # 同时生成直觉

方式 B：GitHub App（高级）

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

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

5.3 持续学习系统 v2

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

六、多平台支持详情

6.1 各平台功能对比

功能 Claude Code Cursor IDE Codex CLI OpenCode
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 快速接入

bash 复制代码 
./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 快速接入

bash 复制代码 
cp .codex/config.toml ~/.codex/config.toml
codex  # AGENTS.md 自动被检测

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

6.4 OpenCode 快速接入

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

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

七、Token 优化指南

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

json 复制代码 
{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}
设置 默认值 推荐值 效果
model opus sonnet 约降低 60% 成本
MAX_THINKING_TOKENS 31,999 10,000 约降低 70% 隐藏推理成本
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 95 50 更早压缩，长会话质量更好

日常工作流命令

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

上下文窗口管理

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

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

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

八、典型工作流示例

开发新功能

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

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

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

修复 Bug

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

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

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

上线前检查

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

代理选择速查表

我想要... 使用命令 调用代理
规划新功能 /plan "Add auth" planner
系统架构设计 /plan + 架构师模式 architect
TDD 写代码 /tdd tdd-guide
审查刚写的代码 /code-review code-reviewer
修复失败构建 /build-fix build-error-resolver
E2E 测试 /e2e e2e-runner
安全漏洞扫描 /security-scan security-reviewer
清理死代码 /refactor-clean refactor-cleaner
更新文档 /update-docs doc-updater
审查 Go 代码 /go-review go-reviewer
审查 Python 代码 /python-review python-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？

bash 复制代码 
/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。

相关推荐
雮尘2 小时前
如何在非 Claude IDE (TARE、 Cursor、Antigravity 等)下使用 Agent Skills
前端·agent·ai编程
刘贺同学3 小时前
Day12-龙虾哥打工日记：OpenClaw 子 Agent 到底看到了什么？
aigc·ai编程
程序员鱼皮5 小时前
离大谱，我竟然在 VS Code 里做了个视频！
github·aigc·ai编程
树獭叔叔5 小时前
13-KV Cache与位置编码表：大模型推理加速的核心技术
后端·aigc·openai
Kayshen6 小时前
我用纯前端逆向了 Figma 的二进制文件格式，实现了 .fig 文件的完整解析和导入
前端·agent·ai编程
wangruofeng6 小时前
OpenClaw 飞书机器人不回复消息？3 小时踩坑总结
ai编程
恋猫de小郭8 小时前
AI 正在造就你的「认知卸载」，但是时代如此
前端·人工智能·ai编程
草梅友仁9 小时前
墨梅博客 1.7.0 发布与 AI 开发实践 | 2026 年第 9 周草梅周报
开源·github·ai编程
热门推荐
01GitHub 镜像站点02【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆03OpenClaw 使用和管理 MCP 完全指南04OpenClaw + 飞书（Feishu）环境搭建指南05Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services06OpenClaw优化飞书API 额度已耗尽问题07Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤08Window 10部署openclaw报错node.exe : npm error code 12809OpenClaw大龙虾机器人完整安装教程10OpenClaw 接入阿里云百炼 Coding Plan 指南