ECC

The harness-native operator system for agentic work.（为智能体工作而生的原生 harness 操作系统。）出自 Anthropic 黑客马拉松优胜作品。远不止是一堆配置。它是一个完整的系统：技能（skills）、本能（instincts）、记忆优化、持续学习、安全扫描，以及以研究为先导的研发流程。

可用于生产环境的智能体（agents）、技能、钩子（hooks）、规则、MCP 配置，以及兼容旧有命令的 shim——这些都是在 10 多个月的密集日常实战中，通过构建真实产品逐渐演进出来的。

支持 Claude Code、Codex、Cursor、OpenCode、Gemini、Zed、GitHub Copilot 以及其他 AI agent harness。

ECC v2.0.0-rc.1 在这个可复用的底层之上，正式公开了 Hermes 运维方案：可以先从 Hermes 配置指南上手，然后阅读 rc.1 发布说明和跨 harness 架构文档。

开源版永久免费，基于 MIT 协议。ECC Pro 是面向私有代码仓库的 GitHub App 付费版本。Sponsors 和 Pro 订阅者为项目提供了资金——正因为如此，一个维护者才能每周在 7 种 harness 上持续更新。

概念指南

本项目仓库只包含原始代码。具体的功能说明和设计理念，可以参考以下指南：

主题	内容简介
令牌优化	模型选择、系统提示词精简、后台进程优化
记忆持久化	利用钩子在会话之间自动保存/恢复上下文
持续学习	自动从会话中抽取模式，沉淀为可复用的技能
验证循环	检查点 vs 持续评估、评分器类型、pass@k 指标
并行化	Git 工作区（worktree）、级联方法、实例扩容时机
子智能体编排	上下文问题、迭代检索模式

更新日志

v2.0.0-rc.1 — 界面焕新、运维工作流和 ECC 2.0 Alpha（2026 年 4 月）

仪表盘 GUI：新增基于 Tkinter 的桌面应用（ecc_dashboard.py 或 npm run dashboard），支持深色/浅色主题切换、字体自定义，并在窗口标题栏和头部加入了项目 Logo。
公开界面与代码仓库同步：元数据、目录统计、插件清单、面向安装的文档等，现在与实际的 OSS 代码完全一致：61 个智能体、246 个技能和 76 个旧版命令 shim。
运维与出站工作流扩展：补充了 brand-voice、social-graph-ranker、connections-optimizer、customer-billing-ops、ecc-tools-cost-audit、google-workspace-ops、project-flow-ops 和 workspace-surface-audit 等运维能力。
媒体与发布工具：manim-video、remotion-video-creation 以及升级后的社交发布能力，让技术科普视频和宣发内容也能在同一套体系中完成。
框架与产品能力增长：nestjs-patterns、更完善的 Codex/OpenCode 安装体验、跨 harness 打包能力增强，使代码仓库在 Claude Code 之外也更易于使用。
Itô 预测市场技能包：ito-market 预测市场技能包。

核心能力

1. 技能（Skills）——让 AI 真的能“动手做事”

技能是 ECC 的“手脚”，把提示词变成可执行、可组合的真实能力。与单纯给大模型“打补丁”不同，技能是可组合、可降级、可审计的完整单元。

每个技能都满足以下特征：

可组合：技能之间可以互相调用，形成能力链路。
降级友好：支持逐步回退或备选实现。
全生命周期管理：从定义、触发、执行到审计，统一规范。

示例：企业级邮件草拟 → 审批 → 发送技能链

skill: email-draft
→ 调用者：销售/客服/市场等业务智能体
→ 内部能力：邮件模版引擎、合规检查、品牌语调校验
→ 输出：待审批邮件草稿
↓
skill: email-approval (支持多人/多级审批)
→ 与外部系统交互：钉钉/飞书/企微/邮件 通知
→ 审计日志：谁、何时、批准/驳回、原因
↓
skill: email-send
→ SMTP / Exchange / 第三方邮件服务 API
→ 重试、限流、错误处理

在 ECC 生态中，技能不是“提示词里多写一句话”，而是工程化的能力抽象。它把企业级流程（审批、审计、合规、限流、重试、多种实现切换等）都沉淀为可复用的技能，然后让智能体像搭积木一样按需组装。

这正是 ECC 区别于普通“配置集合”的本质：技能是生产级别的代码 + 提示词的组合产物。

2. 本能（Instincts）——智能体的“肌肉记忆”

如果说技能是智能体“会做的事”，那本能就是“下意识就会做的事”——不用每次都重新组织，而是内化在智能体中的默认行为模式。

不依赖显式指令：不需要每次都说“请遵守安全规范”，本能会自动触发。
跨会话一致：今天和明天的响应风格保持一致。
环境自适应：根据所用 harness、代码语言、项目类型，动态切换合适的“本能”。

