技能介绍

ECC 是来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合，也是一套智能体 Harness 性能优化系统：不止是配置文件，而是一整套完整系统——技能体系、本能行为、记忆优化、持续学习、安全扫描，以及研究优先的开发模式。包含可直接用于生产环境的智能体、技能模块、钩子、规则、MCP 配置，以及兼容传统命令的适配层，所有内容均经过 10 个多月高强度日常使用与真实产品开发迭代打磨而成。

可在 Claude Code、Codex、Cursor、OpenCode、Gemini 及其他 AI 智能体框架中通用，全面支持 Windows、macOS 和 Linux。仓库地址：https://github.com/affaan-m/ECC ，MIT 许可，最新版本 v2.2.3。

适用场景

  • 在 Claude Code / Codex / Cursor / OpenCode / Gemini 中做真实项目开发，希望开箱即用的技能、命令、子智能体与钩子体系。
  • 需要统一的编码、测试、Git 工作流与安全规范（rules/ 规则库）。
  • 需要 Token 优化、内存持久化、持续学习、验证循环、并行化与子代理编排等进阶工作流。
  • 需要审计自己的 Claude Code 配置安全（密钥、权限、钩子注入、MCP 风险）。
  • 希望从自己的仓库/Git 历史提炼可复用技能与「直觉」。

核心能力

  • 技能 / 命令 / 代理：README 快速开始称安装后可使用 71 个代理、311 个技能和 97 个命令。技能涵盖 coding-standards、tdd-workflow、security-review、eval-harness、verification-loop、continuous-learning、search-first、golang/python/django/laravel/springboot 等语言与框架模式；子智能体含 planner、architect、code-reviewer、security-reviewer、build-error-resolver、e2e-runner 等 36 个专用角色。
  • 规则库：common/ 通用原则（编码风格、Git 工作流、测试、性能、模式、钩子、子代理、安全）+ typescript / python / golang / swift / php 语言专属规范。
  • 钩子与脚本：基于触发器的自动化（PreToolUse、PostToolUse、Stop 等），含会话记忆持久化、上下文精简建议；全部钩子与脚本用 Node.js 重写以保证跨平台兼容。
  • 持续学习：从会话中自动提取模式为可重用技能；持续学习 v2 基于「直觉」学习并附置信度评分（/instinct-status、/evolve 等）。
  • 记忆库：ecc memory 使用可检查的 ecc.memory.v1 Markdown 文档在 Claude、Codex、Hermes 等 harness 之间传递上下文；可选 ecc-memory-mcp 服务默认不启用。
  • 安全：AgentShield 安全审计（1282 项测试、98% 覆盖率、102 条静态分析规则），覆盖密钥检测、权限审计、钩子注入分析、MCP 服务风险评估、智能体配置审查五大类别。
  • 生态工具：技能创建器（本地 /skill-create 分析 Git 历史生成 SKILL.md，或 GitHub 应用自动触发）；manim-video、remotion-video-creation 等媒体与发布工具。

效果预览

精简指南封面

精简指南：设置、基础、理念。先读这个。

详细指南封面

详细指南：Token 优化、内存持久化、评估、并行化。

安全指南封面

安全指南：攻击向量、沙箱技术、数据净化、CVE 漏洞、Agent 防护。

工作方式

四个关键概念：

代理——子代理以有限范围处理委派的任务：

---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---

你是一名高级代码审查员...

技能——由命令或代理调用的工作流定义：

# TDD 工作流

1. 首先定义接口
2. 编写失败的测试（RED）
3. 实现最少的代码（GREEN）
4. 重构（IMPROVE）
5. 验证 80%+ 的覆盖率

钩子——在工具事件时触发。示例 - 警告 console.log：

{
  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
  "hooks": [{
    "type": "command",
    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] 移除 console.log' >&2"
  }]
}

规则——始终遵循的指南，分为 common/（通用）+ 语言特定目录：

~/.claude/rules/
  common/          # 通用原则（必装）
  typescript/      # TS/JS 特定模式和工具
  python/          # Python 特定模式和工具
  golang/          # Go 特定模式和工具
  perl/            # Perl 特定模式和工具

