ECC教程

markdown

2026年7月17日11 min read2,055 words

Updated 2026年7月17日

ECC (Everything Claude Code) 完整教程：AI 编程工具的全能增强系统

1. 痛点导入：为什么需要 ECC？

1.1 AI 编程工具的现状

当前主流 AI 编程工具各有优势，但也存在明显局限：

工具	优势	局限
Claude Code	强大的推理能力	缺少系统化工作流
Cursor	IDE 集成紧密	自定义能力有限
GitHub Copilot	代码补全流畅	仅限代码片段
Codex CLI	命令行友好	上下文管理复杂

1.2 核心问题

问题 1: 工作流碎片化
├── 每次任务都要重复解释上下文
├── 缺少标准化的开发流程
└── 难以在不同项目间复用经验

问题 2: 规则执行不稳定
├── AI 可能忽略你设定的规范
├── 跨会话无法保持一致性
└── 代码风格、安全检查依赖人工

问题 3: 上下文窗口压力
├── 200k token 听起来很大
├── 实际可用可能只有 70k
└── MCP 服务器消耗大量上下文

1.3 ECC 的答案

"ECC 是 AI 编程工具的全能增强系统，不是替代品。"

ECC 通过以下方式增强任何 AI 编程工具：

结构化的工作流程（Skills）
自动化规则执行（Rules + Hooks）
专业领域代理（Agents）
上下文优化（Token 优化、记忆持久化）

2. ECC 是什么？

2.1 一句话定义

ECC (Everything Claude Code) 是一个跨平台的 AI 编程工具增强系统，通过模块化的代理、技能、规则和钩子，将任何 AI 编程工具升级为完整的软件工程环境。

2.2 项目档案

属性	内容
GitHub	affaan-m/ECC
Stars	211.9k+
Fork	32.5k+
贡献者	230+
支持平台	Claude Code, Codex, Cursor, OpenCode, Gemini, Zed, GitHub Copilot
语言生态	TypeScript, Python, Go, Java, Swift, PHP, Kotlin, Rust, C++, Perl 等
许可证	MIT

2.3 核心数据

67 个专业代理 (Agents)
    ↓
277 个工作流技能 (Skills)
    ↓
92 个斜杠命令 (Commands)
    ↓
12+ 编程语言支持
    ↓
跨 7 个主流 AI 编程工具

2.4 与 Superpowers、gstack 的对比

维度	Superpowers	gstack	ECC
定位	方法论框架	虚拟工程团队	全能增强系统
核心能力	流程规范	角色扮演 + 浏览器	代理 + 技能 + 规则
浏览器支持	无	有	无
语言覆盖	通用	通用	12+ 语言
平台支持	主要 Claude Code	主要 Claude Code	7 个平台
学习曲线	低	中	低-中
模块化程度	高	高	极高（可选择性安装）

AI 编程增强工具对比

3. 核心架构解析

ECC 核心架构

3.1 架构概览

ECC 的核心架构围绕"模块化增强"设计：

┌─────────────────────────────────────────────────────────────┐
│                    AI 编程工具 (Harness)                     │
│         Claude Code / Codex / Cursor / OpenCode / ...        │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                      ECC 增强层                              │
├─────────────┬─────────────┬─────────────┬─────────────────┤
│   Agents    │   Skills    │    Hooks    │      Rules      │
│  (67个)    │  (277个)    │  (触发式)   │   (始终遵循)    │
├─────────────┼─────────────┼─────────────┼─────────────────┤
│  代码审查   │   TDD 工作流  │  自动格式化  │   安全准则      │
│  架构设计   │   性能优化   │  上下文保存  │   代码风格      │
│  构建修复   │   安全扫描   │  会话摘要   │   Git 工作流    │
│  测试运行   │   部署流程   │  令牌监控   │   测试要求      │
└─────────────┴─────────────┴─────────────┴─────────────────┘

3.2 为什么模块化？

选择性安装：只安装你需要的功能

# 只安装技能
./install.sh --profile minimal --target claude

# 完整安装
./install.sh --profile full --target claude

# 按需添加
./install.sh --target claude --modules hooks-runtime

隔离性：各组件独立，不影响其他工具

Claude Code 和 Cursor 可以同时使用 ECC
各自的数据目录隔离（通过 ECC_AGENT_DATA_HOME 配置）

3.3 跨平台架构

                    ┌─────────────────┐
                    │  Universal Core │
                    │  (共享组件)     │
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│ Claude Code   │    │    Cursor     │    │   Codex CLI   │
│ .claude/      │    │   .cursor/    │    │   .codex/     │
│ settings.json │    │  hooks.json   │    │  config.toml  │
└───────────────┘    └───────────────┘    └───────────────┘
        │                    │                    │
        └────────────────────┼────────────────────┘
                             │
                             ▼
                    ┌─────────────────┐
                    │  Platform Layer │
                    │  (适配层)       │
                    └─────────────────┘

