国内聊 AI 编程技巧,翻来覆去还是提示词和补全设置那几招。但海外 GitHub 上有个叫 ECC 的仓库,截至 2026 年 10 月 11 日已经拿到约 27.7 万星(来源:github.com/affaan-m/ECC),它把「调教 AI Agent」从玄学做成了工程系统。更妙的是:它 README 里那批省 token、防搞砸、自动学习的开关,大部分不装整套框架也能单独抄走。今天把这八个暗门一次性挖开。
ECC 的自我定位是一句话:Agent Harness Operating System——不是又一个提示词合集,而是给 AI 编程代理装上一条「先计划、先写测试、再实现、换新上下文审查、验证、记忆、进化」的流水线。作者 affaan 是 Anthropic x Forum Ventures 黑客松(2025 年 9 月)冠军队成员,这套配置在多个生产项目里实战打磨过。
三个硬数据:MIT 协议完全开源;README 自述内置 68 个专职 agent、286 个技能、94 条命令;星标曲线显示 2026 年 1 月 18 日到 2 月 7 日的 20 天里从零冲到 4 万星(README 星史图注),如今与 superpowers、mattpocock/skills 同列 GitHub 全站头部。
对中国用户有个容易被忽略的点:它不只支持 Claude Code(主力)、Codex、Cursor、OpenCode、GitHub Copilot,还官方适配了 Kimi Code、Qwen CLI、CodeBuddy、JoyCode 这些国产系 harness——同一套工作流可以平移到你手头任何工具上。ECC 2.1 的公开赞助商名单里甚至有月之暗面(Moonshot AI)。它的核心工作流长这样:
flowchart TD
A["plan 先立计划"] --> B["test 先写失败测试"]
B --> C["implement 最小实现"]
C --> D["review 换新上下文审查"]
D --> E["verify 构建测试双验证"]
E --> F["remember 沉淀会话记忆"]
F --> G["improve 本能聚合成技能"]
G -->|进入下一个任务| A
注意审查那一环:ECC 坚持让一个全新上下文的 reviewer 去查刚写的代码,而不是让同一个会话既当运动员又当裁判——这是它和普通提示词技巧最本质的区别。
下面进入正题,八个暗门按「立即可抄」程度排序。
这是 ECC 官方 Token 优化指南里最值钱的一段,不用装 ECC,直接写进 ~/.claude/settings.json:
{
"model": "sonnet",
"env": {
"MAX_THINKING_TOKENS": "10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
}
}
README 给的账本:默认模型从 opus 换成 sonnet,成本降约 60%,而 80% 以上的编码任务 sonnet 完全够用;MAX_THINKING_TOKENS 从默认 31,999 砍到 10,000,隐藏思考开销省约 70%;自动压缩阈值从 95 提前到 50,长会话质量反而更好。Opus 留给架构设计和硬核调试,用 /model opus 临时切换。三行配置,月账单直接换一个量级。
ECC 文档里有个很多人没意识到的数字:每个 MCP 工具的描述都常驻你的上下文窗口,全开的话,200k 窗口能被吃到只剩约 70k——模型还没干活,四成智力已经交房租了。守则三条:单个项目启用不超过 10 个 MCP;活跃工具控制在 80 个以内;不用的用 /mcp 关掉(选择会持久化)。ECC 自己在 2026 年 6 月一次审计后,把默认自带的 MCP 连接器从六个砍到一个(只留 chrome-devtools),就是这个逻辑。装插件前先问一句:这个工具的描述,值不值两万 token 的房租?
/compact 不是救命按钮,是择时艺术。ECC 的 strategic-compact 技能给出了明确时机表:该压——调研完准备动手前、里程碑完成后、debug 结束时、一条路走不通换路之前;不该压——实现进行到一半,因为变量名、文件路径、半成品状态会一起丢。自动压缩在 95% 才触发,那时丢掉的往往是最值钱的上下文;在逻辑断点手动压,等于给会话做无损转码。
Hooks(钩子)在模型上下文之外跑确定性检查,是唯一不烧 token 的质检手段。ECC 把全部调教做成了环境变量:ECC_HOOK_PROFILE=minimal|standard|strict 三档严格度;ECC_DISABLED_HOOKS 按名字精确关掉某条(比如烦人的 tmux 提醒);ECC_SESSION_START_MAX_CHARS=4000 把会话启动注入从默认 8000 字符砍半;本地小模型用户直接 ECC_SESSION_START_CONTEXT=off 全关。还有两个 instinct 相关的:ECC_MAX_INJECTED_INSTINCTS=6 控制注入的经验条数,ECC_INSTINCT_CONFIDENCE_THRESHOLD=0.7 只让置信度 70% 以上的「本能」进入上下文。换个场景改个环境变量,不用动任何配置文件。
这是中文圈几乎没人写的一块:CLAUDE.md、settings.json、hooks、MCP 配置本身就是可执行配置,是攻击面。恶意仓库可以在项目级配置里埋注入。ECC 的 AgentShield(2026 年 2 月 Cerebral Valley x Anthropic 黑客松产物,102 条静态规则、1282 个测试)一条命令扫描:
npx -y ecc-agentshield scan --path .
扫 14 种密钥泄露模式、权限越界、hook 注入、MCP 风险,输出 A-F 评分;--fix 自动修复安全问题;--opus 会起三个 Opus 4.6 agent 做红队、蓝队、审计的对抗流水线;JSON 输出加「发现严重问题时退出码为 2」,可以直接挂进 CI 当门禁。接手别人的项目、或者从网上抄配置之前,先跑一遍这个,三十秒买个安心。
ECC 的 continuous-learning-v2 是一套带置信度的经验系统:会话结束后自动提炼「instinct(本能)」,每条都标注置信度。/instinct-status 查看学到了什么;/instinct-export 和 /instinct-import 让团队之间互相传递调教成果——老师傅的 Agent 用三个月攒下的本能,新人一条命令导入;/evolve 把高频出现的本能自动聚类升级成正式技能。这套东西解决的是 AI 编程最隐蔽的浪费:同一个坑,每个新会话都要重新踩一遍。
同时用 Claude Code 和 Codex 的人都有体会:上下文被困在单个工具里,换工具等于失忆。ECC 的 Memory Vault 用一种本地 Markdown 格式打通所有 harness(Claude、Codex、Kimi、OpenClaw、Hermes 等):
npm install -g ecc-universal
ecc memory init --scope project
ecc memory handoff --from claude --target codex --title "继续认证迁移" --body-file ./handoff.md
ecc memory search "认证迁移" --target-harness codex
ecc memory doctor
交接内容存在项目里的 .ecc/memory/,走 git 可以审计;ECC 特意规定记忆只是「未经审查的上下文」,Agent 不得把它当指令执行——防止记忆投毒。另外多 harness 同机的注意 ECC_AGENT_DATA_HOME 环境变量:给 Cursor 设独立数据目录,否则两边会话文件互相覆盖(ECC 在 issue #2065 里专门处理过)。
ECC 最容易翻车的点官方写得明明白白:同一种 harness 只选一条安装路径。装了 Claude 插件(/plugin install ecc@ecc)就别再跑手动 install.sh --profile full——hooks 会被触发两次;Claude Code 2.1+ 会自动加载插件的 hooks.json,再手动复制一份直接报 Duplicate hooks file 错误(这个坑在仓库里引发了 #29、#52、#103 三轮修复拉锯)。装乱了的标准动作是先诊断后卸载:npx ecc-universal doctor、npx ecc-universal repair,最后才考虑 uninstall --dry-run 看清单再删。
| 你以为的 | 实际上 |
|---|---|
| Agent 省钱靠换便宜订阅 | 三个环境变量省 60%-70%,官方数据摆着 |
| MCP 装得越多越强 | 每个 MCP 描述常驻窗口,全开能吃掉六成上下文 |
| /compact 是坏了才按 | 在逻辑断点手动压,质量比自动 95% 触发更好 |
| Hooks 必须手写 JSON | 环境变量三档调教,且完全绕开模型上下文 |
| .claude 配置只是偏好设置 | 它是可执行配置和攻击面,需要像代码一样安检 |
| AI 经验随会话消失 | 本能系统带置信度沉淀,可导出、可继承、可进化 |
| 换工具就要重新交底 | Memory Vault 一份 Markdown 全 harness 交接 |
npx -y ecc-agentshield scan,给你现有配置做个体检。npx ecc-universal setup 全家桶,或 ./install.sh --target claude --skills tdd-workflow,security-review 只装两个技能;拿不准就先问它:node scripts/ecc.js consult "安全审查",它会推荐该装的组件。ECC_AGENT_DATA_HOME。ECC 证明了一件事:2026 年 AI 编程的差距不在模型,在 harness——同一批模型,有人当聊天框用,有人把它调教成一条带质检、带记忆、会自我进化的生产线。
本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
