affaan-m/ECC 来源：https://github.com/affaan-m/ECC 语言： English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย

ECC

ECC——面向智能体工作的原生操作器系统

Star (https://github.com/affaan-m/ECC/stargazers) | Fork (https://github.com/affaan-m/ECC/network/members) | 贡献者 (https://github.com/affaan-m/ECC/graphs/contributors) npm ecc-universal (https://www.npmjs.com/package/ecc-universal) | npm ecc-agentshield (https://www.npmjs.com/package/ecc-agentshield) | GitHub App 安装 (https://github.com/marketplace/ecc-tools) 许可证

Shell | TypeScript | Python | Go | Java | Perl | Markdown

18.2万+ Star | 2.8万+ Fork | 170+ 贡献者 | 12+ 语言生态 | Anthropic 黑客马拉松优胜者

语言 / Language / 語言 / Dil / Язык / Ngôn ngữ 简体中文 | English | Português (Brasil) | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย

面向智能体工作的原生操作器系统。来自 Anthropic 黑客马拉松优胜者。

不仅仅是配置。这是一个完整的系统：技能、本能、记忆优化、持续学习、安全扫描以及以研究为先的开发。经过 10 个多月在构建真实产品中的高强度日常使用，演化出生产就绪的代理、技能、钩子、规则、MCP 配置和遗留命令适配器。适用于 Claude Code、Codex、Cursor、OpenCode、Gemini、Zed、GitHub Copilot 以及其他 AI 代理原生平台。ECC v2.0.0-rc.1 在此可复用层之上添加了公开的 Hermes 操作器故事：从 Hermes 设置指南开始，然后查看 rc.1 发布说明和跨原生平台架构。

ECC Pro · 私有仓库 · GitHub App · 每月每席位 $19
赞助开源 · 每月 $5 起
社区讨论 · 问答 · 展示与分享
GitHub App 安装 · PR 审计 · 免费层级

OSS 永久免费。 本仓库永久采用 MIT 许可。ECC Pro 是针对私有仓库托管的 GitHub App。赞助者和 Pro 订阅者为这项工作提供资金——这就是为什么一位维护者能每周在 7 个原生平台上发布更新。

指南

本仓库仅包含原始代码。指南解释了所有内容。

简略指南：设置、基础、理念。请先阅读。 详细指南：Token 优化、记忆持久化、评估、并行化。 安全指南：攻击向量、沙箱、清理、CVE、AgentShield。

新内容

v2.0.0-rc.1 — 界面刷新、操作器工作流与 ECC 2.0 Alpha（2026 年 4 月）

• 仪表盘 GUI — 基于 Tkinter 的新桌面应用（ecc_dashboard.py 或 npm run dashboard），支持暗/亮主题切换、字体自定义、顶部和任务栏的项目徽标。
• 公开界面与实时仓库同步 — 元数据、目录计数、插件清单和安装面向文档已与实际 OSS 表面一致：60 个代理、232 个技能、75 个遗留命令适配器。
• 操作器与出站工作流扩展 — 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 安装表面、扩展的跨原生平台打包，使本仓库不仅限于 Claude Code。
• ECC 2.0 alpha 已集成 — ecc2/ 中的 Rust 控制平面原型现已本地构建，并公开 dashboard、start、sessions、status、stop、resume、daemon 命令。作为 alpha 版本可用，尚未正式发布。
• 操作器状态快照 — ecc status --markdown --write status.md 将本地状态存储导出为便携式交接文档，涵盖就绪度、活跃会话、技能运行健康、安装健康、待处理管控事件以及来自 Linear/GitHub/交接的关联工作项。使用 ecc work-items upsert ... 手动输入，ecc work-items sync-github --repo owner/repo 同步 PR/议题队列状态，ecc status --exit-code 在就绪度需要关注时使自动化流程失败。
• 生态加固 — AgentShield、ECC Tools 成本控制、计费门户工作、网站刷新持续围绕核心插件发布，而非分散到独立孤岛。

v1.9.0 — 选择性安装与语言扩展（2026 年 3 月）

• 选择性安装架构 — 基于清单的安装流水线，使用 install-plan.js 和 install-apply.js 实现目标组件安装。状态存储跟踪已安装内容并支持增量更新。
• 6 个新代理 — typescript-reviewer、pytorch-build-resolver、java-build-resolver、java-reviewer、kotlin-reviewer、kotlin-build-resolver 将语言覆盖扩展到 10 种语言。
• 新技能 — pytorch-patterns 用于深度学习工作流、documentation-lookup 用于 API 参考研究、bun-runtime 和 nextjs-turbopack 用于现代 JS 工具链，外加 8 个运营领域技能和 mcp-server-patterns。
• 会话与状态基础设施 — 带有查询 CLI 的 SQLite 状态存储、用于结构化记录的会话适配器、面向自我改进技能的技能演化基础。
• 编排重构 — 原生平台审计评分变为确定性，编排状态和启动器兼容性进一步硬化，观察者循环防护增加到 5 层。
• 观察者可靠性 — 内存爆炸修复（限流和尾部采样）、沙箱访问修复、惰性启动逻辑、重入防护。
• 12 个语言生态 — 新增 Java、PHP、Perl、Kotlin/Android/KMP、C++、Rust 规则，与现有 TypeScript、Python、Go 及通用规则一起。
• 社区贡献 — 韩语和中文翻译、biome 钩子优化、视频处理技能、运营技能、PowerShell 安装程序、Antigravity IDE 支持。
• CI 加固 — 修复 19 个测试失败、目录计数强制执行、安装清单验证、完整测试套件通过。

v1.8.0 — 原生平台性能系统（2026 年 3 月）

• 原生平台优先发布 — ECC 现在明确作为代理原生平台性能系统，而非仅仅配置包。
• 钩子可靠性重写 — SessionStart 根回退、Stop 阶段会话摘要、基于脚本的钩子替换脆弱的单行内联。
• 钩子运行时控制 — ECC_HOOK_PROFILE=minimal|standard|strict 和 ECC_DISABLED_HOOKS=... 实现无需编辑钩子文件的运行时门控。
• 新原生平台命令 — /harness-audit、/loop-start、/loop-status、/quality-gate、/model-route。
• NanoClaw v2 — 模型路由、技能热加载、会话分支/搜索/导出/压缩/指标。
• 跨原生平台一致性 — 在 Claude Code、Cursor、OpenCode、Codex 应用/CLI 之间行为更紧密。
• 997 个内部测试通过 — 钩子/运行时重构和兼容性更新后，完整套件通过。

v1.7.0 — 跨平台扩展与演示构建器（2026 年 2 月）

• Codex 应用 + CLI 支持 — 基于 AGENTS.md 的 Codex 直接支持、安装程序目标指定、Codex 文档。
• frontend-slides 技能 — 零依赖 HTML 演示构建器，附带 PPTX 转换指南和严格的 viewport-fit 规则。
• 5 个通用业务/内容技能 — article-writing、content-engine、market-research、investor-materials、investor-outreach。
• 更广泛的工具覆盖 — Cursor、Codex、OpenCode 支持进一步收紧，使同一仓库在所有主要原生平台上干净发布。
• 992 个内部测试 — 跨插件、钩子、技能和打包的扩展验证与回归覆盖。

v1.6.0 — Codex CLI、AgentShield 与市场（2026 年 2 月）

• Codex CLI 支持 — 新 /codex-setup 命令生成 codex.md 以实现 OpenAI Codex CLI 兼容性。
• 7 个新技能 — search-first、swift-actor-persistence、swift-protocol-di-testing、regex-vs-llm-structured-text、content-hash-cache-pattern、cost-aware-llm-pipeline、skill-stocktake。
• AgentShield 集成 — /security-scan 技能直接从 Claude Code 运行 AgentShield；1282 个测试，102 条规则。
• GitHub Marketplace — ECC Tools GitHub App 已在 github.com/marketplace/ecc-tools 上线，提供免费/专业/企业层级。
• 合并 30+ 个社区 PR — 来自 30 位贡献者，涵盖 6 种语言。
• 978 个内部测试 — 跨代理、技能、命令、钩子和规则的扩展验证套件。

v1.4.1 — 错误修复（2026 年 2 月）

• 修复本能导入内容丢失 — parse_instinct_file() 在 /instinct-import 期间静默丢弃了前导 YAML 之后的所有内容（Action、Evidence、Examples 部分）。(#148, #161)

v1.4.0 — 多语言规则、安装向导与 PM2（2026 年 2 月）

• 交互式安装向导 — 新 configure-ecc 技能提供带合并/覆盖检测的引导式设置。
• PM2 与多代理编排 — 6 个新命令（/pm2、/multi-plan、/multi-execute、/multi-backend、/multi-frontend、/multi-workflow）用于管理复杂多服务工作流。
• 多语言规则架构 — 规则从平面文件重构为 common/ + typescript/ + python/ + golang/ 目录。仅安装你需要的语言。
• 简体中文翻译 — 所有代理、命令、技能和规则的完整翻译（80+ 文件）。
• GitHub Sponsors 支持 — 通过 GitHub Sponsors 赞助项目。
• 增强的 CONTRIBUTING.md — 为每种贡献类型提供详细的 PR 模板。

v1.3.0 — OpenCode 插件支持（2026 年 2 月）

• 完整 OpenCode 集成 — 12 个代理、24 个命令、16 个技能，通过 OpenCode 的插件系统（20+ 事件类型）提供钩子支持。
• 3 个原生自定义工具 — run-tests、check-coverage、security-audit。
• LLM 文档 — llms.txt 提供全面的 OpenCode 文档。

v1.2.0 — 统一命令与技能（2026 年 2 月）

• Python/Django 支持 — Django 模式、安全、TDD 和验证技能。
• Java Spring Boot 技能 — Spring Boot 的模式、安全、TDD 和验证。
• 会话管理 — /sessions 命令用于会话历史。
• 持续学习 v2 — 基于本能的带置信度评分、导入/导出、演化的学习。

查看 Releases 中的完整变更日志。（https://github.com/affaan-m/ECC/releases）

快速开始

在 2 分钟内启动运行：

仅选择一个路径

大多数 Claude Code 用户应只使用一个安装路径：

• 推荐默认： 安装 Claude Code 插件，然后仅复制你真正需要的规则文件夹。
• 仅在你想要更细粒度控制、希望完全绕过插件路径、或者你的 Claude Code 构建在解析自托管市场条目时遇到问题时，才使用手动安装程序。
• 不要叠加安装方法。 最常见的损坏设置是：先 /plugin install，然后 install.sh --profile full 或 npx ecc-install --profile full。如果你已经叠加了多个安装，且看到重复内容，请直接跳到重置 / 卸载 ECC。

低上下文/无钩子路径

如果钩子感觉太全局化，或者你只想要 ECC 的规则、代理、命令和核心工作流技能，请跳过插件并使用最小手动配置文件：

./install.sh --profile minimal --target claude

.\install.ps1 --profile minimal --target claude
# 或 npx ecc-install --profile minimal --target claude

此配置文件有意排除 hooks-runtime。如果你想要正常核心配置文件但需要关闭钩子，请使用：

./install.sh --profile core --without baseline:hooks --target claude

稍后仅在需要运行时强制执行时添加钩子：

./install.sh --target claude --modules hooks-runtime

先找到正确组件

如果你不确定安装哪个 ECC 配置文件或组件，可以在任何项目中通过打包的顾问进行询问：

npx ecc consult "security reviews" --target claude

它会返回匹配的组件、相关配置文件以及预览/安装命令。如果想在安装前检查确切文件计划，请使用预览命令。

对于生产环境的 ML/MLOps 工作流，保持安装为可选和组件作用域：

npx ecc consult "mlops training model deployment" --target claude
npx ecc install --profile minimal --target claude --with capability:machine-learning

步骤 1：安装插件（推荐）

注：插件很方便，但如果在你的 Claude Code 构建中解析自托管市场条目遇到问题，下面的 OSS 安装程序仍然是最可靠的路径。

# 添加市场
/plugin marketplace add https://github.com/affaan-m/ECC

# 安装插件
/plugin install ecc@ecc

命名 + 迁移说明

ECC 现有三个公开标识符，不可互换：

• GitHub 源码仓库：affaan-m/ECC
• Claude 市场/插件标识符：ecc@ecc
• npm 包：ecc-universal

这是有意为之。Anthropic 市场/插件安装通过规范插件标识符键控，因此 ECC 使用 ecc@ecc 来保持工具名称和斜杠命令命名空间足够短，以满足严格的桌面/API 验证器要求。旧帖子可能仍显示以前的长市场标识符；请将其仅视为旧别名。

另外，npm 包保留了 ecc-universal，因此 npm 安装和市场安装有意使用不同名称。

步骤 2：仅在需要时安装规则

警告：重要： Claude Code 插件无法自动分发 rules。

如果你已通过 /plugin install 安装了 ECC，之后不要运行 ./install.sh --profile full、.\install.ps1 --profile full 或 npx ecc-install --profile full。插件已加载 ECC 技能、命令和钩子。插件安装后运行完整安装程序会将相同表面复制到用户目录，可能导致重复技能和重复运行时行为。

对于插件安装，仅手动复制你想要的 rules/ 目录到 ~/.claude/rules/ecc/。从 rules/common 加上一个你实际使用的语言或框架包开始。不要复制所有 rules 目录，除非你明确希望在 Claude 中拥有所有这些上下文。

仅在你完全手动安装 ECC（而非插件路径）时使用完整安装程序。

如果你的本地 Claude 设置被清除或重置，并不意味着你需要重新购买 ECC。首先运行 node scripts/ecc.js list-installed，然后运行 node scripts/ecc.js doctor 和 node scripts/ecc.js repair，然后再重新安装任何内容。这通常能恢复 ECC 管理的文件而无需重构设置。如果问题是 ECC Tools 的账户或市场访问权限，请