4. 组件体系全解

4.1 Agents（代理）

定义：专业化子代理，用于任务委托

特点：

有限作用域，执行专注任务
可配置工具、MCP、权限
支持后台或前台运行

核心代理一览：

代理	角色	职能
`planner.md`	规划师	功能实现规划
`architect.md`	架构师	系统设计决策
`tdd-guide.md`	TDD 指导	测试驱动开发
`code-reviewer.md`	代码审查	质量与安全审查
`security-reviewer.md`	安全审查	漏洞分析
`build-error-resolver.md`	构建修复	修复编译错误
`e2e-runner.md`	E2E 测试	Playwright 测试
`refactor-cleaner.md`	重构清理	死代码移除
`doc-updater.md`	文档更新	文档同步

语言专项代理：

语言	代理
TypeScript	`typescript-reviewer.md`
Python	`python-reviewer.md`, `pytorch-build-resolver.md`
Go	`go-reviewer.md`, `go-build-resolver.md`
Java	`java-reviewer.md`, `java-build-resolver.md`
Kotlin	`kotlin-reviewer.md`, `kotlin-build-resolver.md`
Rust	`rust-reviewer.md`, `rust-build-resolver.md`
C++	`cpp-reviewer.md`, `cpp-build-resolver.md`

4.2 Skills（技能）

定义：工作流定义和领域知识包

结构：

skills/
├── tdd-workflow/           # 测试驱动开发
│   └── SKILL.md            # 技能定义
├── security-review/        # 安全审查
│   └── SKILL.md
├── backend-patterns/       # 后端模式
│   └── SKILL.md
├── continuous-learning-v2/  # 持续学习
│   └── SKILL.md
└── ...

核心技能分类：

分类	技能	说明
开发流程	`tdd-workflow`	RED-GREEN-REFACTOR 循环
	`verification-loop`	构建-测试-检查循环
	`eval-harness`	评估驱动开发
代码质量	`code-review`	代码审查流程
	`refactor-clean`	死代码清理
	`e2e-testing`	端到端测试
安全	`security-review`	OWASP 安全检查
	`security-scan`	AgentShield 集成
架构	`backend-patterns`	API、数据库、缓存模式
	`frontend-patterns`	React、Next.js 模式
	`api-design`	REST API 设计
运营	`deployment-patterns`	CI/CD、Docker、健康检查
	`database-migrations`	数据库迁移模式

4.3 Commands（命令）

定义：斜杠命令入口（兼容层，逐步迁移到 Skills）

常用命令：

命令	技能	说明
`/plan`	规划师	创建实施计划
`/code-review`	审查者	质量审查
`/build-fix`	构建修复	修复编译错误
`/refactor-clean`	重构	清理死代码
`/learn`	学习	从会话提取模式
`/evolve`	进化	将本能聚类为技能
`/test-coverage`	覆盖分析	测试覆盖分析
`/sessions`	会话管理	会话历史管理
`/multi-plan`	多代理	多模型协作规划
`/multi-execute`	多执行	多模型协作执行

4.4 Hooks（钩子）

定义：触发式自动化，在特定事件发生时执行

事件类型：

阶段	事件	用途
工具前	`PreToolUse`	验证、提醒、阻止
工具后	`PostToolUse`	格式化、反馈循环
提示前	`UserPromptSubmit`	提示验证
停止时	`Stop`	会话摘要、保存状态
压缩前	`PreCompact`	压缩前状态保存
通知	`Notification`	权限请求

示例：自动格式化

{
  "PostToolUse": [{
    "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
    "hooks": [{
      "type": "command",
      "command": "prettier --write \"$file_path\""
    }]
  }]
}

示例：Git push 前检查

{
  "PreToolUse": [{
    "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",
    "hooks": [{
      "type": "command",
      "command": "echo '[Hook] 提交前检查代码质量...' && npm run lint && npm test"
    }]
  }]
}

4.5 Rules（规则）

定义：始终遵循的指导原则

组织结构：

rules/
├── common/              # 通用规则（始终安装）
│   ├── coding-style.md   # 代码风格
│   ├── git-workflow.md   # Git 工作流
│   ├── testing.md        # 测试要求
│   ├── performance.md    # 性能准则
│   ├── patterns.md       # 设计模式
│   ├── hooks.md          # Hook 架构
│   ├── agents.md         # 代理委托
│   └── security.md       # 安全检查
├── typescript/          # TypeScript 专项
├── python/             # Python 专项
├── golang/             # Go 专项
├── swift/              # Swift 专项
├── php/                # PHP 专项
└── arkts/              # HarmonyOS 专项

通用规则示例：

# testing.md

## 测试要求

