把 Claude Code 变成真正的工程团队：ECC 25.3 万星背后的 Agent Harness 系统深度解读

星眸·GitHub 观察者 技术创作者 2026-09-08 17 阅读

把 Claude Code 变成真正的工程团队：ECC 25.3 万星背后的 Agent Harness 系统深度解读

2026年9月的某个凌晨，一个叫 affaan-m 的开发者用 Claude Code 跑了整整一夜。他不是在做 demo，是在真实地做产品——一家 SaaS 公司，上线了，盈利了。那个仓库叫 Everything Claude Code，现在改名叫 ECC（Everything Claude Code 的缩写），GitHub 星标数 252,922，fork 37,939，贡献者超过 270 人。MIT 协议。

这不是一个”AI 提示词合集”。这是一个用 10 个月真实产品开发打磨出来的 Agent Harness 操作系统。

ECC 是什么、不是什么

ECC 的 README 开头有一句话值得原文引用：

“Your agent can write code, but ECC gives it a coordinated engineering system and toolbox.”

ECC 不是一个应用，不需要启动。它是一套配置层——技能（Skills）、本能（Instincts）、记忆（Memory）、安全扫描（Security）、规则（Rules）和命令（Commands）——装在你已有的 Claude Code、Codex、Cursor、OpenCode、Gemini、Zed、Github Copilot 等 15 种以上的 Agent 宿主上。

模型再强，套在一团乱的 harness 上，效果也飘。ECC 想解决的就是这个 harness 问题。

它的核心价值主张一句话：优化 context window，把剩下的都持久化。

真实数字：252,922 星是怎么来的

  • 68 个专业子 Agent：planner（规划）、architect（架构）、security-reviewer（安全审查）、build-repairer（构建修复）、code-reviewer（代码审查）……每个 Agent 专注一类任务，不是让一个通用上下文窗口同时处理所有事
  • 286 项技能：覆盖 TDD、前端模式、后端模式、安全研究、机器学习工程、DevOps、视频剪辑、演示文稿、API 设计……按语言分包，TypeScript/Python/Go/Swift/Rust 各一套
  • 94 条命令：/plan、/security-scan、/harness-audit、/loop-start、/quality-gate、/model-route……
  • AgentShield 安全扫描：1282 条规则扫描 MCP 配置、权限、密钥泄露、prompt injection 等威胁向量
  • Token 压缩：官方称平均节省 73% 的 token 消耗，响应提及有项目达到 60-95% 的压缩比

v2.2.0（2026-08-28）新增引导式安装器、Antigravity 2.0 和 Nasiko CLI；v2.0.0（2026-06-10）带来了跨 Harness 的 Agent 体系；当前最新稳定版 v2.2.1 距今不到 10 天，仍在高频维护。

它的核心能力，分别解决什么问题

1. 记忆持久化（Memory Persistence）

大多数 Agent 每次会话都从零开始。ECC 用 SessionStart/Stop 钩子自动保存和加载上下文——你的 Agent 不再需要每次重新解释项目背景。这解决了”跨会话总是从头讲背景”这个高频痛点。

2. 本能系统（Instincts）

和传统 Skills 需要显式触发不同，Instincts 是始终开启的行为修正器。比如：一个 Instinct 可以让 Agent 在 TypeScript 项目中总是先验证编译再宣布任务完成，另一个可以让 Agent 在 React 项目中优先使用函数式编程模式。这是”持续学习”的核心——从真实会话中自动提取模式并固化为可复用资产。

3. Token 优化（Token Optimization）

不是简单的截断。ECC 的方法论包括：模型选择、系统 prompt 精简、把工作推向后台进程。压缩过滤器默认保留代码 diff、错误信息、文件内容等关键信息，仅过滤终端日志、目录列表等”噪音”。官方数据显示平均压缩 73%，balanced 模式（约默认）下丢失关键信息的概率约 2%。

4. 跨 Harness 适配

同一套 Skills 和 Rules 可以同时跑在 Claude Code、Cursor、OpenCode 上，无需各自配置。但 ECC 2.0.0 的跨 Harness 数据隔离有一个已知细节值得注意：如果你在同一台机器上同时用 Claude Code 和 Cursor 运行 ECC，需要设置 ECC_AGENT_DATA_HOME 环境变量指向不同的目录，否则两个环境会互相覆盖对方的 session 文件。

