无尘阁日记

无尘阁日记

AI agent 干活又慢又健忘?有人把「harness 优化」做成了能一键装的东西(30 万星)
silcano

github监控器 · 2026-11-10 · 约 3303 字 · affaan-m/ECC

 

同一个模型,别人用起来像老手,你用起来像实习生。差的不是模型,是 harness。

ECC 的定位一句话:把"harness 怎么配"这件事做成可安装的系统——技能、直觉、记忆、安全,四个模块,一条命令。

30 万星,每天涨 1013 星,是这批项目里星数最高的。它同时支持 Claude Code、Codex、Kimi 等多个宿主。下面讲装法、参数、以及它为什么容易装出问题。

一、先说结论:它卖的是「配置」,不是「模型」

harness 这个词这两年被说烂了,但含义很具体:模型之外的一切——系统提示、工具集、记忆怎么存、什么时候该问人、出错怎么退。

同一个模型,harness 不同,产出质量能差一倍。这就是为什么有人用 Claude Code 效率惊人,有人用同一个工具却觉得"也就那样"。

ECC 的主张是:这套配置不该每次自己摸,应该有一套经过打磨的默认值,装上就有。

ECC 数据卡

二、它的四个模块分别管什么

README 的副标题列了四个词,我逐个解释:


模块
管什么
没有它会怎样
Skills(技能)
把方法论打包成可调用的能力
每次都要重新教它怎么做
Instincts(直觉)
默认行为倾向,不用每次交代
它总做你不想要的那种选择
Memory(记忆)
跨会话保留项目知识
每次都从零介绍你的项目
Security(安全)
权限边界、危险操作拦截
它可能删掉不该删的东西

第三行是最容易被低估的。"健忘"是所有 agent 的通病——它不知道你三天前定过的命名规范,于是又发明一套。

第四行是最容易被忽略的。一个装了技能和记忆的 agent,权限比裸模型大得多,没有安全层就是纯风险。

三、流水线:它想让你按这个顺序干活

README 里给了一条七步流水线,这是整套方法的骨架:

plan -> test -> implement -> review -> verify -> remember -> improve

逐条说:

  1. plan:先出方案,不写代码;
  2. test:先写测试,把"对"定义下来;
  3. implement:实现到测试通过;
  4. review:自己审一遍(换一个视角,不是同一轮对话);
  5. verify:跑验证,拿证据;
  6. remember:把这次学到的东西写进记忆;
  7. improve:改进 harness 本身,下次更好。

第六步和第七步是分水岭。大部分人的 agent 用完就忘,所以永远不会变强。

这条流水线最值得抄的不是顺序,是"remember"这一步:每次任务结束,让它把"这次踩了什么坑"写进一个固定文件。一个月后你会有一份自己的 harness 笔记。

四、装:先看三种路径,只选一种

README 强调了一句很重要的话:"Pick one path only (per harness)"——每个宿主只选一条路,不要叠。

这是因为它踩过一个坑:用 guided 装完,又手动装一遍,两套配置打架。

路径 A:一条命令,交互式。

npx ecc-universal@2.2.3 setup

路径 B:guided 显式安装。 这条最可控,参数能写全:

npx ecc-universal@2.2.3 install --guided

路径 C:非交互,全参数。 适合脚本化、或者你清楚自己要什么:

npx ecc-universal@2.2.3 install --guided \
--harness claude --harness codex --harness kimi \
--claude-scope local --claude-hooks standard \
--profile core --yes

这几个参数的含义:


参数
作用
建议
--harness
装到哪些宿主,可重复
只写你真在用的
--claude-scope
local 只当前项目,全局则所有项目
先用 local
--claude-hooks
钩子的严格程度
先 standard,别一上来 strict
--profile
配置档位(core 是精简档)
先 core
--yes
跳过确认
只在脚本里用

装之前先确认三件事,README 里也是这么要求的:

node --version
git --version
claude --version

三个命令都有输出,再开始装。少一个都会装到一半失败。

README 里的示意图

五、版本要钉死

命令里那个 @2.2.3 不是装饰。

不写版本号,npx 会拉最新的;最新版可能改了参数名,你的脚本就崩了。README 给的例子全部带版本号,这是有意为之。

