0%

Everything Claude Code 完整教程

Posted on In , ,
Symbols count in article: 9.4k Reading time ≈ 9 mins.

Everything Claude Code 完整教程

项目仓库: affaan-m/everything-claude-code

📝 前言

在之前的教程中，我们介绍了 Claude Code 的基础配置。但在实际开发中，如何更高效地使用 Claude Code，如何让它更好地辅助我们的开发工作？Everything Claude Code 给出了一个完整的解决方案——它通过 13 个专业智能体、31 个命令、37+ 个技能包 和 23 个分层规则，将 Claude Code 打造成一个功能强大的开发工具链。

Everything Claude Code 是一个功能强大的 Claude Code 增强框架，提供了完整的开发工具链解决方案。它通过 13 个专业智能体、31 个命令、37+ 个技能包 和 23 个分层规则，覆盖了从规划、开发、测试到部署的完整开发生命周期。

核心特点： - 🤖 13 个专业智能体: 战略层、审查层、修复层、验证层、文档层分工明确 - ⚡ 31 个命令 (使用 /ecc: 前缀): 高效的工作流快捷方式 - 📚 37+ 个技能包: 从 TDD 工作流到安全审查，一应俱全 - 📏 23 个分层规则: Common + Python + TypeScript + Go 特定规范 - 🧪 完整 TDD 生态: RED→GREEN→REFACTOR 循环，强制 80%+ 覆盖率 - 🤝 多模型协作: Codex (后端) + Gemini (前端) 并行工作 - 📖 三层学习系统: Instinct → Skill → Agent 演进路径

二、核心架构

2.1 智能体系统 (13 个)

Everything Claude Code 采用分层专业化架构：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
战略层 (Opus 模型 - 最高智能)
├─ architect   - 系统架构设计、技术决策
└─ planner     - 实施计划制定、任务分解

审查层 (Sonnet 模型 - 高质量分析)
├─ code-reviewer       - 通用代码审查 (React/Next.js/Node.js)
├─ python-reviewer     - Python 专用 (PEP 8/类型/安全)
├─ go-reviewer         - Go 专用 (惯用模式/并发)
├─ security-reviewer   - OWASP Top 10 安全审查
└─ database-reviewer   - PostgreSQL 查询优化/Schema 设计

修复层 (Sonnet 模型)
├─ build-error-resolver  - TypeScript 构建错误修复
├─ go-build-resolver     - Go 编译错误修复
└─ refactor-cleaner      - 死代码检测/依赖清理

验证层 (Sonnet 模型)
├─ tdd-guide    - TDD 测试驱动开发 (80%+ 覆盖率)
└─ e2e-runner   - E2E 端到端测试 (Playwright)

文档层 (Haiku 模型 - 快速轻量)
└─ doc-updater  - Codemap 生成/文档同步

智能体特点： - 模型精准分配: Opus 处理复杂决策，Sonnet 处理分析，Haiku 处理简单任务 - 单一职责: 每个智能体专注于特定领域 - 并行执行: 独立智能体可并行工作，提升效率

2.2 命令系统 (31 个，使用 /ecc: 前缀)

所有命令使用 /ecc: 前缀，便于与其他框架（如 SuperClaude 的 /sc:）区分：

核心工作流 (6个)

命令 功能 何时使用
/ecc:plan 规划命令 开始新功能、架构变更、复杂重构
/ecc:tdd TDD 工作流 实现新功能、修复 bug、重构代码
/ecc:code-review 代码审查 代码完成后、提交前
/ecc:verify 验证系统 提交前全面质量检查
/ecc:learn 学习模式 完成复杂任务后提取模式
/ecc:orchestrate 编排命令 顺序代理工作流

核心工作流示例： 

1
2
3
4
5
/ecc:plan "用户认证"     # 1. 规划
/ecc:tdd "实现认证"      # 2. TDD 开发
/ecc:python-review       # 3. 代码审查
/ecc:verify              # 4. 质量验证
/ecc:learn               # 5. 学习总结

多模型协作 (5个)

