## 一句话信息差 国内聊 AI 编程技巧，翻来覆去还是提示词和补全设置那几招。但海外 GitHub 上有个叫 **ECC** 的仓库，截至 2026 年 10 月 11 日已经拿到约 27.7 万星（来源：[github.com/affaan-m/ECC](https://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）。它的核心工作流长这样： ```mermaid 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`： ```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` 临时切换。三行配置，月账单直接换一个量级。 ## 暗门二：MCP 是上下文黑洞 ECC 文档里有个很多人没意识到的数字：**每个 MCP 工具的描述都常驻你的上下文窗口**，全开的话，200k 窗口能被吃到只剩约 70k——模型还没干活，四成智力已经交房租了。守则三条：单个项目启用不超过 10 个 MCP；活跃工具控制在 80 个以内；不用的用 `/mcp` 关掉（选择会持久化）。ECC 自己在 2026 年 6 月一次审计后，把默认自带的 MCP 连接器从六个砍到一个（只留 chrome-devtools），就是这个逻辑。装插件前先问一句：这个工具的描述，值不值两万 token 的房租？ ## 暗门三：压缩要挑时点，别等 95% `/compact` 不是救命按钮，是择时艺术。ECC 的 strategic-compact 技能给出了明确时机表：**该压**——调研完准备动手前、里程碑完成后、debug 结束时、一条路走不通换路之前；**不该压**——实现进行到一半，因为变量名、文件路径、半成品状态会一起丢。自动压缩在 95% 才触发，那时丢掉的往往是最值钱的上下文；在逻辑断点手动压，等于给会话做无损转码。 ## 暗门四：Hooks 不用改文件，环境变量就能调教 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% 以上的「本能」进入上下文。换个场景改个环境变量，不用动任何配置文件。 ## 暗门五：给你的 Agent 配置做安检 这是中文圈几乎没人写的一块：**CLAUDE.md、settings.json、hooks、MCP 配置本身就是可执行配置，是攻击面**。恶意仓库可以在项目级配置里埋注入。ECC 的 AgentShield（2026 年 2 月 Cerebral Valley x Anthropic 黑客松产物，102 条静态规则、1282 个测试）一条命令扫描： ```bash npx -y ecc-agentshield scan --path . ``` 扫 14 种密钥泄露模式、权限越界、hook 注入、MCP 风险，输出 A-F 评分；`--fix` 自动修复安全问题；`--opus` 会起三个 Opus 4.6 agent 做红队、蓝队、审计的对抗流水线；JSON 输出加「发现严重问题时退出码为 2」，可以直接挂进 CI 当门禁。接手别人的项目、或者从网上抄配置之前，先跑一遍这个，三十秒买个安心。 ## 暗门六：让 Agent 把你的套路学成「本能」 ECC 的 continuous-learning-v2 是一套带置信度的经验系统：会话结束后自动提炼「instinct（本能）」，每条都标注置信度。`/instinct-status` 查看学到了什么；`/instinct-export` 和 `/instinct-import` 让团队之间互相传递调教成果——老师傅的 Agent 用三个月攒下的本能，新人一条命令导入；`/evolve` 把高频出现的本能自动聚类升级成正式技能。这套东西解决的是 AI 编程最隐蔽的浪费：同一个坑，每个新会话都要重新踩一遍。 ## 暗门七：跨工具交接班，Context 别跟着人走 同时用 Claude Code 和 Codex 的人都有体会：上下文被困在单个工具里，换工具等于失忆。ECC 的 Memory Vault 用一种本地 Markdown 格式打通所有 harness（Claude、Codex、Kimi、OpenClaw、Hermes 等）： ```bash 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 交接 | ## 行动指南 1. **五分钟**：把暗门一的省钱三件套写进 settings.json，明天看账单。 2. **三分钟**：跑一次 `npx -y ecc-agentshield scan`，给你现有配置做个体检。 3. **十五分钟**：决定要不要整套上船——`npx ecc-universal setup` 全家桶，或 `./install.sh --target claude --skills tdd-workflow,security-review` 只装两个技能；拿不准就先问它：`node scripts/ecc.js consult "安全审查"`，它会推荐该装的组件。 4. **重度用户**：多 harness 党上 Memory Vault，把上下文从工具里解放出来；记得 Cursor 设独立 `ECC_AGENT_DATA_HOME`。 ECC 证明了一件事：2026 年 AI 编程的差距不在模型，在 harness——同一批模型，有人当聊天框用，有人把它调教成一条带质检、带记忆、会自我进化的生产线。 ## 参考来源 1. ECC 仓库（MIT，README 含全部配置项与数据）：[github.com/affaan-m/ECC](https://github.com/affaan-m/ECC) 2. ecc-universal npm 包（安装与 doctor/repair 工具）：[npmjs.com/package/ecc-universal](https://www.npmjs.com/package/ecc-universal) 3. ecc-agentshield npm 包：[npmjs.com/package/ecc-agentshield](https://www.npmjs.com/package/ecc-agentshield) 4. AgentShield 独立仓库与 GitHub Action：[github.com/affaan-m/agentshield](https://github.com/affaan-m/agentshield) 5. ECC 官网与 Pro 版说明：[ecc.tools](https://ecc.tools) --- > 本文由「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 等场景全覆盖。