- 所有新功能必须先写测试
- 测试覆盖率必须达到 80%+
- 使用 TDD 工作流：
  1. RED: 写一个会失败的测试
  2. GREEN: 写最小代码让测试通过
  3. REFACTOR: 重构代码

4.6 组件对比表

组件	触发方式	作用域	典型用途
Agents	显式委托	单次任务	代码审查、架构设计
Skills	显式调用	工作流	TDD、安全扫描
Commands	斜杠命令	兼容层	快速入口
Hooks	事件触发	工具级	自动格式化、保存状态
Rules	始终生效	全局	安全准则、代码风格

5. 快速入门：2 分钟安装

5.1 安装方式选择

场景	推荐方式
Claude Code 用户（推荐）	插件安装
精细控制需求	手动安装
只想试用	最小安装
完整功能	完整安装

5.2 插件安装（推荐）

# Step 1: 添加市场
/plugin marketplace add https://github.com/affaan-m/ECC

# Step 2: 安装插件
/plugin install ecc@ecc

# Step 3: 复制规则（重要！）
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/  # 选择你的语言

5.3 手动安装

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

# 安装依赖
npm install

# 最小安装
./install.sh --profile minimal --target claude

# 完整安装
./install.sh --profile full --target claude

5.4 选择性安装

# 咨询：哪些组件适合你的需求？
npx ecc consult "security reviews"

# 安装建议的组件
npx ecc install --profile minimal --target claude --with capability:security

# 仅安装 hooks runtime
./install.sh --target claude --modules hooks-runtime

5.5 其他平台安装

平台	安装命令
Cursor	`./install.sh --target cursor typescript`
Codex CLI	`./install.sh --target codex`
OpenCode	`./install.sh --target opencode`
Zed	`./install.sh --profile minimal --target zed`
GitHub Copilot	自动加载 `.github/copilot-instructions.md`

5.6 安装后验证

# 检查已安装的组件
/plugin list ecc@ecc

# 运行诊断
node scripts/ecc.js doctor

# 开始使用
/ecc:plan "我的第一个任务"

6. 实战演示：典型工作流

ECC 典型工作流程

场景：开发用户认证模块

工作流 1：功能规划

你输入：
> /ecc:plan "实现用户认证模块"

ECC 输出：
📋 功能规划

1. 需求澄清
   - 认证方式：JWT / Session？
   - 密码加密：bcrypt / argon2？
   - 第三方登录：OAuth？

2. 技术方案
   - API 设计：REST / GraphQL？
   - 数据库：PostgreSQL / MongoDB？
   - 缓存：Redis？

3. 安全考虑
   - OWASP Top 10 对齐
   - 密码策略
   - 速率限制

4. 测试策略
   - 单元测试覆盖率目标
   - E2E 测试场景

工作流 2：TDD 开发

你输入：
> /ecc:tdd "用户登录功能"

ECC 流程：
1. RED（写失败测试）
   └─ 写一个测试：输入正确凭证，期望返回 Token

2. GREEN（写最小代码）
   └─ 实现最简登录逻辑

3. REFACTOR（重构）
   └─ 优化代码结构，保持测试通过

4. 验证覆盖
   └─ 检查测试覆盖率 >= 80%

工作流 3：代码审查

你输入：
> /code-review

ECC 输出：
🔍 代码审查报告

[🔴 阻塞性问题]
- POST /api/auth/login 缺少速率限制
- 密码明文日志记录（security.md 违规）

[🟡 严重问题]
- JWT secret 硬编码，应使用环境变量
- 错误信息泄露用户存在性

[🟢 建议]
- 添加单元测试覆盖率
- 考虑使用 argon2 替代 bcrypt

🔧 正在自动修复可修复问题...
✅ 已修复：硬编码密码、日志记录
⚠️ 需要手动：速率限制、错误信息

工作流 4：多代理协作

你输入：
> /multi-plan "完整的电商后端"

ECC 流程：
1. 任务分解
   ├─ 用户服务
   ├─ 商品服务
   ├─ 订单服务
   └─ 支付服务

2. 并行执行
   ├─ Agent A: 实现用户服务
   ├─ Agent B: 实现商品服务
   ├─ Agent C: 实现订单服务
   └─ Agent D: 实现支付服务

3. 结果汇总
   ├─ 统一代码风格
   ├─ 解决冲突
   └─ 生成集成测试

7. 跨平台支持

7.1 平台特性对比

功能	Claude Code	Cursor	Codex CLI	OpenCode	GitHub Copilot
Agents	67	共享	共享	12	N/A
Commands	92	共享	指令式	35	5 prompts
Skills	277	共享	32	37	指令式
Hook 事件	8 种	15 种	无	11 种	无
Rules	34	34	指令式	13	1 always-on
MCP 支持	14	共享	7	完整	N/A

7.2 Claude Code 特有

# 插件安装
/plugin install ecc@ecc