命令 功能 模型分配
/ecc:multi-plan 多模型规划 Codex + Gemini 并行分析
/ecc:multi-execute 多模型执行 智能路由（后端→Codex，前端→Gemini）
/ecc:multi-backend 后端工作流 Codex 主导
/ecc:multi-frontend 前端工作流 Gemini 主导
/ecc:multi-workflow 综合工作流 智能路由

关键协议： - 🌐 语言协议: 工具交互用英语，用户交互用中文 - 🔒 代码主权: 外部模型无文件系统写入权限 - 🎯 信任规则: 后端听从 Codex，前端听从 Gemini

测试相关 (4个)

命令 功能 目标
/ecc:tdd TDD 工作流 RED→GREEN→REFACTOR 循环
/ecc:test-coverage 覆盖率分析 80%+ 覆盖率
/ecc:e2e E2E 测试 Playwright 端到端测试
/ecc:go-test Go TDD 表驱动测试

构建与修复 (4个)

命令 功能 何时使用
/ecc:build-fix TS 构建修复 TypeScript 编译/类型错误
/ecc:go-build Go 构建修复 Go 编译/vet/lint 错误
/ecc:refactor-clean 代码清理 检测并移除死代码
/ecc:checkpoint 检查点 创建/验证工作流检查点

语言特定审查 (3个)

命令 目标语言 检查内容
/ecc:code-review 通用 安全、质量、最佳实践
/ecc:python-review Python PEP 8、类型提示、Pythonic
/ecc:go-review Go 惯用模式、并发安全、错误处理

学习与知识 (6个)

命令 功能 输出
/ecc:learn 提取模式 保存到 ~/.claude/skills/learned/
/ecc:instinct-status 查看本能 显示已学习的 instincts
/ecc:instinct-export 导出本能 分享给团队
/ecc:instinct-import 导入本能 接收他人的学习成果
/ecc:evolve 演进 Instincts → Skill/Command/Agent
/ecc:skill-create 生成技能 从 Git 历史提取模式

文档与管理 (3个)

命令 功能 输出
/ecc:update-docs 同步文档 更新代码相关文档
/ecc:update-codemaps 生成地图 代码架构图
/ecc:sessions 会话管理 列表、加载、别名

2.3 技能系统 (37+ 个)

技能是可自动激活或手动调用的功能模块：

核心开发模式 (4个)

  • tdd-workflow - TDD 工作流
  • verification-loop - 验证循环
  • continuous-learning v1 & v2 - 持续学习系统

语言/框架模式 (15+个)

  • python-patterns - Python 开发模式
  • golang-patterns - Go 开发模式
  • django-* - Django 框架模式
  • springboot-* - Spring Boot 模式

数据库与存储 (4个)

  • postgres-patterns - PostgreSQL 模式
  • database-migrations - 数据库迁移
  • docker-patterns - Docker 模式
  • clickhouse-io - ClickHouse 模式

安全与质量 (3个)

  • security-review - 安全审查
  • security-scan - 安全扫描
  • coding-standards - 编码规范

文档生成 (4个)

  • pptx - PPT 生成
  • xlsx - Excel 生成
  • pdf - PDF 生成
  • markitdown - Markdown 转换

工具集成 (3+个)

  • agent-browser - 浏览器自动化
  • planning-with-files - 文件规划
  • conversation-export - 对话导出

2.4 规则系统 (23 个)

规则系统提供分层的代码质量保障：

1
2
3
4
5
6
7
8
9
10
11
12
13
~/.claude/rules/
├── common/          # 通用规则 (8个)
│   ├── coding-style.md
│   ├── git-workflow.md
│   ├── testing.md
│   ├── performance.md
│   ├── patterns.md
│   ├── hooks.md
│   ├── agents.md
│   └── security.md
├── python/          # Python 特定 (5个)
├── typescript/      # TypeScript/JS (5个)
└── golang/          # Go 规则 (5个)

关键规则： - coding-style.md: 不可变性 (CRITICAL)、文件组织 (200-400行) - testing.md: 最低覆盖率 80%、TDD 工作流强制 - security.md: 提交前强制检查清单、8 项安全检查 - Python 特定: PEP 8 合规、类型注解强制、工具链 (black + isort + ruff + mypy) - Go 特定: gofmt + goimports 强制、表驱动测试、竞态检测