典型本能：安全本能（Security Instinct）

在代码上下文中，自动检测敏感信息泄露、注入风险、硬编码密钥等安全隐患，并在适当时候主动提醒或阻断。

用户: “帮我打印一下数据库配置”
AI (不带本能): 直接打印配置 → 可能存在密码泄露风险
AI (带安全本能): “数据库配置中包含连接密码，直接输出到日志可能有安全风险。
                  是否需要脱敏后再展示，或者只展示非敏感字段？”

3. 记忆系统（Memory）——让 AI 不再是“金鱼”

普通大模型在会话结束后就“失忆”了，每次都是新的开始。ECC 通过钩子（hooks）和向量存储，实现了跨会话的记忆持久化。

会话间上下文自动保存/加载：今天聊到哪里，明天可以无缝继续。
长期记忆 vs 短期记忆：区分“知识型记忆”与“会话型记忆”。
可检索、可回溯：支持按时间、主题、关键词检索历史记忆片段。

典型的记忆钩子（hooks）机制：

session_start 钩子：在新会话启动时，自动加载与该用户/项目相关的历史记忆。
session_end 钩子：会话结束时，自动提取本次对话的关键信息，写入长期记忆。

这就解决了“每次都要重新介绍项目背景”“上次讨论的架构决策不记得了”等 AI 协作中的真实痛点。

4. 安全扫描（Security）——AgentShield

智能体虽然有强大的能力，但如果缺乏约束，也可能带来安全风险（密钥泄露、越权操作、有害代码生成等）。ECC 内置了 AgentShield 安全体系。

敏感信息检测：识别并警告 API 密钥、密码、token、私钥等。
操作风险分级：读操作 vs 写操作 vs 高危操作，差异化处理。
审计日志：记录智能体的每一次关键操作，满足企业合规要求。
策略即代码：安全策略以代码形式定义，可复用、可测试。

5. 跨 Harness 统一——一次构建，到处运行

不同 AI 编程助手（Claude Code / Codex / Cursor / OpenCode / Gemini / Zed / GitHub Copilot …）的能力边界、API、提示词风格各不相同。如果为每个平台单独维护一套配置，会带来巨大的碎片化成本。

ECC 的设计目标就是：一次构建技能和规则，在所有主流 harness 上一致运行。

统一的技能定义语言
适配层自动转换为各平台所需的格式
社区共用的技能市场，避免“重复造轮子”

技术栈与数据

维度	数据
🌟 Stars	182K+
🍴 Forks	28K+
👥 贡献者	170+
🧩 语言生态	12+（包含 Shell, TypeScript, Python, Go, Java, Perl, Markdown 等）
🧠 智能体	61 个
🛠️ 技能	246 个
🔌 旧版 Shims	76 个
📦 npm 包	ecc-universal, ecc-agentshield 等
🔗 GitHub App	ECC Tools（150+ 安装）
📜 许可证	MIT（开源永久免费）

ECC Pro（面向私有仓库的企业版）

ECC 开源版永久免费。如果你的团队需要在私有代码仓库中使用 ECC，可以考虑 ECC Pro——以 GitHub App 形式提供的企业版本。

私有仓库安全接入
企业级审计和权限管理
专属技术支持
定价详情

开始使用

安装

ECC 提供多种安装方式，适配不同平台。

Claude Code（原生）

/plugin marketplace add affaan-m/ECC
/plugin install ecc

Codex / OpenCode / Gemini / Cursor / Zed / GitHub Copilot 等

推荐使用一键安装脚本：

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/affaan-m/ECC/main/install.sh | bash

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/affaan-m/ECC/main/install.ps1 | iex

安装完成后，重启终端或 IDE 即可。

基础使用

安装完成后，在支持的 AI 编程助手中，你就可以直接调用 ECC 的技能和能力了。

用户: "用 security instinct 检查一下当前文件有没有密钥泄露"
AI: [自动触发安全本能] 扫描中……未发现硬编码密钥，但检测到一个测试用的弱密码示例，建议移除。

更详细的使用指南，可以参考项目文档中的 Hermes 配置指南和各生态的具体适配说明。

参与贡献

欢迎任何形式的贡献——代码、文档、Issue 讨论、社区布道等。

Fork 本仓库
创建你的特性分支 (git checkout -b feature/amazing-feature)
提交你的更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
开启一个 Pull Request

对于较大规模的改动，建议先开 Issue 讨论方向。

许可证

致谢

所有 170+ 贡献者的辛勤付出
Anthropic Hackathon 的认可
整个开源社区的支持
超过 18 万位点亮 Stars 的朋友们

The harness-native operator system for agentic work.
为智能体工作而生的原生 harness 操作系统。

参考资料

ECC
参考资料

ECC