ECC

针对 Claude Code、Codex、Cursor 等 AI 编码助手的 agent harness 性能优化系统，提供 278+ 技能、记忆持久化、安全扫描（AgentShield）和跨平台支持。亮点在于统一了多个 AI 编码工具的工作流配置，减轻开发者重复设置负担，且社区活跃、持续迭代。

README

ECC — the agent harness operating system

Shell TypeScript Python Java Perl Markdown

[!WARNING] 仅限官方来源。 请仅从经过验证的渠道安装 ECC：GitHub 仓库 github.com/affaan-m/ECC、npm 包 ecc-universal 和 ecc-agentshield、GitHub App、插件标识符 ecc@ecc，以及项目网站 ecc.tools。第三方重新上传和非官方镜像未经项目维护或审查，可能包含恶意软件。

211.9K+ stars | 32.5K+ forks | 230+ contributors | 12+ language ecosystems | 跨 harness 代理工作流

语言 / Language / 语言 / Dil / Язык / Ngôn ngữ / Idioma

原生 harness 的操作系统，专为 agentic 工作打造。源自真实的跨 harness 工程工作流。

不仅仅是配置。一套完整的系统：skills、instincts、memory optimization、continuous learning、security scanning 以及 research-first development。经过 10 个月以上高强度日常使用（构建实际产品）进化而来的、生产就绪的 agents、skills、hooks、rules、MCP 配置和遗留 command shims。

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

ECC v2.0.0 在该可复用层之上新增了公开的 Hermes operator 故事：从 Hermes 设置指南开始，然后查阅 2.0.0 发布说明和跨 harness 架构。

ECC Pro
私有仓库 · GitHub App · $19/座/月

赞助
资助开源项目 · 从 $5/月起

社区
讨论 · 问答 · 展示与分享

GitHub App
安装 · PR 审计 · 免费层

开源始终保持免费。 本仓库永久使用 MIT 许可。ECC Pro 是面向私有仓库的托管式 GitHub App。赞助者和 Pro 订阅者为这项工作提供资金——这就是为什么单维护者能每周跨 7 个 harness 发布更新。

商业赞助商

CodeRabbit

Greptile

Atlas Cloud

社区赞助者： Mike Morgan · @jasonwu513 · @1anter · @massimotodaro · @meadmccabe

成为赞助者 · 赞助层级 · 赞助计划

指南

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

速览指南
设置、基础、理念。 请先阅读本文。（主题帖）

长篇指南
Token 优化、memory persistence（记忆持久性）、evals（评估）、parallelization（并行化）。（主题帖）

The Shorthand Guide to Everything Agentic Security

安全指南
攻击向量、沙箱、清理、CVE、AgentShield。（主题帖）

主题	你将学到什么
Token 优化	模型选择、system prompt 精简、后台进程
Memory Persistence（记忆持久性）	跨会话自动保存/加载上下文的 hooks
Continuous Learning（持续学习）	从会话中自动提取模式，形成可复用 skills
Verification Loops（验证循环）	检查点 vs 持续评估、评分器类型、pass@k 指标
Parallelization（并行化）	Git worktrees、级联方法、何时扩展实例
Subagent Orchestration（子代理编排）	上下文问题、迭代检索模式

快速入门

两分钟内上手：

只选择一种方式

大多数 Claude Code 用户应只使用一种安装方式：

推荐默认： 安装 Claude Code 插件，然后仅复制你实际需要的 rule 文件夹。
仅在你想要更精细的控制、希望完全避免插件路径，或者你的 Claude Code 构建在解析自托管 marketplace 条目时遇到问题的情况下，再使用手动安装器。
不要叠加安装方法。 最常见的故障设置是：先执行 /plugin install，然后再执行 install.sh --profile full 或 npx ecc-install --profile full。

如果你已经叠加了多种安装，并且发现内容重复，请直接跳到重置/卸载 ECC。

低上下文 / 无 hooks 路径

