ECC 项目介绍

ECC 项目介绍

项目定位

ECC（Everything Claude Code）是一个为 AI 编码代理 harness 设计的生产就绪型工作流插件，提供 61 个专业子代理、246 个技能、76 个命令和自动化钩子工作流。它不是简单的配置文件集合，而是一个完整的系统：技能库、记忆优化、持续学习、安全扫描和研究优先开发流程。

核心差异化：ECC 不是”某个 AI 工具的配置”，而是一个跨 harness 的可复用工作流层——同一套技能、规则和钩子可以适配 Claude Code、Codex、Cursor、OpenCode、Gemini 等多种 AI 编码代理。

核心能力

• 专业子代理编排：61 个按语言/领域划分的子代理（planner、code-reviewer、tdd-guide 等），每个代理配备特定模型路由（opus 用于复杂推理、sonnet 用于日常编码）
• 事件驱动钩子系统：基于 PreToolUse/PostToolUse/Stop/SessionStart 生命周期钩子的自动化质量门控、安全检查和持续学习
• 连续学习 v2（Instinct 模型）：通过钩子捕获会话行为 → 后台 Observer Agent 分析 → 原子化 Instinct 提取 → 置信度评分 → 演化为技能/命令/代理
• 跨 Harness 架构：SKILL.md 作为最便携单元，通过薄适配层实现 Claude Code 原生钩子、Codex 指令驱动、OpenCode 插件事件等多表面兼容
• 选择安装管道：基于 Manifest 的模块化安装，支持 profile（full/minimal/custom）和语言按需安装
• Token 与成本优化：战略压缩建议、模型路由、扩展思考控制、子代理模型降级

技术栈

组件	技术
脚本层	Node.js (CommonJS)，跨平台（Windows/macOS/Linux）
代理定义	Markdown + YAML frontmatter
技能定义	Markdown (SKILL.md)
钩子配置	JSON (hooks/hooks.json)
状态存储	SQLite (ECC 2.0 控制平面原型)
构建/分发	npm 包 + 安装脚本
ECC 2.0 控制平面	Rust 原型 (ecc2/)

架构概览

快速体验

ECC 作为 Claude Code 插件运行：

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

# 运行安装脚本
cd ECC
bash install.sh

# 或通过 npm 安装
npm install -g ecc-universal

安装后，在 Claude Code 中即可使用 /tdd、/plan、/code-review、/learn 等命令，以及自动触发的质量门控钩子。

教程导读

本教程分为两个部分：

AI 应用通用知识教程 (/tutorials/ecc/ai/)

从 ECC 出发，教授 AI 代理应用的通用知识：

• Agent 子代理编排 — 专业代理的分类、模型路由与委托模式
• 钩子驱动的事件架构 — 工具生命周期钩子的设计与自动化
• 连续学习与 Instinct 模型 — 会话模式提取、置信度评分与技能演化
• Token 优化与成本管理 — 模型选择、战略压缩与成本控制
• 跨 Harness 可移植性 — 工作流层与适配表面的架构设计

编程核心技术教程 (/tutorials/ecc/dev/)

聚焦 ECC 项目的工程实践：

• 选择安装 Manifest 管道 — 模块化安装系统的架构与实现
• 技能生命周期与分类管理 — Curated/Learned/Imported/Evolved 四类技能的存储与验证
• 规则系统与多语言分层 — Common + Per-Language 规则的设计与安装裁剪
• 测试策略与内部验证 — 997+ 内部测试的 CI 保障
• Rust 控制平面原型 (ECC 2.0) — 从 Node.js 插件到 Rust 二进制的演进路径

引用的通用知识 (Common)

本教程涉及的通用概念已在以下 Common 教程中详述：

• Agent 核心循环设计
• 工具调用协议
• Hook 系统架构
• 记忆系统设计
• 上下文管理策略
• 多模型适配架构
• 多 Agent 路由
• 插件系统设计
• 提示工程组装