everything-claude-code-使用指南

Everything Claude Code 使用指南

概述

Everything Claude Code (ECC) 是一个 AI 代理性能优化系统，由 Anthropic Hackathon 获奖者开发。它不仅仅是一组配置，而是一个完整的系统：包含技能、本能、内存优化、持续学习、安全扫描和研究优先开发。

• 50K+ stars | 6K+ forks | 30+ 贡献者 | 支持 7 种语言
• 适用于 Claude Code 、Codex 、Cursor 、OpenCode 等主流 AI 编程工具

---

核心组件

1. Agents（代理）- 36 个专业代理

代理是用于委托任务的子代理，具有有限的作用域：

代理	用途
planner	功能实现规划
architect	系统设计决策
tdd-guide	测试驱动开发
code-reviewer	代码质量和安全审查
security-reviewer	漏洞分析
build-error-resolver	构建错误修复
e2e-runner	Playwright E2E 测试
refactor-cleaner	死代码清理
doc-updater	文档同步
go-reviewer	Go 代码审查
python-reviewer	Python 代码审查
typescript-reviewer	TypeScript 代码审查
java-reviewer	Java/Spring Boot 审查
kotlin-reviewer	Kotlin/Android 审查
rust-reviewer	Rust 代码审查
database-reviewer	数据库查询优化

2. Skills（技能）- 150+ 技能

技能是主要的工作流定义和领域知识：

类别	技能示例
编码标准	coding-standards, golang-patterns, python-patterns
后端模式	backend-patterns, api-design, database-migrations
前端模式	frontend-patterns, frontend-slides
测试	tdd-workflow, e2e-testing, golang-testing
安全	security-review, security-scan
DevOps	deployment-patterns, docker-patterns
内容创作	article-writing, content-engine, market-research
持续学习	continuous-learning, continuous-learning-v2

3. Rules（规则）- 34 条规则

规则是始终遵循的指导原则，组织为 common/（语言无关）+ 语言特定目录：

rules/
├── common/          # 通用原则（必须安装）
│   ├── coding-style.md
│   ├── git-workflow.md
│   ├── testing.md
│   ├── performance.md
│   ├── security.md
│   └── agents.md
├── typescript/      # TypeScript/JavaScript 特定
├── python/          # Python 特定
├── golang/          # Go 特定
├── swift/           # Swift 特定
└── php/             # PHP 特定

4. Hooks（钩子）- 8+ 事件类型

钩子在工具事件时触发：

事件类型	触发时机
PreToolUse	工具执行前
PostToolUse	工具执行后
Stop	会话结束
SessionStart	会话开始
SessionEnd	会话终止

---

安装方式

方式一：插件安装（推荐）

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

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

方式二：手动安装

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

# 安装依赖
npm install  # 或 pnpm install | yarn install | bun install

# macOS/Linux - 完整安装
./install.sh --profile full

# 或只安装特定语言
./install.sh typescript python golang

# Windows PowerShell
.\install.ps1 --profile full

规则安装（必需）

重要 ：Claude Code 插件系统无法自动分发 rules，需手动安装：

# 创建规则目录
mkdir -p ~/.claude/rules

# 复制通用规则（必需）
cp -r everything-claude-code/rules/common ~/.claude/rules/

# 复制语言特定规则（按需选择）
cp -r everything-claude-code/rules/typescript ~/.claude/rules/
cp -r everything-claude-code/rules/python ~/.claude/rules/
cp -r everything-claude-code/rules/golang ~/.claude/rules/

---

快速开始

步骤 1：验证安装

# 查看已安装的代理和命令
/plugin list everything-claude-code@everything-claude-code

步骤 2：常用命令

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

# TDD 开发
/tdd

# 代码审查
/code-review

# 安全扫描
/security-scan

# 修复构建错误
/build-fix

# E2E 测试
/e2e

---

常见工作流

开发新功能

/plan "Add OAuth authentication"    # planner 创建实现蓝图
/tdd                                # tdd-guide 强制测试优先
/code-review                        # code-reviewer 检查代码

修复 Bug

/tdd                                # 写一个失败的测试来重现问题
# 实现修复，验证测试通过
/code-review                        # 检查回归问题

准备生产发布

/security-scan                      # OWASP Top 10 审计
/e2e                                # 关键用户流程测试
/test-coverage                      # 验证 80%+ 覆盖率

---

跨平台支持

ECC 支持多种 AI 编程工具：

功能	Claude Code	Cursor IDE	Codex CLI	OpenCode
Agents	36	共享	共享	12
Commands	68	共享	基于指令	31
Skills	150	共享	10	37
Hook Events	8	15	N/A	11
Rules	34	34	基于指令	13
MCP Servers	14	共享	7	完整

Cursor IDE 安装

./install.sh --target cursor typescript python

Codex CLI 安装

# 自动同步 ECC 资源
npm install && bash scripts/sync-ecc-to-codex.sh

---

生态系统工具

AgentShield - 安全审计器

扫描 Claude Code 配置中的漏洞和注入风险：

# 快速扫描
npx ecc-agentshield scan

# 自动修复
npx ecc-agentshield scan --fix

# 深度分析（三个 Opus 代理）
npx ecc-agentshield scan --opus --stream

Continuous Learning v2

自动学习你的编码模式：

/instinct-status        # 查看学习到的本能
/instinct-import <file> # 导入他人的本能
/instinct-export        # 导出你的本能
/evolve                 # 将相关本能聚类为技能

---

配置选项

包管理器检测

插件自动检测包管理器，优先级如下：

1. 环境变量：CLAUDE_PACKAGE_MANAGER
2. 项目配置：.claude/package-manager.json
3. package.json：packageManager 字段
4. 锁文件检测

# 设置首选包管理器
export CLAUDE_PACKAGE_MANAGER=pnpm

Hook 运行时控制

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

# 临时禁用特定 Hook
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

---

代理选择指南

我想...	使用命令	代理
规划新功能	/plan "..."	planner
设计系统架构	/plan + architect	architect
测试优先开发	/tdd	tdd-guide
审查代码	/code-review	code-reviewer
修复构建错误	/build-fix	build-error-resolver
运行 E2E 测试	/e2e	e2e-runner
安全漏洞检查	/security-scan	security-reviewer
清理死代码	/refactor-clean	refactor-cleaner
审查 Go 代码	/go-review	go-reviewer
审查 Python 代码	/python-review	python-reviewer

---

常见问题

Q: Hooks 不工作 / 出现 "Duplicate hooks file" 错误？

不要 在 .claude-plugin/plugin.json 中添加 "hooks" 字段。Claude Code v2.1+ 会自动加载 hooks/hooks.json。

Q: 上下文窗口缩小？

禁用未使用的 MCP 服务器：

{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

建议保持少于 10 个 MCP 和 80 个工具。

Q: 可以只安装部分组件吗？

可以，使用手动安装：

# 只要代理
cp everything-claude-code/agents/*.md ~/.claude/agents/

# 只要规则
cp -r everything-claude-code/rules/common ~/.claude/rules/

---

---

相关链接

• GitHub: https://github.com/affaan-m/everything-claude-code
• npm (ecc-universal): https://www.npmjs.com/package/ecc-universal
• npm (ecc-agentshield): https://www.npmjs.com/package/ecc-agentshield
• GitHub Marketplace: https://github.com/marketplace/ecc-tools
• 官方指南 :
  • Shorthand Guide
  • Longform Guide
  • Security Guide

---