登录
Everything Claude Code 文档
2026年3月2日 15:17
一、项目概述
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-runner |
Playwright E2E 测试 |
refactor-cleaner |
死代码清理 |
doc-updater |
文档同步更新 |
go-reviewer |
Go 代码审查 |
go-build-resolver |
Go 构建错误修复 |
python-reviewer |
Python 代码审查 |
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-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 在工具事件发生时自动触发，示例：
{
"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 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 快速接入
./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"
}
}
| 设置 | 默认值 | 推荐值 | 效果 |
|---|---|---|---|
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。
// 在项目 .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 写代码 | /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？
/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。