5. 安全扫描（AgentShield）

ECC 不是单纯分享提示词的合集。它把安全当成一等工程问题：攻击向量分析、沙箱配置、sanitization、CVEs 跟踪。/security-scan 命令直接从 Claude Code 内部运行 AgentShield 扫描 MCP 配置和 hook 权限。

谁该用、谁该等

适合用 ECC 的人：

  • 每天用 Claude Code / Cursor / Codex 跑真实项目的开发者或团队
  • 想让团队多个成员使用统一 harness 配置，不想各自维护一套 dotfiles
  • Token 消耗量大，想系统性地做成本优化
  • 安全敏感项目，需要防止 prompt injection 和密钥泄露
  • 在不同 Agent 工具之间切换，不想每次从零配置

不适合用 ECC 的人：

  • 偶尔让 AI 帮你写点小脚本的用户——系统比需求大
  • 只想要一堆现成 Skills 的用户——ECC 的价值在 Guide 里，不只是文件里
  • 追求开箱即用、完全零配置的体验——完整安装需要理解 Skills/Rules/Hooks/Instincts 四个子系统

ECC 的 README 说得很坦白：这个仓库是原始代码，Guide 解释一切。不理解 Guide 就直接安装文件，用起来会像”别人写的 dotfiles”，感受不到系统设计的逻辑。

和同类相比怎么样

对比维度 ECC 手工维护 Agent 配置 独立 Agent 运行时
核心定位 跨 harness 的 Agent 优化操作层 逐个仓库手写配置 自身即 Agent，另起一套
适用范围 15+ harness 绑定单一工具 不适用
记忆与学习 Instincts 持续学习、跨会话记忆 无 内置或另配
安全能力 AgentShield 1282 条规则扫描 无 内置或另配
安装方式 引导式安装器或插件市场 手工配置 一条命令部署
Token 优化 完整方法论 + 工具支持 无 无

ECC 和 Superpowers（另一个高星 AI 编程相关项目）是互补关系：ECC 侧重 harness 层面（工具、记忆、安全、性能），Superpowers 侧重开发流程层面（设计、TDD、代码审查）。两者叠加可以构建一个既有工程纪律又有性能优化的 AI 编程环境。

怎么安装

ECC 的安装有两种路径，官方推荐用 Claude Code 插件市场，且明确要求每次只用一种安装方式，不要叠加：

方式 A：插件市场（推荐）

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

方式 B：手动克隆（需要更多配置）

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh typescript python  # 选择你的语言栈

规则（Rules）需要单独安装——因为 Claude Code 插件无法自动分发规则文件：

mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/  # 替换为你的语言栈

ECC 是 MIT 协议的开源项目，核心代码永久免费。ECC Pro 是面向私有仓库的 GitHub App（$19/座位/月），另有 $5/月起的 Sponsor 选项资助开源开发。

下一步建议

  1. 如果你用 Claude Code：今天就在终端跑 /plugin marketplace add https://github.com/affaan-m/ECC，然后读一下 The Shorthand Guide（ECC 的精华概览，GitHub 上 10K+ 书签的那篇）
  2. 如果你在团队中推 AI 编程：先从 rules/common + 一种语言包开始，不要一次性装全套——从核心子集逐步引入，观察哪些问题是团队的真实痛点，再决定引入哪些 Skills
  3. 如果你关心 Token 成本：跑 /model-route 了解当前模型分配，然后读 Token Optimization Guide——ECC 的压缩逻辑不是简单截断，理解其设计才能用好它
  4. 安全敏感项目：立即跑 /security-scan，AgentShield 的 1282 条规则会扫描你当前项目 MCP 配置和 hook 权限

ECC 不是一个”装了就能用好”的项目。它更像一份经过 10 个月生产验证的工程规范——想用好它，得先理解它的思路。这个学习成本是真实的，但对于认真做 AI 编程工程的团队来说，这个投入值得。

相关链接

评论区

0 条评论

登录后可评论。

星眸·GitHub 观察者 17 阅读