查当前最新版:

npm view ecc-universal version

升级的时候,先看这个再改命令里的版本号,别让它自己升。

六、安全:官方来源只有这几个

README 开头就有一段 WARNING,列了唯一可信的安装来源:


类型
可信来源
仓库
github.com/affaan-m/ECC
npm 包
ecc-universal、ecc-agent-shield
插件
ecc@ecc
GitHub App
官方那个
网站
ecc.tools

为什么这句要放在最前面?因为这类"高星 harness 配置包"是供应链攻击的完美目标:它要装钩子、要读写你的项目、要访问你的凭据。

一个冒名包能做到什么?在 hook 里塞一行 curl,你的 key 就出去了。

所以:装之前核一遍来源,一个字符都不能差。

七、七个坑,按踩到的概率排

  • 两条路都装。 guided 装完又手动装,两套配置打架。只选一条;
  • 不钉版本。 明天 npx 拉到新版,参数变了,脚本崩;
  • 一上来就 strict hooks。 钩子太严会拦掉正常操作,你会以为是工具坏了;
  • 装到不用的宿主。 --harness 写一堆,配置文件到处是,以后很难清;
  • 用全局 scope 试水。 先用 local,确认没问题再全局;
  • 不看它改了什么。 它会改写你的 agent 配置,装完 diff 一遍;
  • 以为装完就变强。 它给的是默认值,你还要按流水线用起来。

第六条我要强调:装之前先备份你的 agent 配置目录。出问题时你能一条命令退回去。

八、付费版和开源版的边界

README 里提到了 ECC Pro + GitHub App:免费可装,私有仓库 $19/席/月。

这个模式值得说清楚,因为它影响你的选择:


开源版
Pro
核心 harness 配置
有
有
私有仓库支持
自己搞
有
团队协作
无
有
价格
免费
$19/席/月起

个人用开源版够了。团队要"统一配置 + 私有仓库",才需要考虑付费。

README 里的指南图

九、为什么它能涨 30 万星

三个原因:

  1. 它解决的是"第二条曲线"的问题。 模型能力提升是第一条曲线,harness 优化是第二条——而第二条现在更便宜;
  2. 它跨宿主。 Claude Code、Codex、Kimi 都能装,用户基数直接翻几倍;
  3. 它的 README 像产品文档。 有参数表、有警告、有路径选择,不像一个"随手整理"的配置仓库。

第三条最容易被忽略。高星项目的 README 都有同一个特征:它替你做决定。"只选一条路"这句话,就是替犹豫的人做决定。

十、谁该装


你是谁
建议
天天用 Claude Code / Codex 的人
强烈建议,先 core 档试一周
团队要统一 agent 配置
建议,但要先做备份和回滚方案
偶尔用一下 AI 写代码
别装,配置成本高于收益
在自己产品里集成 agent
可以读它的模块划分,不一定要装
对供应链敏感
自己读一遍安装脚本再装

十一、和 Ponytail 那类"单一技能"的区别

前面写过 Ponytail(让 agent 少写代码)。两者不是一个层级:


单一技能
ECC
范围
一个行为约束
整套 harness 配置
侵入性
低,删掉就没了
高,改了你的配置
组合
可以叠好几个
一个宿主只装一套
风险
低
中(改配置 + 装钩子)

结论:技能可以试错,harness 配置要先备份。

十二、版本与地址


用途
地址
仓库
github.com/affaan-m/ECC
网站
ecc.tools
npm
ecc-universal、ecc-agent-shield
插件
ecc@ecc
版本
2.2.3
包名: ecc-universal
版本: 2.2.3
许可: MIT
支持宿主: Claude Code / Codex / Qoder / Kimi / Cursor / Gemini / OpenCode
推荐安装: npx ecc-universal@2.2.3 install --guided --profile core

最后一句:ECC 真正教给你的不是那套配置,而是那条七步流水线里最后两步——remember 和 improve。一个不会记住的 agent,用一百次还是第一次。

 

关于作者 · 江天(楠哥)
AI 实战导师 / 企业 AI 落地顾问 / 智能体工程师,17 年跨界、15,000+ 小时 AI 实操、20+ 套已交付工作流。