01 · 这件事

30.6 万星、327 个技能:先读仓库,别先装插件

ECC 的星标已经到 306,038,但最新 Release 停在 10 月 1 日,仓库本身在 11 月 17 日仍有推送。affaan-m/ECC 创建于 2026-01-18,MIT,主语言 JavaScript,自述是 agent harness 的性能优化系统。

核对日 2026-11-18,它有 45,042 个 fork、163 个未结条目。未结不等于全是 bug:拆开看是 93 个 issue 与 70 个 PR,PR 数接近 issue 的四分之三。

根目录还摊开了一排以点开头的适配目录:.claude、.codex、.cursor、.gemini、.qwen,以及 .claude-plugin、.codex-plugin、.grok-plugin 等插件清单。它不是一份编辑器配置,而是一张分发矩阵。

README 首页还列了 17 种语言入口,中文版单独占一个 38,234 字节的文件。它同时声明根是唯一事实源,平台适配器只是打包或映射这套工作流,不另存副本。

更值得写下来的是仓库体量。根目录 87 个条目,skills/ 327 个子目录,agents/ 72 个文件,commands/ 98 个文件。这三个数与 README 首页的 327 / 72 / 98 逐项对得上。

字段核对值
仓库affaan-m/ECC · main 分支
星标 / fork / 未结306,038 / 45,042 / 163(93 issue + 70 PR)
建库 / 最近推送2026-01-18 / 2026-11-17
许可证 / 主语言MIT / JavaScript
最新版本 / 发布日期v2.2.3 / 2026-10-01
README 体积117,671 字节,中文版 38,234 字节

README 用一行概括目标:把 plan、test、implement、review、verify、remember、improve 变成 agent 的默认工作流。它要交付的不是某一个 skill,而是一条被反复复用的工程流程。

02 · 核心机制

技能是主界面,命令只是迁移期的壳

ECC 把能力分成四层:skills 承载流程,agents 负责委派,hooks 在工具事件上执行约束,rules 常驻上下文。README 明说新工作流先落在 skills,commands 只作兼容入口。

README 给的 TDD 技能示例是五步:先定接口,再写失败测试,接着做最小实现,然后重构,最后验 80% 以上覆盖率。流程被写成可调用的步骤,而不是一句「记得写测试」。

Agent 的定义写在 YAML frontmatter 里。README 举例的 code-reviewer 只拿 Read、Grep、Glob、Bash 四个工具,模型指定 opus。权限写在角色文件里,比在提示词里说一句「只审查」更硬。

Hooks 能跑 shell,MCP 能持凭据,项目指令会进上下文。README 把三者并列为必须按可执行配置审阅的对象,而不是普通文本配置。

持续学习会把会话摘要和学到的 instinct 写进 agent data home,默认落在 ~/.claude。会话开始时可注入的 instinct 默认最多 6 条,置信度阈值 0.7,两者都能用环境变量改。

03 · 关键细节与数据

327 是仓库总量,不是每个平台都拿得到的清单

同一个仓库在五个 harness 上并不对等,README 自己把 parity 一栏写成 Primary 对 Partial。支持表把 Claude Code 列为 stable primary,其余四个都只给部分能力。

能力Claude CodeCodexCursorOpenCodeCopilot
Skills原生安装集原生插件集随构建变化内置子集原生发现
Agents原生 agents多 agent 角色项目级、随构建变化插件 agentsCLI 自定义 agents
ECC hooks原生插件钩子需显式信任的子集适配器分发插件事件未移植
MCP 配置显式启用原生 manifest项目 / 用户配置provider 配置ECC 不提供
与 Claude 对齐PrimaryPartialPartialPartialPartial

各平台还有自己的硬数。pi/core 配置在 v2.2.3 里是 123 个精选 skill、24 条命令;Codex 的 .agents/skills/ 写 32;Cursor 写 48 个 agent、34 条规则、15 个 hook 事件。

把四组数字并列,「327」的口径就清楚了:它数的是仓库源目录,不是某次安装后可见的技能数。README 还提醒,插件会把已装目录广告给模型,上下文吃紧时要改用 selective profile。

