一文看懂 ECC 架构给 AI 编码助手装上工程操作系统的深度解析【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECCECCEverything Claude Code是一个面向 Claude Code、Codex、OpenCode、Cursor 等多款 AI 编码助手的智能体编排系统它用 68 个专职 Agent、285 个可复用技能与一套事件驱动的 Hook 运行时把规划—测试—实现—评审—验证—记忆—改进的工程闭环固化进每一次会话让 AI 写代码从碰运气变成走流程。这篇文章将拆开它的外壳看它如何用上下文经济学、安全自检与选择性安装把散落的智能体能力拧成一台可运营的机器。一、绕不开的三座大山为什么会写代码的 AI还不够用如果你每天都在和 Claude Code 这类智能体协作大概率已经撞上过这三堵墙上下文是稀缺品会话越长越容易记了开头忘了结尾模型把预算浪费在重复读取上窗口最后 20% 几乎不可用流程靠提醒不靠机制你在提示词里写请先写测试、再实现、最后评审模型上一秒答应、下一秒就直奔实现去了配置即攻击面CLAUDE.md、hooks、MCP 配置里藏着一个安全后门大多数用户完全无感知。ECC 的思路不是再写一堆更好的提示词而是把纪律下沉到引擎层。看这张新旧对比你就能理解它的设计取向痛点场景没有 ECC 时有 ECC 时规划计划消失在聊天记录里计划变成可编辑的产物经 CONFIRM 闸门后才动工测试驱动请用 TDD是一条可能被遗忘的指令TDD 是带证据的 RED→GREEN→REFACTOR 强制流程代码评审写代码和评代码用同一份上下文新鲜上下文的 reviewer 独立查盲区记忆记忆 保存一份巨大的 transcript会话被蒸馏成摘要、本能instincts与可复用技能安全智能体配置默认被信任AgentShield 把 harness 本身当作攻击面来扫描一句话概括别人的插件给 AI加技能ECC 给 AI上制度。它管理的是 Agent 干活的方式而不是具体某一门语言的知识。二、整体架构一台五层智能体引擎ECC 的仓库结构本身就是一张架构图从下往上五层各司其职目录结构详解┌──────────────────────────────────────────────────────────┐ │ 交互层 commands/ 94个斜杠命令 skills/ 285个按需加载技能 │ ├──────────────────────────────────────────────────────────┤ │ 分工层 agents/ 68个专职子代理planner/reviewer/resolver│ ├──────────────────────────────────────────────────────────┤ │ 约束层 rules/ 常驻规则common 12门语言包按需选装 │ ├──────────────────────────────────────────────────────────┤ │ 运行时 hooks/ 事件钩子PreToolUse/PostToolUse/Stop… │ ├──────────────────────────────────────────────────────────┤ │ 底座 scripts/ 安装/修复/同步/编排 记忆与状态存储 │ └──────────────────────────────────────────────────────────┘这五层的关键在于各自独立、职责清晰技能按需加载不占常驻上下文规则是always-loaded所以必须选装Agent 用独立上下文做隔离Hook 则完全跑在模型上下文之外——它在scripts/hooks/里执行 Node.js 脚本模型甚至不需要知道它被检查过。承上启下的问题来了这套体系里最硬核的机制是什么我认为是 Hook 运行时和上下文经济学。下面逐个拆解。三、核心机制解剖上Hook 运行时——把纪律装进引擎而不是提示词传统做法把别提交密钥写进系统提示词模型可能忘ECC 的做法是把检查做成hook——即由编码助手在特定事件工具调用前、写文件前、会话开始时自动触发的脚本。以hooks/hooks.json为例完整配置里面挂着十几个守门员{ hooks: { PreToolUse: [ { matcher: Edit|Write|MultiEdit, hooks: [{ command: node ... run-with-flags.js pre:config-protection scripts/hooks/config-protection.js standard,strict, description: Block modifications to linter/formatter config files, id: pre:config-protection }] } ], PreCompact: [ { matcher: *, hooks: [{ command: node ... pre-compact.js standard,strict, description: Save state before context compaction, id: pre:compact }] } ] } }这段配置在做什么注意两个细节事件即检查点PreToolUse挂在 Edit/Write 之前意味着想改配置文件先过我这关——config-protection会拦下对 linter 配置的修改逼智能体去修代码而不是悄悄放宽规则。检查发生在模型动手之前错误根本不会进入代码库。分级钳制命令末尾的standard,strict是运行档位配合环境变量ECC_HOOK_PROFILEminimal|standard|strict与ECC_DISABLED_HOOKS可以运行时调整严格度不用编辑任何 hook 文件就能临时放行。低上下文安装--profile minimal甚至可以直接不带 hook 运行时。更有意思的是插件场景下的启动引导当 ECC 以 Claude 插件形式安装时hook 命令会先去resolve-ecc-root的候选目录链里定位仓库根再加载plugin-hook-bootstrap.js。这意味着同一套 hook 脚本既支持手动安装、也支持插件安装路径解析全部自动化——这套root 解析 引导器是它能同时适配 Claude、Codex、OpenCode、Cursor 的底层原因平台支持矩阵。四、核心机制解剖下上下文经济学——记忆、本能与蒸馏ECC 的座右铭写在 README 里Optimize the context window. Persist everything else.优化上下文窗口其余全部持久化。这是它的第二根技术支柱具体由三件套实现第一件会话摘要。每次 Stop 事件scripts/hooks/session-end.js会读 transcript会话转录文件把用户最近 10 条消息、用过的工具、改过的文件压缩成结构化摘要源码// 从 JSONL transcript 里抽用户消息截断到 200 字符 if (entry.type user || entry.role user) { const text typeof rawContent string ? rawContent : Array.isArray(rawContent) ? rawContent.map(c (c c.text) || ).join( ) : ; const cleaned stripAnsi(text).trim(); if (cleaned) userMessages.push(cleaned.slice(0, 200)); } // 记录 Edit/Write 改过的文件供下次会话恢复上下文 if (filePath (toolName Edit || toolName Write)) { filesModified.add(filePath); }这段代码解释了蒸馏的实现方式不是把整个聊天记录塞回去而是只保留**任务意图用户消息、动作轨迹工具、影响面文件**三个维度。下次SessionStart时session-start-bootstrap.js把这些摘要注入上下文上限由ECC_SESSION_START_MAX_CHARS默认 8000 字符控制——这就是记忆与上下文预算之间的动态平衡。第二件本能instincts。光有摘要还是记录ECC 更进一步做学习。连续学习 v2 系统把会话中反复出现的模式提取为带置信度的 instinctSessionStart时按置信度 项目相关度排序注入默认只注入置信度 ≥0.7 的 Top 6ECC_MAX_INJECTED_INSTINCTS、ECC_INSTINCT_CONFIDENCE_THRESHOLD可调。相关度排序会对命中当前技术栈语言、框架、terraform/dbt 标记的本能加权让在这个项目里真正有用的经验浮上来而不是被不相关的强置信度条目淹没。第三件Memory Vault统一记忆库。跨 harness 的记忆问题用一份可检查的 Markdown 格式解决项目记忆在.ecc/memory/用户记忆在~/.ecc/memory/。ecc memory handoff --from hermes --target codex可以把上下文从 Hermes 交接给 Codexecc memory doctor负责校验。记忆被设计为未评审上下文——重要结论必须经人工评审晋升到受治理的文档里这堵住了AI 凭记忆执行错误指令的口子。五、安全自检AgentShield 把 harness 本身当攻击面如果说前两节讲的是让 AI 更聪明那 AgentShield 讲的是让 AI 别被坑。它诞生于 Claude Code 黑客松如今内置 102 条静态分析规则、1282 项测试专门扫描智能体的配置文件CLAUDE.md、settings.json、MCP 配置、hooks、Agent 定义、技能文件覆盖密钥检测14 种模式、权限审计、hook 注入分析、MCP 服务器风险画像五个维度。一行命令即可接入安全指南# 快速扫描无需安装 npx ecc-agentshield scan # 自动修复可安全处理的问题 npx ecc-agentshield scan --fix # 三个 Opus 智能体做红队/蓝队/审计对抗 npx ecc-agentshield scan --opus --stream--opus模式很有意思攻击者智能体找漏洞利用链防御者评估防护审计者综合双方结论输出风险排序——这是对抗推理而不是简单的正则匹配。发现关键问题时退出码为 2可以直接接进 CI 当构建闸门。六、实践工作流三分钟从零接入一个有纪律的 AI 编码环境接入 ECC 的路径很多但核心原则是每个 harness 只选一条安装路径不要叠加叠加会导致技能、hook 重复。推荐流程如下克隆仓库仓库地址https://gitcode.com/GitHub_Trending/ev/ECCClaude Code 用户用官方插件方式在 Claude Code 里执行/plugin marketplace add后/plugin install eccecc这是当前最推荐的入口Codex 用户用原生 marketplace 插件codex plugin marketplace addcodex plugin add eccecc其他工具Cursor/Gemini/Zed/Qwen 等用./install.sh --profile minimal --target 工具名生成项目级适配器按需选装而不是全量安装先装rules/common加一门自己用的语言包用node scripts/ecc.js consult security reviews让内置顾问推荐组件动手干活从/ecc:plan Add authentication开始让 planner 产出蓝图再走tdd-workflow技能最后/code-review用新鲜上下文复盘。日常高频命令已整理在 COMMANDS-QUICK-REF.md。如果装坏了也不用慌node scripts/ecc.js doctor和repair能基于安装状态清单install-state自动修复uninstall --dry-run先预览再卸载不会误删用户自己的文件。七、与同类方案的横向对比它凭什么称操作系统拿 ECC 与纯技能包和单工具适配器两类方案对比维度ECC单 harness 技能包传统配置模板覆盖范围7 种编码助手统一管理只服务一个工具只服务一个工具流程纪律Hook 运行时在模型外强制执行依赖模型自觉无上下文策略会话摘要 本能注入 预算控制无系统性方案无安全自检AgentShield 扫描配置攻击面无无记忆持久化跨 harness 的 Memory Vault单工具内无安装模型插件/选择性安装双轨可回滚全量复制手工粘贴学习能力本能置信度评分 技能蒸馏无无ECC 的差异化不在技能多技能谁都能攒而在把工程方法论TDD、评审、安全、记忆做成了可执行、可审计、可回滚的运行时。这是它从插件升维到平台的关键。八、生态与演进从插件到控制平面的路上ECC 的演进脉络非常清晰v1.x 是技能与规则集合v2.0 升格为智能体 harness 操作系统——会话适配器、MCP 清单、worktree 生命周期服务、orch-*编排器家族相继落地v2.1 加入了 Plan Canvas在浏览器画布上点选、标注、审批计划与 Kimi Code 支持。最值得关注的是ecc2/目录下的Rust 控制平面原型一个本地可构建的守护进程暴露dashboard / sessions / status / daemon等命令用 Rust 重写运行时底座指向了更轻、更快、更稳的未来。与此同时Unified Memory Vault 与可选的ecc-memory-mcp服务器仅暴露 save/search/read/doctor 四个接口、默认不自启正在把跨 harness 共享上下文从理念变成默认能力。未来方向在 ARCHITECTURE-IMPROVEMENTS.md 里也有迹可循更细粒度的能力选择、自我改进的技能self-improving skills、以及把 PR 分析、成本审计接进统一运营面。九、收尾AI 写代码的终局是把方法沉淀成机制回到开头的问题为什么会写代码的 AI还不够用因为能力capability不等于工程engineering。ECC 的价值主张可以用一句话收束——它把人类团队里流程、纪律、记忆、安全检查这些无形的工程资产全部固化成代码里可执行的机制让你每次开会话得到的不是一次运气而是一条可复现、可追溯、可改进的生产线。记住它的核心公式plan → test → implement → review → verify → remember → improve。下次当你发现某个 AI 编码工具好用但不可靠时不妨想想 ECC 的答案不是换一个更聪明的模型而是给现有的智能体装上一套会自我约束、自我记忆、自我进化的操作系统。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
一文看懂 ECC 架构给 AI 编码助手装上工程操作系统的深度解析【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECCECCEverything Claude Code是一个面向 Claude Code、Codex、OpenCode、Cursor 等多款 AI 编码助手的智能体编排系统它用 68 个专职 Agent、285 个可复用技能与一套事件驱动的 Hook 运行时把规划—测试—实现—评审—验证—记忆—改进的工程闭环固化进每一次会话让 AI 写代码从碰运气变成走流程。这篇文章将拆开它的外壳看它如何用上下文经济学、安全自检与选择性安装把散落的智能体能力拧成一台可运营的机器。一、绕不开的三座大山为什么会写代码的 AI还不够用如果你每天都在和 Claude Code 这类智能体协作大概率已经撞上过这三堵墙上下文是稀缺品会话越长越容易记了开头忘了结尾模型把预算浪费在重复读取上窗口最后 20% 几乎不可用流程靠提醒不靠机制你在提示词里写请先写测试、再实现、最后评审模型上一秒答应、下一秒就直奔实现去了配置即攻击面CLAUDE.md、hooks、MCP 配置里藏着一个安全后门大多数用户完全无感知。ECC 的思路不是再写一堆更好的提示词而是把纪律下沉到引擎层。看这张新旧对比你就能理解它的设计取向痛点场景没有 ECC 时有 ECC 时规划计划消失在聊天记录里计划变成可编辑的产物经 CONFIRM 闸门后才动工测试驱动请用 TDD是一条可能被遗忘的指令TDD 是带证据的 RED→GREEN→REFACTOR 强制流程代码评审写代码和评代码用同一份上下文新鲜上下文的 reviewer 独立查盲区记忆记忆 保存一份巨大的 transcript会话被蒸馏成摘要、本能instincts与可复用技能安全智能体配置默认被信任AgentShield 把 harness 本身当作攻击面来扫描一句话概括别人的插件给 AI加技能ECC 给 AI上制度。它管理的是 Agent 干活的方式而不是具体某一门语言的知识。二、整体架构一台五层智能体引擎ECC 的仓库结构本身就是一张架构图从下往上五层各司其职目录结构详解┌──────────────────────────────────────────────────────────┐ │ 交互层 commands/ 94个斜杠命令 skills/ 285个按需加载技能 │ ├──────────────────────────────────────────────────────────┤ │ 分工层 agents/ 68个专职子代理planner/reviewer/resolver│ ├──────────────────────────────────────────────────────────┤ │ 约束层 rules/ 常驻规则common 12门语言包按需选装 │ ├──────────────────────────────────────────────────────────┤ │ 运行时 hooks/ 事件钩子PreToolUse/PostToolUse/Stop… │ ├──────────────────────────────────────────────────────────┤ │ 底座 scripts/ 安装/修复/同步/编排 记忆与状态存储 │ └──────────────────────────────────────────────────────────┘这五层的关键在于各自独立、职责清晰技能按需加载不占常驻上下文规则是always-loaded所以必须选装Agent 用独立上下文做隔离Hook 则完全跑在模型上下文之外——它在scripts/hooks/里执行 Node.js 脚本模型甚至不需要知道它被检查过。承上启下的问题来了这套体系里最硬核的机制是什么我认为是 Hook 运行时和上下文经济学。下面逐个拆解。三、核心机制解剖上Hook 运行时——把纪律装进引擎而不是提示词传统做法把别提交密钥写进系统提示词模型可能忘ECC 的做法是把检查做成hook——即由编码助手在特定事件工具调用前、写文件前、会话开始时自动触发的脚本。以hooks/hooks.json为例完整配置里面挂着十几个守门员{ hooks: { PreToolUse: [ { matcher: Edit|Write|MultiEdit, hooks: [{ command: node ... run-with-flags.js pre:config-protection scripts/hooks/config-protection.js standard,strict, description: Block modifications to linter/formatter config files, id: pre:config-protection }] } ], PreCompact: [ { matcher: *, hooks: [{ command: node ... pre-compact.js standard,strict, description: Save state before context compaction, id: pre:compact }] } ] } }这段配置在做什么注意两个细节事件即检查点PreToolUse挂在 Edit/Write 之前意味着想改配置文件先过我这关——config-protection会拦下对 linter 配置的修改逼智能体去修代码而不是悄悄放宽规则。检查发生在模型动手之前错误根本不会进入代码库。分级钳制命令末尾的standard,strict是运行档位配合环境变量ECC_HOOK_PROFILEminimal|standard|strict与ECC_DISABLED_HOOKS可以运行时调整严格度不用编辑任何 hook 文件就能临时放行。低上下文安装--profile minimal甚至可以直接不带 hook 运行时。更有意思的是插件场景下的启动引导当 ECC 以 Claude 插件形式安装时hook 命令会先去resolve-ecc-root的候选目录链里定位仓库根再加载plugin-hook-bootstrap.js。这意味着同一套 hook 脚本既支持手动安装、也支持插件安装路径解析全部自动化——这套root 解析 引导器是它能同时适配 Claude、Codex、OpenCode、Cursor 的底层原因平台支持矩阵。四、核心机制解剖下上下文经济学——记忆、本能与蒸馏ECC 的座右铭写在 README 里Optimize the context window. Persist everything else.优化上下文窗口其余全部持久化。这是它的第二根技术支柱具体由三件套实现第一件会话摘要。每次 Stop 事件scripts/hooks/session-end.js会读 transcript会话转录文件把用户最近 10 条消息、用过的工具、改过的文件压缩成结构化摘要源码// 从 JSONL transcript 里抽用户消息截断到 200 字符 if (entry.type user || entry.role user) { const text typeof rawContent string ? rawContent : Array.isArray(rawContent) ? rawContent.map(c (c c.text) || ).join( ) : ; const cleaned stripAnsi(text).trim(); if (cleaned) userMessages.push(cleaned.slice(0, 200)); } // 记录 Edit/Write 改过的文件供下次会话恢复上下文 if (filePath (toolName Edit || toolName Write)) { filesModified.add(filePath); }这段代码解释了蒸馏的实现方式不是把整个聊天记录塞回去而是只保留**任务意图用户消息、动作轨迹工具、影响面文件**三个维度。下次SessionStart时session-start-bootstrap.js把这些摘要注入上下文上限由ECC_SESSION_START_MAX_CHARS默认 8000 字符控制——这就是记忆与上下文预算之间的动态平衡。第二件本能instincts。光有摘要还是记录ECC 更进一步做学习。连续学习 v2 系统把会话中反复出现的模式提取为带置信度的 instinctSessionStart时按置信度 项目相关度排序注入默认只注入置信度 ≥0.7 的 Top 6ECC_MAX_INJECTED_INSTINCTS、ECC_INSTINCT_CONFIDENCE_THRESHOLD可调。相关度排序会对命中当前技术栈语言、框架、terraform/dbt 标记的本能加权让在这个项目里真正有用的经验浮上来而不是被不相关的强置信度条目淹没。第三件Memory Vault统一记忆库。跨 harness 的记忆问题用一份可检查的 Markdown 格式解决项目记忆在.ecc/memory/用户记忆在~/.ecc/memory/。ecc memory handoff --from hermes --target codex可以把上下文从 Hermes 交接给 Codexecc memory doctor负责校验。记忆被设计为未评审上下文——重要结论必须经人工评审晋升到受治理的文档里这堵住了AI 凭记忆执行错误指令的口子。五、安全自检AgentShield 把 harness 本身当攻击面如果说前两节讲的是让 AI 更聪明那 AgentShield 讲的是让 AI 别被坑。它诞生于 Claude Code 黑客松如今内置 102 条静态分析规则、1282 项测试专门扫描智能体的配置文件CLAUDE.md、settings.json、MCP 配置、hooks、Agent 定义、技能文件覆盖密钥检测14 种模式、权限审计、hook 注入分析、MCP 服务器风险画像五个维度。一行命令即可接入安全指南# 快速扫描无需安装 npx ecc-agentshield scan # 自动修复可安全处理的问题 npx ecc-agentshield scan --fix # 三个 Opus 智能体做红队/蓝队/审计对抗 npx ecc-agentshield scan --opus --stream--opus模式很有意思攻击者智能体找漏洞利用链防御者评估防护审计者综合双方结论输出风险排序——这是对抗推理而不是简单的正则匹配。发现关键问题时退出码为 2可以直接接进 CI 当构建闸门。六、实践工作流三分钟从零接入一个有纪律的 AI 编码环境接入 ECC 的路径很多但核心原则是每个 harness 只选一条安装路径不要叠加叠加会导致技能、hook 重复。推荐流程如下克隆仓库仓库地址https://gitcode.com/GitHub_Trending/ev/ECCClaude Code 用户用官方插件方式在 Claude Code 里执行/plugin marketplace add后/plugin install eccecc这是当前最推荐的入口Codex 用户用原生 marketplace 插件codex plugin marketplace addcodex plugin add eccecc其他工具Cursor/Gemini/Zed/Qwen 等用./install.sh --profile minimal --target 工具名生成项目级适配器按需选装而不是全量安装先装rules/common加一门自己用的语言包用node scripts/ecc.js consult security reviews让内置顾问推荐组件动手干活从/ecc:plan Add authentication开始让 planner 产出蓝图再走tdd-workflow技能最后/code-review用新鲜上下文复盘。日常高频命令已整理在 COMMANDS-QUICK-REF.md。如果装坏了也不用慌node scripts/ecc.js doctor和repair能基于安装状态清单install-state自动修复uninstall --dry-run先预览再卸载不会误删用户自己的文件。七、与同类方案的横向对比它凭什么称操作系统拿 ECC 与纯技能包和单工具适配器两类方案对比维度ECC单 harness 技能包传统配置模板覆盖范围7 种编码助手统一管理只服务一个工具只服务一个工具流程纪律Hook 运行时在模型外强制执行依赖模型自觉无上下文策略会话摘要 本能注入 预算控制无系统性方案无安全自检AgentShield 扫描配置攻击面无无记忆持久化跨 harness 的 Memory Vault单工具内无安装模型插件/选择性安装双轨可回滚全量复制手工粘贴学习能力本能置信度评分 技能蒸馏无无ECC 的差异化不在技能多技能谁都能攒而在把工程方法论TDD、评审、安全、记忆做成了可执行、可审计、可回滚的运行时。这是它从插件升维到平台的关键。八、生态与演进从插件到控制平面的路上ECC 的演进脉络非常清晰v1.x 是技能与规则集合v2.0 升格为智能体 harness 操作系统——会话适配器、MCP 清单、worktree 生命周期服务、orch-*编排器家族相继落地v2.1 加入了 Plan Canvas在浏览器画布上点选、标注、审批计划与 Kimi Code 支持。最值得关注的是ecc2/目录下的Rust 控制平面原型一个本地可构建的守护进程暴露dashboard / sessions / status / daemon等命令用 Rust 重写运行时底座指向了更轻、更快、更稳的未来。与此同时Unified Memory Vault 与可选的ecc-memory-mcp服务器仅暴露 save/search/read/doctor 四个接口、默认不自启正在把跨 harness 共享上下文从理念变成默认能力。未来方向在 ARCHITECTURE-IMPROVEMENTS.md 里也有迹可循更细粒度的能力选择、自我改进的技能self-improving skills、以及把 PR 分析、成本审计接进统一运营面。九、收尾AI 写代码的终局是把方法沉淀成机制回到开头的问题为什么会写代码的 AI还不够用因为能力capability不等于工程engineering。ECC 的价值主张可以用一句话收束——它把人类团队里流程、纪律、记忆、安全检查这些无形的工程资产全部固化成代码里可执行的机制让你每次开会话得到的不是一次运气而是一条可复现、可追溯、可改进的生产线。记住它的核心公式plan → test → implement → review → verify → remember → improve。下次当你发现某个 AI 编码工具好用但不可靠时不妨想想 ECC 的答案不是换一个更聪明的模型而是给现有的智能体装上一套会自我约束、自我记忆、自我进化的操作系统。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
