affaan-m/ECC · 上手攻略

  • 仓库：affaan-m/ECC
  • 链接：https://github.com/affaan-m/ECC
  • 分类：ai · agent · skill · engineering
  • 作者：Jay
  • 更新：2026-07-04

这是什么

ECC = Everything Claude Code，但实际上它已经演进为 Agent Harness 操作系统（Agentic Harness Operating System）——一个横跨 Claude Code、Codex、Cursor、OpenCode、Gemini CLI 等主流 AI Agent 平台的配置、插件、技能和运营规范体系。

核心定位：不管你用哪个 Agent Harness，ECC 把"最佳实践"打包成可复用的模块（技能 261 个、运营命令 93 个、Agent 配置 64+ 个），让你开箱即用，而不是每次重头配置。

ECC 起源于 Anthropic 黑客马拉松获奖项目，经历了 10+ 个月真实产品开发迭代，2026 年 6 月发布 v2.0.0 稳定版，是目前规模最大的 Claude Code 配置库（Stars 22.5 万）。

解决什么问题

  • 每个新 AI 编程助手都需要大量手动配置，ECC 提供开箱即用的最佳实践
  • Token 成本高：ECC 有完整的 Token 优化策略（模型选择、提示精简、后置进程）
  • 跨项目、跨会话的上下文记忆：ECC 提供 Hook 机制自动持久化上下文
  • 安全问题：ECC 内置 AgentShield 安全扫描，检测配置中的攻击向量
  • 跨 Harness 迁移：同一套技能体系可以在 Claude Code ↔ Codex ↔ Cursor 间无缝切换

快速安装

方式一：npm 快速安装（推荐）

npm install -g ecc-universal

ECC v2.0.0 已内置 261 个技能 + 64 个 Agent 配置，跨 Claude Code / Codex / OpenCode / Cursor 通用。

方式二：GitHub App（一键授权，适合团队）

1. 访问 https://github.com/apps/ecc-tools
2. 安装并授权到目标仓库
3. 自动完成 repo 级别的规则注入

GitHub App 支持 PR 审计、公共仓库免费、私有仓库 $19/seat/月（ECC Pro）。

方式三：插件市场安装（Claude Code）

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

# 安装插件（统一命名空间）
/plugin install ecc@ecc

⚠️ 注意：如果已经通过 /plugin install 安装了 ECC，不要再运行完整安装脚本（./install.sh --profile full），否则会导致技能重复。

方式四：手动安装（仅规则文件）

git clone https://github.com/affaan-m/ECC.git
cd ECC

# 只复制需要的规则（插件安装路径推荐）
mkdir -p ~/.claude/rules
cp -R rules/common ~/.claude/rules/
cp -R rules/typescript ~/.claude/rules/

核心用法

1. 使用 slash 命令

安装后，自动注册 93+ 个运营命令：

# 规划任务
/ecc:plan "添加用户认证"

// 或手动安装的简短形式：
/plan "添加用户认证"

// 批量并行规划（需安装 ccg-workflow）
/multi-plan "重构用户模块"

2. 查看可用命令

/plugin list ecc@ecc

3. Token 优化（ECC 核心价值）

ECC 提供完整的 Token 消耗优化方案：

# 设置首选包管理器（自动检测 npm/pnpm/yarn/bun）
export CLAUDE_PACKAGE_MANAGER=pnpm

# 或通过项目配置
node scripts/setup-package-manager.js --global pnpm

ECC 的 Token 优化包括： - 模型选择：按任务类型选最划算模型（非默认最贵） - 系统提示精简：去除冗余描述，保持最小化 - 后台进程管理：分离耗时任务，减少主会话 Token 占用 - 上下文压缩：自动压缩历史消息

4. 持续学习（Continuous Learning）

ECC 的 Hook 机制能从当前会话中自动提取模式，沉淀为可重用的技能文件，无需手动维护。

5. AgentShield 安全扫描

# 检查当前配置的攻击向量
/ecc:shield scan

检测范围：配置文件、Hook、MCP 扩展、Agent 表面。

6. 跨 Harness 工作流

ECC 2.0.0 引入 orch-* 系列编排器，支持在多个 Harness 间分布式执行任务：

# 启动跨 Harness 编排
/ecc:orch run --profile full

# 查看 orchestrator 家族
/ecc:orch list

7. Worktree 生命周期服务

ECC 支持 Git worktree 并行执行多任务：

# 创建并行工作分支
/ecc:worktree create feature-a
/ecc:worktree create feature-b

典型适用场景

  • 团队 AI 编程标准化：用 GitHub App 一键给所有仓库注入最佳实践
  • 个人开发者效率提升：Token 优化 + 记忆持久化 = 每次会话从零成本开始
  • 跨 Harness 迁移：换工具时不需要重新配置所有技能
  • 安全合规场景：AgentShield 自动扫描配置文件中的潜在攻击向量
  • 长程复杂任务：worktree + multi-* 命令并行推进多个子任务

坑与注意

  1. 插件安装和完整安装脚本不可叠加：先 /plugin install 了再跑 ./install.sh --profile full 会导致技能重复、行为异常。
  2. multi-* 命令需要额外安装 ccg-workflow 运行时： bash npx ccg-workflow 未安装时 /multi-plan、/multi-execute 等命令无法使用。
  3. 私有仓库需要付费：GitHub App 免费用于公共仓库，私有仓库 $19/seat/月（ECC Pro）。
  4. 跨 Harness 兼容性：ECC 主要基于 Claude Code 设计，Codex/OpenCode 部分功能可能有差异，建议以 OSS 安装脚本测试。
  5. 中文文档更新可能有延迟：ECC 有 12+ 语言翻译，部分翻译可能滞后于英文版。
  6. v2.0.0 ECC 2.0 是 Rust 控制层，需要本地构建 ecc2/ 目录，尚未默认启用。
  7. 注意安装来源：只从 github.com/affaan-m/ECC、npm 的 ecc-universal、GitHub App 安装，警惕第三方镜像（README 明确警告）。

与同类对比

工具 定位 规模 跨 Harness 开源
ECC Agent Harness 操作系统 261 技能 / 93 命令 / 64 Agent ✅ 全系列 ✅ MIT
Claude Code 默认配置 基础 官方内置 ❌ ❌
Cursor Rules IDE 规则 自定义 ❌ ❌
Windsurf Cascade 规则 自定义 ❌ ❌
openai/codex OpenAI Codex 官方内置 ❌ ❌

ECC 是目前规模最大、维护最活跃的跨 Harness 配置库，尤其在 Claude Code 生态中几乎无可替代。

一句话推荐结论

无论你用 Claude Code、Codex 还是 Cursor——ECC 都是目前最完整的"最佳实践装备库"，尤其适合 Token 成本敏感、需要跨项目复用、以及对安全有要求的专业开发者。

来源：GitHub README、README.zh-CN.md（中文）、ecc.tools 官网、ECC 2.0.0 release notes 不确定处：ECC v2.0.0 的 Rust 控制层（ecc2/）仍为 Alpha 阶段，稳定性未知；中文翻译可能略滞后于英文 master 分支。