如果 hooks 感觉太全局，或者你只想要 ECC 的 rules、agents、commands 和核心工作流 skills，请跳过插件并使用最小手动配置：

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

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

此配置有意不包含 hooks-runtime。

如果你想要正常核心配置但需要关闭 hooks，请使用：

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

以后仅在需要运行时强制时添加 hooks：

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

先找到合适的组件

如果不确定要安装哪个 ECC 配置或组件，可以从任何项目中询问打包的顾问：

npx ecc consult "security reviews" --target claude

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

对于生产 ML/MLOps 工作流，请保持安装为 opt-in 且组件限定范围：

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

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

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

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

# 安装插件
/plugin install ecc@ecc

命名 + 迁移说明

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

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

这是有意为之。Anthropic marketplace/插件安装由规范的插件标识符键控，因此 ECC 使用 ecc@ecc 来保持工具名称和斜杠命令命名空间足够短，以满足严格的 Desktop/API 验证器。较早的帖子可能仍显示旧的 marketplace 标识符；将其仅视为遗留别名。另外，npm 包保留了 ecc-universal 名称，因此 npm 安装和 marketplace 安装有意使用不同的名称。

步骤 2：仅在需要时安装 Rules

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

如果你已经通过 /plugin install 安装了 ECC，请勿再运行 ./install.sh --profile full、.\install.ps1 --profile full 或 npx ecc-install --profile full。插件已经加载了 ECC 的 skills、commands 和 hooks。在插件安装后运行完整安装器会将相同的表面内容复制到用户目录，可能导致重复的 skills 和重复的运行时行为。

对于插件安装，请手动仅复制你需要的 rules/ 目录到 ~/.claude/rules/ecc/。从 rules/common 加上你实际使用的一种语言或框架包开始。除非你明确希望将所有上下文都提供给 Claude，否则不要复制所有 rules 目录。

仅当你进行完全手动的 ECC 安装（而不是使用插件路径）时才使用完整安装器。

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

# 首先克隆仓库
git clone https://github.com/affaan-m/ECC.git
cd ECC

# 安装依赖（选择你的包管理器）
npm install        # 或：pnpm install | yarn install | bun install

# 插件安装路径：仅将 ECC rules 复制到 ECC 拥有的命名空间
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/

# 完全手动 ECC 安装路径（使用此路径代替 /plugin install）
# ./install.sh --profile full

# Windows PowerShell

# 插件安装路径：仅将 ECC rules 复制到 ECC 拥有的命名空间
New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules/ecc" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.claude/rules/ecc/"
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"

# 完全手动 ECC 安装路径（使用此路径代替 /plugin install）
# .\install.ps1 --profile full
# npx ecc-install --profile full

有关手动安装说明，请参阅 rules/ 文件夹中的 README。在手动复制 rules 时，请复制整个语言目录（例如 rules/common 或 `rules

[原 README 过长已截断]

开源项目affaan-m2026-05-25原文

打开互动版

ECC

README

指南

最新动态

v2.0.0 — Agent Harness Operating System（2026 年 6 月）

v2.0.0-rc.1 — Surface Refresh, Operator Workflows, and ECC 2.0 Alpha（2026 年 4 月）

v1.9.0 — Selective Install & Language Expansion（2026 年 3 月）

v1.8.0 — Harness Performance System（2026 年 3 月）

v1.7.0 — Cross-Platform Expansion & Presentation Builder（2026 年 2 月）

v1.6.0 — Codex CLI, AgentShield & Marketplace（2026 年 2 月）

v1.4.1 — Bug Fix（2026 年 2 月）

v1.4.0 — Multi-Language Rules, Installation Wizard & PM2（2026 年 2 月）

v1.3.0 — OpenCode Plugin Support（2026 年 2 月）

v1.2.0 — Unified Commands & Skills（2026 年 2 月）

快速入门

只选择一种方式

低上下文 / 无 hooks 路径

先找到合适的组件

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

命名 + 迁移说明

步骤 2：仅在需要时安装 Rules

相关内容

warp

sim

superpowers

skills

skills