口径数量出处
仓库 skills/ 子目录327目录接口实测
pi/core 精选配置123 skills + 24 命令v2.2.3 Release 正文
Codex .agents/skills/32README 平台说明
Cursor 项目适配48 agents / 34 规则 / 15 hook 事件README Cursor 小节

渠道也要核。README 只认五个官方入口:GitHub 仓库、插件 slug ecc@ecc、两个 npm 包、GitHub App 与官网;第三方转载被明确标为可能带恶意软件。SECURITY.md 还点名两个借用仓库元数据的非官方包。

数据核对:全部数字来自 api.github.com 仓库、目录、releases 与 search 接口,以及仓库内 README、SECURITY.md、package.json、VERSION 原文。

核对时间 2026-11-18,星标与 issue 为实时值。

04 · 怎么用

先选安装路径,再把 hook 的决策显式做完

安装 ECC 的第一步不是敲命令,是选 profile 和 target;全量 manual 安装不要叠在 native plugin 上。README 写得很直接:两条路选一条。

MCP 不是越多越好。README 写默认连接器只有一个 chrome-devtools,其余是包着 CLI / REST API 的技能,或需要主动勾选的目录项;2026 年 6 月的审计还下线了原先六个默认连接器。

hook 必须显式决定。没有 --enable-hooks 或 --no-hooks,安装器会先打印钩子能做什么,然后停在写入前;引导安装则会交互询问。

环境门槛不高但很硬:Node.js 18 以上,Claude Code 插件要 v2.1.0 以上。Claude Code v2.1+ 会自动加载 hooks/hooks.json,再往 plugin.json 写 hooks 字段会触发重复检测错误。

跨工具混用先隔离数据目录:ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"。会话摘要、学到的技能、别名和成本指标都落在这个根下,不隔离就会互相覆盖。

省 token 的调整照 README 自己的表来,别当成实测结论:它建议 opus 换 sonnet、自动压缩阈值从 95 调到 50,同时保持 MCP 少于 10 个、活跃工具少于 80 个。

05 · 冷思考

30 万星里能直接拿走的是流程,不是全平台等价

先别把 163 个未结条目读成 163 个 bug:其中 70 个是 PR,维护压力正写在 issue 里。#3997 记录了一次 PR 洪水,20 分钟内 23 个 PR 触发了「超过 5 个关闭、超过 10 个封禁」的策略。

那条 issue 同时写明封禁令牌未配置,所以只关不封。另一条 #4017 是会话摘要含冒号,写出的 YAML frontmatter 解析失败。这些不是功能列表,是日常维护成本。

版本节奏也值得问一句:README 说一个人每周跨 7 个 harness 发版,最新 Release 却是 10 月 1 日的 v2.2.3,没有资产,pushed 停在 11 月 17 日。发布通道与开发节奏不是一条线。

平台差异是硬边界,下面几条都写在 README 或 SECURITY.md 里:

成本建议也要留个问号。「换 sonnet 省约 60%、覆盖八成以上任务」是 README 的推荐表,不是仓库里跑出来的基准;正文没有给出评测链接。

它同时提醒:Bedrock、Google Cloud 的 Agent Platform 与 Foundry 上的 sonnet 别名指向 Sonnet 4.5,不支持 effort 控制;要么换一个支持该控制的模型,要么把这个变量整个删掉。

安全报告路径也要看清:SECURITY.md 说 security@ecc.tools 别名无人监控,要发到 affaan@ecc.tools;承诺 48 小时确认、7 天初评、14 天出关键修复目标,但旧版本回补补丁写明 best-effort。

结论不是别装。ECC 值得抄走的是 plan → test → review → remember 这条闭环;如果你的 harness 在支持表里写着 Partial,就按 selective 装,把 hook 当代码审,别把 327 当成开箱即用的承诺。

去看原始仓库

把规划、测试、评审、记忆做成 agent 默认流程的 MIT 开源项目,Node.js 18 以上即可安装

前往 GitHub

相关平台

#Skill #开源 #Agent #Claude Code #Harness