把 AI 编程规范装进工具里:ECC 安装与使用指南

你在新项目里打开 AI 编程助手，通常要重新交代一遍代码规范、测试要求和安全边界。换到另一个工具，这些配置又要重做。

ECC 把这类经验整理成可安装、可复用的工程资产。它支持 Claude Code、Codex、Cursor、OpenCode、Gemini、Zed 等 AI 编程工具。ECC 

ECC 用来解决什么问题

Claude Code、Codex、Cursor 这类工具可以看作 AI 智能体的运行环境，也就是英文文档里常说的 harness。模型负责推理，运行环境负责读取文件、执行命令、调用工具和管理上下文。

ECC 在这些运行环境之上提供一层共享工作流。你可以把代码规范、任务方法、自动检查和 MCP 配置放进同一套系统，再按不同工具的能力做适配。

在 2.0.0-rc.1 的 README 中，仓库列出了 63 个 Agents、249 个 Skills 和 79 个兼容传统命令的适配入口。它覆盖日常开发、代码审查、安全检查、研究和内容发布等场景。

对于经常使用 AI 编程工具的人，ECC 能减少两类重复工作：

• 每个项目都要重新编写规则和提示词
• AI 修改代码后，开发者还要反复提醒它测试、检查和验证

仓库里有哪些内容

Skills：任务方法

skills/ 目录中的每个 SKILL.md 都描述了一类任务的执行方法，例如 API 设计、TDD、代码审查、安全审查、文档查询和上下文管理。

Skill 是 ECC 中最容易跨工具复用的部分。同一份任务方法可以交给 Claude Code、Codex 或 OpenCode，只需要调整加载方式。

Rules：项目约定

rules/ 目录保存通用规则、语言规则和框架规则。你可以只安装当前项目需要的目录：

• rules/common
  ：通用工程规则
• rules/typescript
  ：TypeScript 规则
• rules/python
  ：Python 规则
• rules/golang
  ：Go 规则

这些规则能提醒 AI 处理错误、运行测试并保护密钥，省去会话中的重复说明。

Agents：专门角色

ECC 为代码审查、架构分析、文档研究和数据库检查等任务准备了专门角色。角色划分能让复杂任务有更清楚的责任范围。

Hooks：自动检查

支持 Hooks 的工具可以在文件编辑、命令执行或提示提交时触发动作。ECC 提供的 Hook 脚本可用于自动格式化、TypeScript 检查、密钥检测和 MCP 调用记录。

ECC 会话存储示例

MCP、会话与编排

ECC 还包含 MCP 配置、会话记录、持续学习和并行工作流。长任务或多人协作项目可以用这些能力减少上下文丢失，留下更清楚的交接记录。

ECC 并行工作流示例

适合使用 ECC 的场景

以下情况值得尝试 ECC：

• 你在多个项目中使用 AI 编程助手，希望复用同一套规范
• 团队成员使用不同工具，需要统一测试和审查流程
• 长会话经常丢失上下文，任务交接不够清楚
• 你想使用 MCP、子代理或 Hooks，又不想从零搭建

ECC Agentic Security 指南素材

图：ECC 官方安全指南素材。

使用边界

ECC 不会替代 Claude、GPT 或 Gemini，也不能保证 AI 生成的代码可以直接上线。

各工具的运行能力也有差别。Claude Code、OpenCode 和 Cursor 可以通过各自的 Hook 或事件系统执行自动检查。Codex 当前主要依赖 AGENTS.md、Skills、MCP 配置和指令约束，无法获得相同的 Hook 执行效果。

你仍然需要管理权限、密钥、代码审查和沙箱策略。

安装前先选一条路线

插件安装和完整手动安装只能选一种。

ECC 官方 README 提醒，用户先安装 Claude Code 插件，再运行完整手动安装命令时，Skills、命令和 Hooks 可能重复加载。

安装前请准备 Git、Node.js、npm，以及你计划使用的 AI 编程工具。

Claude Code：插件安装

多数 Claude Code 用户可以从插件开始。在 Claude Code 中执行：

text
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

ECC 使用了三个公开名称：

插件会加载 ECC 的 Skills、命令和 Hooks。Claude Code 插件不能自动分发 rules，需要规则时请克隆仓库：

bash
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install

macOS 或 Linux：

bash
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/

Windows PowerShell：

powershell
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/"

请复制整个规则目录，保留相对路径引用并避免文件名冲突。

安装后可以尝试：

text
/ecc:plan "为项目添加用户认证"