三、安装方法

3.1 环境准备

确保你已经安装了 Claude Code CLI：

1
2
3
4
# 检查 Claude Code 版本
claude --version

# 要求版本 >= 2.0.0

3.2 克隆仓库

1
2
3
# 克隆 Everything Claude Code 仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

3.3 安装组件

完整安装（推荐）：

1
2
3
4
5
6
7
8
# 安装所有组件
bash install.sh python typescript golang

# 这将安装：
# - 13 个 Agents → ~/.claude/agents/
# - 31 个 Commands → ~/.claude/commands/ecc/
# - 37+ 个 Skills → ~/.claude/skills/
# - 23 个 Rules → ~/.claude/rules/

选择性安装：

1
2
3
4
5
6
7
8
9
10
11
12
# 仅安装 Agents 和 Commands
cp -r agents/*.md ~/.claude/agents/
cp -r commands/*.md ~/.claude/commands/ecc/

# 仅安装 Python 规则
bash install.sh python

# 仅安装 TypeScript 规则
bash install.sh typescript

# 仅安装 Go 规则
bash install.sh golang

3.4 验证安装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查看已安装的命令
ls ~/.claude/commands/ecc/

# 测试命令是否可用
/ecc

# 查看智能体
ls ~/.claude/agents/

# 查看技能
ls ~/.claude/skills/

# 查看规则
ls ~/.claude/rules/

四、智能体、技能包、规则详细使用指南

4.1 智能体（Agents）使用方法

4.1.1 什么是智能体？

智能体是 Everything Claude Code 的核心组件，它们是专业化的 AI 助手，每个智能体专注于特定领域的任务。

智能体的特点： - 🎯 单一职责：每个智能体只做一件事，但做到极致 - 🤖 自动激活：Claude Code 会根据任务自动选择合适的智能体 - 🔄 并行执行：独立的智能体可以同时工作，提升效率 - 📊 模型优化：不同智能体使用不同的 AI 模型（Opus/Sonnet/Haiku）

4.1.2 智能体列表与使用场景

战略层智能体（Opus 模型）：

智能体 文件位置 何时使用 使用方式
architect ~/.claude/agents/architect.md 系统架构设计、技术选型 自动激活或 /ecc:plan
planner ~/.claude/agents/planner.md 功能规划、任务分解 自动激活或 /ecc:plan

审查层智能体（Sonnet 模型）：

智能体 文件位置 何时使用 使用方式
code-reviewer ~/.claude/agents/code-reviewer.md 通用代码审查 /ecc:code-review
python-reviewer ~/.claude/agents/python-reviewer.md Python 专业审查 /ecc:python-review
go-reviewer ~/.claude/agents/go-reviewer.md Go 专业审查 /ecc:go-review
security-reviewer ~/.claude/agents/security-reviewer.md 安全漏洞分析 自动激活或 /ecc:code-review --focus security
database-reviewer ~/.claude/agents/database-reviewer.md 数据库优化 自动激活

修复层智能体（Sonnet 模型）：

智能体 文件位置 何时使用 使用方式
build-error-resolver ~/.claude/agents/build-error-resolver.md TypeScript 构建错误 /ecc:build-fix
go |~/.cl-build-resolveraude/agents/go-build-resolver.md Go 编译错误 /ecc:go-build
refactor-cleaner ~/.claude/agents/refactor-cleaner.md 死代码清理 /ecc:refactor-clean

验证层智能体（Sonnet 模型）：

智能体 文件位置 何时使用 使用方式
tdd-guide ~/.claude/agents/tdd-guide.md TDD 开发 /ecc:tdd
e2e-runner ~/.claude/agents/e2e-runner.md E2E 测试 /ecc:e2e

文档层智能体（Haiku 模型）：

智能体 文件位置 何时使用 使用方式
doc-updater ~/.claude/agents/doc-updater.md 文档同步 /ecc:update-docs

4.1.3 智能体使用示例

示例 1：自动激活智能体

1
2
3
4
5
6
7
8
# 用户请求
"帮我审查这段 Python 代码的安全性"

# Claude Code 自动流程
1. 分析请求 → 识别为"Python 代码审查 + 安全检查"
2. 激活智能体 → python-reviewer + security-reviewer
3. 并行执行 → 两个智能体同时工作
4. 汇总结果 → 生成综合报告

示例 2：手动调用智能体

1
2
3
4
5
6
7
8
# 方式 1：通过命令调用
/ecc:python-review

# 方式 2：在对话中明确指定
"请使用 python-reviewer 智能体审查 src/auth.py"

# 方式 3：通过 Task 工具调用
Task: 使用 python-reviewer 智能体审查代码质量

4.2 技能包（Skills）使用方法

4.2.1 什么是技能包？

技能包是可复用的知识库和工作流定义，它们包含： - 📚 领域知识：最佳实践、设计模式、编码规范 - 🔄 工作流定义：TDD 流程、验证循环、部署流程 - 🛠️ 工具集成：浏览器自动化、文档生成、数据处理

技能包的特点： - 🔄 自动激活：根据项目类型和任务自动加载 - 📦 模块化：可以单独启用或禁用 - 🎓 持续学习：可以从会话中自动提取新技能

4.2.2 技能包分类与列表

核心开发模式（4个）：

技能包 文件位置 功能 使用方式
tdd-workflow ~/.claude/skills/tdd-workflow/ TDD 工作流 自动激活或 /ecc:tdd
verification-loop ~/.claude/skills/verification-loop/ 验证循环 自动激活或 /ecc:verify
continuous-learning ~/.claude/skills/continuous-learning/ 持续学习 v1 自动激活或 /ecc:learn
continuous-learning-v2 ~/.claude/skills/continuous-learning-v2/ 持续学习 v2（Instinct 系统） 自动激活

数据库与存储（4个）：

技能包 功能
postgres-patterns PostgreSQL 模式
database-migrations 数据库迁移
docker-patterns Docker 模式
clickhouse-io ClickHouse 模式

安全与质量（3个）：

技能包 功能
security-review 安全审查
security-scan 安全扫描
coding-standards 编码规范

文档生成（4个）：

技能包 功能
pptx PPT 生成
xlsx Excel 生成
pdf PDF 生成
markitdown Markdown 转换

4.2.3 持续学习系统（Instinct → Skill → Agent）

Everything Claude Code 的学习系统是三层架构：

1
2
3
4
5
Instinct (本能)
    ↓ 聚类
Skill (技能)
    ↓ 演进
Agent (智能体)

使用流程：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 1. 完成任务后提取 Instinct
/ecc:learn

# 2. 查看已学习的 Instincts
/ecc:instinct-status

# 3. 演进为 Skill
/ecc:evolve --domain auth

# 4. 导出分享给团队
/ecc:instinct-export --output team-patterns.yaml

# 5. 从 Git 历史生成技能包
/ecc:skill-create

4.3 规则（Rules）使用方法

4.3.1 核心规则详解

1. coding-style.md（编码风格）

1
2
3
4
5
6
7
# 关键规则
- 不可变性 (CRITICAL): 永远不要修改现有对象，总是创建新对象
- 文件大小: 200-400 行典型，800 行最大
- 函数大小: <50 行
- 嵌套深度: <4 层
- 错误处理: 必须在每一层处理错误
- 输入验证: 必须在系统边界验证所有输入

2. testing.md（测试要求）

1
2
3
4
5
# 关键规则
- 最低覆盖率: 80%
- TDD 工作流: 强制执行 RED→GREEN→REFACTOR
- 测试类型: 单元测试 + 集成测试 + E2E 测试（全部必需）
- 测试隔离: 每个测试必须独立运行

3. security.md（安全标准）

1
2
3
4
5
6
7
8
9
# 提交前强制检查清单
- [ ] 无硬编码秘密（API keys、密码、tokens）
- [ ] 所有用户输入已验证
- [ ] SQL 注入防护（参数化查询）
- [ ] XSS 防护（HTML 清理）
- [ ] CSRF 保护已启用
- [ ] 认证/授权已验证
- [ ] 所有端点已限流
- [ ] 错误消息不泄露敏感数据

4.3.2 规则与智能体/技能包的关系

1
2
3
4
5
6
规则 (Rules)
    ↓ 定义标准
智能体 (Agents)
    ↓ 执行检查
技能包 (Skills)
    ↓ 提供知识

五、使用示例

5.1 新功能开发（完整工作流）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 1. 规划阶段
/ecc:plan "添加用户认证功能"

# 2. TDD 开发
/ecc:tdd "实现 JWT 认证"

# 3. 代码审查
/ecc:python-review

# 4. 质量验证
/ecc:verify

# 5. 学习总结
/ecc:learn

5.2 多模型协作开发

1
2
3
4
5
6
7
8
# 1. 多模型规划
/ecc:multi-plan "实现支付处理系统"

# 2. 多模型执行
/ecc:multi-execute

# 3. 验证
/ecc:verify

5.3 代码质量提升

1
2
3
4
5
6
7
8
9
10
11
# 1. 通用审查
/ecc:code-review

# 2. 清理死代码
/ecc:refactor-clean

# 3. 测试覆盖率
/ecc:test-coverage

# 4. 全面验证
/ecc:verify

六、核心优势

6.1 vs SuperClaude Framework

维度 Everything Claude Code SuperClaude
专业审查 ✅ 语言特定 (Python/Go/TS) ⚠️ 通用审查
TDD 支持 ✅ 完整生态系统 ⚠️ 基础测试
多模型 ✅ 5 个命令 ❌ 无
学习系统 ✅ 三层架构 ⚠️ 简单反思
深度研究 ❌ 无 ✅ Tavily MCP
项目管理 ⚠️ 规划 ✅ PM Agent

6.2 独特能力

  • 🧪 强制 TDD: 80%+ 覆盖率，RED-GREEN-REFACTOR
  • 🔍 专业审查: 语言特定的深度检查
  • 🤝 多模型协作: Codex (后端) + Gemini (前端) 并行
  • 📚 学习进化: Instinct → Skill → Agent 演进
  • ✅ 全面验证: 构建/类型/Lint/测试/安全

七、最佳实践

7.1 日常开发工作流

1
2
3
4
5
6
7
8
9
10
# 每天开始
/ecc:plan "今日任务"

# 开发过程
/ecc:tdd "功能实现"
/ecc:python-review  # 或 /ecc:go-review

# 提交前
/ecc:verify
/ecc:learn

7.2 代码审查策略

1
2
3
4
5
6
7
8
9
# 基础审查
/ecc:code-review

# 语言特定审查
/ecc:python-review  # Python 项目
/ecc:go-review      # Go 项目

# 安全审查
/ecc:code-review --focus security

7.3 学习积累

1
2
3
4
5
6
7
8
9
10
11
# 完成任务后
/ecc:learn

# 定期查看
/ecc:instinct-status

# 演进为技能
/ecc:evolve --domain <领域>

# 分享给团队
/ecc:instinct-export

八、注意事项

8.1 兼容性

  • Claude Code 版本: 要求 >= 2.0.0
  • Python 版本: Python 规则要求 >= 3.9
  • Go 版本: Go 规则要求 >= 1.19
  • Node.js 版本: TypeScript 规则要求 >= 18.0

8.2 与 SuperClaude 组合使用

推荐策略： - 日常开发 (90%): 使用 ECC 命令 - 特殊场景 (10%): 使用 SC 命令（研究、需求发现、跨会话）

命令映射： - 需求发现: /sc:brainstorm - 技术研究: /sc:research - 项目规划: /ecc:plan 或 /sc:pm - 功能实现: /ecc:tdd - 代码审查: /ecc:python-review 或 /ecc:go-review - 质量验证: /ecc:verify

九、相关资源

官方资源

社区资源

十、项目统计

  • 智能体数量: 13 个（分层专业化）
  • 命令数量: 31 个（使用 /ecc: 前缀）
  • 技能数量: 37+ 个
  • 规则数量: 23 个（分层规则）
  • 覆盖领域: Python、TypeScript、Go、前端、后端、测试、安全
  • 学习系统: 三层架构（Instinct → Skill → Agent）

Happy Coding with Everything Claude Code! 🚀

"专业的开发工具链，让代码质量和开发效率同时提升！"

-------------This blog is over! Thanks for your reading-------------