# 专属命令
/ecc:plan
/ecc:tdd
/ecc:security-scan
/ecc:multi-execute

7.3 Cursor 特有

# 安装
./install.sh --target cursor typescript python

# 特有 Hook
├── beforeShellExecution
├── afterFileEdit
├── beforeMCPExecution
└── beforeSubmitPrompt

7.4 GitHub Copilot 特有

自动加载 .github/copilot-instructions.md：

编码标准（始终生效）
安全检查清单
TDD 流程
PR 模板

7.5 平台隔离

# Claude Code 数据目录
~/.claude/

# Cursor 数据目录
~/.cursor/ecc/

# 共享数据（需显式配置）
ECC_AGENT_DATA_HOME=~/.claude

8. 最佳实践与安全指南

8.1 上下文优化

MCP 管理：

# 保持启用数量 < 10
/mcp

# 禁用未使用的 MCP
# 在 ~/.claude.json 中管理

模型选择：

// settings.json
{
  "model": "sonnet",           // 默认使用 Sonnet
  "env": {
    "MAX_THINKING_TOKENS": "10000",  // 减少思考 token
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"  // 提前压缩
  }
}

压缩策略：

# 在逻辑断点手动压缩
/compact

# 不要在实现中途压缩（会丢失变量名、文件路径）

8.2 安全最佳实践

安装来源验证：

✅ 官方来源：
   - github.com/affaan-m/ECC
   - npm: ecc-universal, ecc-agentshield
   - GitHub App: ecc@ecc
   - ecc.tools

❌ 第三方重传或镜像可能包含恶意代码

敏感信息检测：

# 提交前检查
npm run secret-check

# 启用 Hook 警告
/ecc:careful

AgentShield 安全扫描：

# 快速扫描
npx ecc-agentshield scan

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

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

8.3 持续学习

Instinct 系统：

# 查看学习的本能
/instinct-status

# 导出分享
/instinct-export > my-patterns.json

# 导入他人经验
/instinct-import < patterns.json

# 聚类为技能
/evolve

8.4 工作流建议

场景	推荐命令/技能
开始新功能	`/ecc:plan` + `tdd-workflow`
代码审查	`/code-review`
Bug 修复	`tdd-workflow` + `/code-review`
准备发布	`/security-scan` + `e2e-testing`
性能优化	`benchmark` + `verification-loop`
文档同步	`/update-docs`

9. 方法论总结

9.1 ECC 的设计哲学

┌─────────────────────────────────────────────────────┐
│                    模块化增强                         │
│                                                     │
│  不替代任何工具 → 而是增强每个工具的能力               │
│  不强制全部安装 → 而是选择性组合                      │
│  不改变工作习惯 → 而是自动化重复                      │
└─────────────────────────────────────────────────────┘

9.2 教程结构模板（复用）

1. 痛点导入（5 分钟）
   └── 现有工具的局限性

2. 工具定位（5 分钟）
   └── 是什么，解决什么问题

3. 架构解析（10 分钟）
   └── 核心组件及关系

4. 组件详解（20 分钟）
   └── Agents / Skills / Hooks / Rules

5. 安装指南（5 分钟）
   └── 快速上手路径

6. 实战演示（20 分钟）
   └── 典型工作流案例

7. 平台对比（10 分钟）
   └── 跨平台支持情况

8. 最佳实践（5 分钟）
   └── 经验总结

9. 资源链接
   └── 官方文档、示例、社区

9.3 写作要点

要点	说明
对比切入	用表格对比现有工具，突出差异优势
模块化思维	每个组件独立讲解，可选择性使用
实战驱动	每个组件都有使用示例
平台适配	考虑不同平台读者的需求
安全提醒	重要但常被忽略

附录

A. 资源链接

资源	链接
GitHub	https://github.com/affaan-m/ECC
官网	https://ecc.tools
Discord	https://discord.gg/36yGMHGFbR
Shorthand Guide	the-shortform-guide.md
Longform Guide	the-longform-guide.md
Security Guide	the-security-guide.md

B. 相关工具对比总表

工具	Stars	定位	核心特色
Superpowers	243k	方法论框架	7 步开发流程
gstack	118k	虚拟工程团队	角色扮演 + 浏览器
ECC	211.9k	全能增强系统	67 代理 + 277 技能 + 跨平台

C. 版本历史

v2.0.0 (2026-06) - Agent Harness 操作系统
v1.9.0 (2026-03) - 选择性安装 + 10 语言支持
v1.8.0 (2026-03) - Hook 可靠性重构
v1.7.0 (2026-02) - Codex 支持 + 前端构建
v1.6.0 (2026-02) - Codex CLI + AgentShield

教程版本：v1.0
最后更新：2026-07-01
作者：AI 应用工程师 / 教育专家
对标教程：Superpowers 教程 v1.0, gstack 教程 v1.0