Claude Code：最小化手动安装

如果你只想体验规则、代理、命令和基础工作流，可以使用 minimal profile。它不包含 hooks-runtime，适合作为第一次安装的起点。

macOS 或 Linux：

bash
git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile minimal --target claude

Windows PowerShell：

powershell
git clone https://github.com/affaan-m/ECC.git
cd ECC
.\install.ps1 --profile minimal --target claude

也可以显式指定 npm 包和预发布版本：

bash
npm exec --package=ecc-universal@2.0.0-rc.1 -- ecc install --profile minimal --target claude

不要直接写 npx ecc。npm 上存在另一个名为 ecc 的独立包，显式指定 ecc-universal 可以避免装错。

为其他工具安装

ECC 的安装器支持 --target 参数：

bash
npm exec --package=ecc-universal@2.0.0-rc.1 -- ecc install --profile minimal --target codex
npm exec --package=ecc-universal@2.0.0-rc.1 -- ecc install --profile minimal --target cursor
npm exec --package=ecc-universal@2.0.0-rc.1 -- ecc install --profile minimal --target gemini
npm exec --package=ecc-universal@2.0.0-rc.1 -- ecc install --profile minimal --target zed

从克隆的仓库运行时，可以使用安装脚本：

bash
./install.sh --profile minimal --target codex
./install.sh --profile minimal --target cursor

Windows PowerShell 把 ./install.sh 换成 .\install.ps1。

Codex

ECC 为 Codex 提供 AGENTS.md、Codex 配置、Skills、MCP 参考配置和多代理角色示例。

在 ECC 仓库中运行 Codex 时，Codex 会读取根目录的 AGENTS.md 和 .codex/。仓库还提供同步脚本，把 ECC 资产同步到 ~/.codex：

bash
npm install
bash scripts/sync-ecc-to-codex.sh

同步脚本会向 MCP 配置追加 ECC 服务器，不会删除已有服务器。执行前可以加 --dry-run 预览。

Cursor

Cursor 使用自己的规则、代理、Hooks 和 MCP 配置目录。ECC 通过适配层安装共享逻辑。

安装 TypeScript 相关内容：

bash
./install.sh --target cursor typescript

Windows PowerShell：

powershell
.\install.ps1 --target cursor typescript

OpenCode

OpenCode 可以安装 ECC 的 npm 包：

bash
npm install ecc-universal

上面的命令会安装 npm latest 标签对应的稳定版本。需要 2.0.0-rc.1 时，可以安装 next：

bash
npm install ecc-universal@next

然后在 opencode.json 中加入：

json
{
"plugin": ["ecc-universal"]
}

这个配置会启用 OpenCode 插件模块，但不会把完整的命令、代理和指令目录加入项目。需要完整配置时，请在 ECC 仓库中运行 OpenCode，或按 .opencode/ 文档复制对应资产。

Profile 怎么选

ECC 的安装清单提供了多个 profile：

第一次使用可以从 minimal 开始。不确定该装什么时，先让 ECC 推荐组件：

bash
npm exec --package=ecc-universal@2.0.0-rc.1 -- ecc consult "security reviews" --target claude

检查、修复与卸载

从仓库运行 ECC 时，可以使用生命周期命令检查安装状态：

bash
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair

卸载前先预览：

bash
node scripts/ecc.js uninstall --dry-run

确认后执行卸载：

bash
node scripts/ecc.js uninstall

ECC 会根据安装状态记录移除文件，不会删除它未安装的文件。

常见问题

插件安装和完整手动安装叠加

重复安装会让技能、命令和运行时行为重复。清理后只保留一条安装路线。

一开始就安装 full

Skills、MCP 工具和规则都会占用上下文。先安装当前项目需要的组件，后续再增加能力。

把不同工具当成相同环境

Skill 可以跨工具复用，Hooks、命令格式、会话能力和插件机制仍然不同。安装前请查看对应工具的适配说明。

适用 ECC的场景

如果你经常在多个项目中使用 Claude Code、Codex、Cursor 或 OpenCode，并且希望固定规范、测试、安全和审查流程，ECC 可以省下不少重复配置时间。

偶尔让 AI 修改一小段代码的用户，先使用工具自带配置通常更轻便。

ECC 精简指南素材

图：ECC 官方精简指南素材。

开始使用

从 minimal 开始，选择当前项目需要的规则和 Skill。等工作流稳定后，再考虑 Hooks、MCP、会话记忆和编排能力。