其他机制：

  • Claude Code v2.1+ 会按约定自动加载已安装插件中的 hooks/hooks.json；不要在 plugin.json 中显式声明 hooks 字段，否则触发重复检测错误。
  • 包管理器自动检测（npm、pnpm、yarn、bun），优先级：CLAUDE_PACKAGE_MANAGER 环境变量 → .claude/package-manager.json → package.json 的 packageManager → 锁文件 → 全局配置 → 回退第一个可用。
  • 钩子严格度可用运行时标记调整：
# 钩子严格度配置文件（默认值：standard）
export ECC_HOOK_PROFILE=standard

# 以英文逗号分隔的钩子 ID 列表，用于禁用指定钩子
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

你需要提供

  • Claude Code 命令行 v2.1.0 或更高（claude --version 查看）。
  • Node.js 与包管理器（npm / pnpm / yarn / bun）。
  • MCP 配置中的 API 密钥：把 YOUR_*_HERE 占位符替换为你的真实密钥。
  • 若启用统一记忆库：先单独安装 ECC npm 运行时：
npm install -g ecc-universal
ecc memory --help
command -v ecc-memory-mcp

启用 ecc-memory-mcp 还需操作者设置小写 ECC_MEMORY_HARNESS 身份；只有设置 ECC_MEMORY_ALLOW_USER_SCOPE=1 后 MCP 调用才能请求 user 范围。

  • 使用 multi-* 命令需额外安装 ccg-workflow 运行时（npx ccg-workflow），否则命令无法运行。

你会获得

  • 71 个代理、311 个技能和 97 个命令（插件安装即自动加载技能、命令和 hooks）。
  • rules/ 规则库、contexts/ 动态注入上下文（dev / review / research）、examples/ 真实项目配置示例（Next.js SaaS、Go 微服务、Django API、Laravel API、Rust API）、mcp-configs/ MCP 服务端配置。
  • 跨平台支持（Windows、macOS、Linux），与 Cursor、OpenCode、Antigravity 等 IDE 及命令行工具集成。
  • 测试套件（node tests/run-all.js）与社区贡献生态。

使用示例

安装（推荐，作为插件）：

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

# 安装插件
/plugin install ecc@ecc
注意：插件安装方式较为便捷，但如果你的 Claude Code 版本无法正常解析自托管市场条目，建议使用开源安装脚本，稳定性更高。插件安装后不要再运行 ./install.sh --profile full / .\install.ps1 --profile full / npx ecc-universal install --profile full，否则技能会重复；插件不自动分发 rules，只需手动复制所需规则目录：
# 首先克隆仓库
git clone https://github.com/affaan-m/ECC.git
cd ECC

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

# 插件安装路径：只复制规则
mkdir -p ~/.claude/rules
cp -R rules/common ~/.claude/rules/
cp -R rules/typescript ~/.claude/rules/

开始使用：

# 尝试一个命令（插件安装使用命名空间形式）
/ecc:plan "添加用户认证"

# 手动安装（选项2）使用简短形式：
# /plan "添加用户认证"

# 查看可用命令
/plugin list ecc@ecc

安全审计（AgentShield）：

# 快速扫描（无需安装）
npx ecc-agentshield scan

# 自动修复安全问题
npx ecc-agentshield scan --fix

# 调用 3 个 Opus 4.6 智能体进行深度分析
npx ecc-agentshield scan --opus --stream

# 从零生成安全配置
npx ecc-agentshield init

持续学习 v2（直觉学习）：

/instinct-status        # 显示带有置信度的学习直觉
/instinct-import <file> # 从他人导入直觉
/instinct-export        # 导出你的直觉以供分享
/evolve                 # 将相关直觉聚类到技能中
/promote                # 将项目级直觉提升为全局直觉
/projects               # 查看已识别项目与直觉统计

注意事项（README 原文提示）：

  • 上下文窗口管理：不要一次启用所有 MCP。经验法则：配置 20-30 个 MCP、每个项目保持启用少于 10 个、活动工具少于 80 个；在项目配置中使用 disabledMcpServers 禁用未使用的。
  • 定制化：从适合你的开始、为你的技术栈修改、删除你不使用的、添加你自己的模式。