ECC：为 Claude Code 等编程代理装上工程化工作流
ECC给Claude Code等编程代理加入规划、测试、审查和记忆，区别是把流程装成可复用工具。
GitHub affaan-m/ECC 更新 2026-09-04 分支 main 星标 255.2K 分叉 38.2K
JavaScript Rust Python Shell TypeScript 编程代理工程化 Claude Code Codex AgentShield GitHub

🧭 决策指南

为什么现在热： 材料显示，ECC当日新增751颗星并达到247,602颗星；同时最新版本ECC 2.2.0包含Guided Setup、Antigravity 2.0和Nasiko CLI Bridge，README又突出68个agents、286个skills及Claude Code/Codex等多harness支持。材料不足以证明具体因果，但这些发布与规模信号能解释其当前关注度。

适合，如果你

  • 你使用Claude Code 2.1+，希望让TDD变成RED→GREEN→REFACTOR流程
    README“Why Choose ECC?”：TDD becomes a gated RED -> GREEN -> REFACTOR workflow with evidence；安装要求为Claude Code 2.1+
  • 你需要68个agents处理规划、代码审查、build repair或security任务
    README“What's Inside”列出68 specialized subagents，功能表列出规划、审查、修复和安全用途
  • 你要同时配置Claude Code、Codex和Kimi Code
    README“Universal guided setup details”提供npx ecc-universal install --guided，并说明可选择三种harness
  • 你希望扫描prompt、hooks、MCP配置、permissions和agent files
    README功能表将AgentShield定义为扫描这些代理运行时资产的组件

不适合，如果你

  • 你只使用GitHub Copilot，并且依赖hooks或agents/delegation
    README“Feature coverage”明确写Copilot不支持hooks/automation和agents/delegation
  • 你的环境没有Node.js 18+、Git或Claude Code 2.1+
    README安装说明要求Node.js 18或更新版本、Git以及PATH中的Claude Code 2.1或更新版本
  • 你无法从官方GitHub、npm或GitHub App渠道安装
    README警告非官方重新发布和镜像未维护或审核，可能包含malware
  • 你要求Cursor、OpenCode或其他harness具备Claude Code的完整能力
    README写明Claude Code目前支持最好，其他harness使用capability-limited adapters，并要求查看support status matrix

前置条件

  • 通用安装需要 Node.js 18 或更高版本
  • Claude Code 插件安装需要 Git
  • Claude Code 插件安装需要 PATH 中的 Claude Code 2.1 或更高版本
  • package-runner 命令需要 ecc-universal 2.2.0 或更高版本
  • 只能从 github.com/affaan-m/ECC、ecc-universal、ecc-agentshield、GitHub App ecc-tools、插件 ecc@ecc 或 ecc.tools 获取

第一步命令（README 原文）

npx ecc-universal setup

要注意

  • 不要同时运行npx ecc-universal setup和Claude native plugin安装，否则会叠加Claude安装路径
    README明确要求两条路径选一条，且不要再进行完整手动安装
  • npm出现版本或缓存错误时，先执行npm view ecc-universal version确认registry版本
    README“Install with Claude Code”给出了该排查命令
  • Yarn Classic 1没有yarn dlx，不能照搬Yarn 2+命令
    README“Universal guided setup details”明确区分Yarn 2+与Yarn Classic 1
  • README的总skills数量为286，但目录说明写284 reusable workflows
    README功能统计表与“What's Inside”目录注释给出不同数字

替代方案

  • Claude Code native plugin commands：你希望直接在Claude Code内部安装ecc@ecc，而不是运行npx向导
    Install with Claude Code
  • GitHub Copilot：你只需要copilot-instructions.md、plan prompt或security-review prompt，不需要ECC的hooks和subagents
    Feature coverage

材料未说明

  • 未提供完整support status matrix，无法确认Cursor、OpenCode、Zed等平台各功能的具体缺失项
  • 未提供AgentShield的扫描命令、扫描结果格式和误报处理方式
  • 未提供68个agents与286个skills的完整名称、版本锁定方式和逐项维护状态
  • 未提供hooks对构建耗时、上下文消耗或代理成功率的量化影响
  • 未提供Codex、Kimi Code和Claude Code在同一项目中的实际隔离与冲突细节
  • README节选未提供完整测试命令、测试覆盖率和CI状态
  • 未说明GitHub App对私有仓库的权限范围与数据处理细节

💡 深度解析

7
不适合完整采用，因为 README 明确显示 Copilot 不支持 Hooks/automation 和 Agents/delegation，只能使用受限功能映射。 我只使用 GitHub Copilot，当前只能配置 `copilot-instructions.md`、`plan`/`tdd` prompt 和外部 PR 审查；如果我需要 ECC 的 Hooks、Agents 委派和独立上下文审查，它适合吗？
适合读者： 使用 GitHub Copilot 的个人开发者，只能依赖 `copilot-instructions.md`、prompt 和外部 PR 审查，无法使用 Hooks 或子代理 API

不适合完整采用，因为你需要的两个关键能力正是 Copilot 的明确限制项。

  • README 的 Copilot feature coverage 显示 coding standards 可通过 copilot-instructions.md 实现，security checklist、testing/TDD、plan 和 build-fix 可通过 always-on instruction 或 prompt 映射。
  • Code review 依赖外部 PR 工具 CodeRabbit + Greptile，而不是 ECC 的 fresh-context reviewer。
  • Copilot 的 Hooks / automation 和 Agents / delegation 都标记为 Not supported，因此无法复现 ECC 在 Claude Code 中的运行时门禁和专用代理协作。
  • 如果你的目标只是复用规则、TDD prompt 和计划入口，仍可获得部分价值；但不能把它当作完整 ECC Harness。
  • Feature coverage：Copilot 的 Coding standards、Security checklist、Testing / TDD、Implementation planning 映射
  • Feature coverage：`Code review | External PR review via CodeRabbit + Greptile`
  • Feature coverage：`Hooks / automation | Not supported`
  • Feature coverage：`Agents / delegation | Not supported`
材料未说明：README 未说明 Copilot 适配器的具体安装命令和同步方式；README 未说明 Copilot prompt 映射能否自动生成或持续同步
视情况，因为 ECC 统一了工作流源目录，但不同 Harness 的 Hooks、插件生命周期和子代理能力并不等价。 我同时维护 Claude Code、Codex、Cursor 和 GitHub Copilot，希望同一套 Agents、Skills、Rules 和 Hooks 跨工具复用，ECC 能否提供功能等价的统一方案？
适合读者： 同时维护 Claude Code、Codex、Cursor 和 GitHub Copilot 配置的技术负责人，想用一套源目录减少多工具工作流分叉

视情况，因为 ECC 能减少配置内容分叉，却不能让 Cursor 和 Copilot 获得 Claude Code 的全部运行时能力。

  • README 说明根目录是 source of truth，平台适配器会映射或打包同一套 workflows，而不是维护独立副本。
  • Claude Code 有官方插件和 plugin-managed hooks；Codex 有 supported sync path。
  • README 的 Copilot 对照表明确写出 Hooks / automation 不支持，Agents / delegation 也不支持；Cursor、Copilot 等平台可能缺少 Hooks、子代理委派或插件生命周期。
  • 因此计划、TDD、规则等内容可部分复用，但需要按平台能力设计降级流程，不能假设功能完全一致。
  • What's Inside：`The root is the source of truth. Platform adapters package or map these same workflows`
  • README 开头：works best with Claude Code today，has a supported Codex sync path，其他平台为 capability-limited adapters
  • Feature coverage：Copilot 的 `Hooks / automation | Not supported`
  • Feature coverage：Copilot 的 `Agents / delegation | Not supported`
材料未说明：README 摘要未给出 Claude Code、Codex、Cursor 与 Copilot 的完整逐项能力矩阵；README 未说明跨平台同步冲突的自动解决策略
适合，因为 Claude Code 是 ECC 当前支持最完整的 Harness，并且内置了计划、TDD、独立审查、Hooks 和记忆流程。 我们已经在 Node.js 18+、Git 和 Claude Code 2.1+ 环境中开发，希望代理按计划、TDD、实现、独立审查和验证执行，并把流程安装到团队的私有仓库中，ECC 适合吗？
适合读者： 正在使用 Claude Code 2.1+、Node.js 18+ 和 Git 的软件团队，希望把 TDD、独立代码审查与 Hooks 固化到私有仓库流程中

适合，因为你们的运行环境满足 README 的 Claude Code 安装要求，且目标正好对应 ECC 的工程流程。

  • README 将流程定义为 plan -> test -> implement -> review -> verify -> remember -> improve，计划会先变成可编辑工件。
  • 68 个 Agents 覆盖 planning、review、build repair 和 security；286 个 Skills 包含 TDD、research、security 等工作流。
  • Claude 插件路径会安装 skills、agents、commands 和 plugin-managed hooks；Hooks 可在提示词之外执行确定性检查。
  • 私有仓库可以使用 MIT 开源组件；若需要托管 GitHub App，README 标注私有仓库产品为 $19/seat/mo 起。

README 没有说明这些流程接入你们现有 CI、权限审批和仓库规则后的具体改造量。

  • Install with Claude Code：需要 Node.js 18 or newer、Git、Claude Code 2.1 or newer
  • Why Choose ECC?：`plan -> test -> implement -> review -> verify -> remember -> improve`
  • Access to 68 agents, 286 skills, and 94 legacy command shims
  • Install with Claude Code：native path installs skills, agents, commands, and plugin-managed hooks
npx ecc-universal setup
材料未说明：README 未说明现有 CI、代码审查审批和企业权限模型的具体集成方式；README 未提供缺陷率、交付效率或 Token 消耗的独立基准
适合，但不能单独替代企业安全审查，因为 ECC 明确扫描代理配置资产，却没有承诺消除所有供应链或模型风险。 我负责私有仓库的 MCP、Hooks、Secrets 和代理权限审查，希望扫描提示词与 Harness 配置层的风险；ECC 能否覆盖传统代码扫描之外的代理安全问题？
适合读者： 负责审查 MCP、Hooks、Secrets 和代理权限的安全工程师，维护私有代码仓库并担心 AI Harness 配置成为供应链攻击面

适合，因为 AgentShield 的扫描范围直接覆盖你关心的代理运行环境，但它仍属于安全流程中的一个组件。

  • README 将 AgentShield 列为 included，并明确扫描 prompts、hooks、MCP config、permissions、secrets 和 agent files。
  • 项目警告只从 GitHub 仓库、ecc-universal、ecc-agentshield、GitHub App、ecc@ecc 和 ecc.tools 等 verified channels 安装；非官方镜像可能包含 malware。
  • ECC 把 agent configuration 视为 attack surface，而不是默认可信配置，这与 MCP、Hooks 和权限审查目标一致。
  • 但项目洞察明确指出 ECC 不能替代依赖安全平台、权限治理、CI/CD 和人工架构决策，也不能消除模型幻觉与推理错误。
  • WARNING：`Official sources only`；第三方 re-uploads 和 unofficial mirrors may contain malware
  • What's Inside：AgentShield 扫描 `prompts, hooks, MCP config, permissions, secrets, and agent files`
  • Why Choose ECC?：`AgentShield scans the harness itself as an attack surface`
  • 项目洞察 usage_limitations：ECC 不能替代 CI/CD、正式代码审查、依赖安全平台、权限治理和人工架构决策
npx ecc-universal setup
材料未说明：README 未说明 AgentShield 支持的漏洞规则、误报率和扫描输出格式；README 未说明 AgentShield 是否能阻断高风险操作，还是只生成发现报告
适合，因为 ECC 的 Skills-first 和按需加载设计正好覆盖多领域任务，并能减少把全部规则常驻上下文的需要。 我的仓库同时包含前端、数据、机器学习、运维和文档任务，团队已经有 TDD 与代码审查流程；我想按需加载领域 Skills，ECC 是否比继续维护一套大型提示词更合适？
适合读者： 维护包含前端、数据、机器学习、运维和文档任务的中型代码仓库，已有 TDD 和代码审查习惯，但希望按需加载领域工作流

适合，因为你的任务范围足够广，且团队已有工程流程基础，能降低 ECC 的学习和治理成本。

  • README 列出 286 个 Skills，覆盖 TDD、research、security、docs、frontend、data、ML 和 operations，与你们的任务类型直接匹配。
  • 项目强调 Skills keep the context focused，Skills 按需加载，避免把所有领域知识一次性塞进上下文。
  • Rules 是 selective 的，可按语言或项目选择始终加载的标准；Commands 仍保留为 94 个兼容入口。
  • 项目洞察指出，对已有 TDD、代码审查和 CI 实践的团队，上手成本相对可控；但一次启用过多 Rules、Skills 或 Hooks 会带来上下文噪声和行为不可预测。
  • Access to 68 agents, 286 skills, and 94 legacy command shims
  • What's Inside：Skills include `TDD, research, security, docs, frontend, data, ML, operations`
  • What's Inside：`rules/ # opt-in common and language standards`
  • 项目洞察 user_experience：已有 TDD、代码审查和 CI 实践的团队上手成本相对可控
材料未说明：README 未提供按仓库规模或任务类型裁剪 Skills 的自动化策略；README 未量化按需加载相对完整提示词的 Token 节省幅度
不适合，因为项目的流程与组件规模可能超过简单脚本任务所需，带来的配置和学习成本未必值得。 我只维护一个小型 JavaScript 脚本仓库，不需要多代理委派、跨 Harness 同步、TDD 门禁或长期 Memory；ECC 的 68 个 Agents 和 286 个 Skills 会不会超过我的实际需求？
适合读者： 只维护简单脚本和小型单仓库的 JavaScript 开发者，不需要多代理委派、TDD 门禁或跨 Harness 同步

不适合，因为你的约束排除了 ECC 主要价值所在的复杂流程协作和多工具治理。

  • ECC 一次提供 68 个 Agents、286 个 Skills 和 94 个 command shims，覆盖 planning、review、security、architecture 及多个领域。
  • 它的目标流程包含计划、测试、实现、独立审查、验证、记忆和持续改进，不是单纯的代码补全或提示词集合。
  • 项目洞察明确指出，小型项目或简单脚本任务可能因流程开销过大而得不偿失。
  • 你不需要多 Harness 复用、Hooks、Memory 或 AgentShield 时，ECC 的统一源目录和运行时机制也难以产生对应收益；README 没有提供更轻量的 JavaScript-only 发行配置说明。
  • README 开头：`Access to 68 agents, 286 skills, and 94 legacy command shims`
  • README 开头：`plan -> test -> implement -> review -> verify -> remember -> improve`
  • 项目洞察 usage_limitations：`小型项目或简单脚本任务可能因流程开销过大而得不偿失`
  • 项目洞察 user_experience：68 个 Agents 和 286 个 Skills 会带来组件选择和流程设计负担
材料未说明：README 未说明最小安装集合或仅启用少量 JavaScript Skills 的官方配置；README 未提供简单脚本任务的性能、Token 或耗时开销数据
视情况，但总体适合，因为 ECC 2.2 提供 Codex 和 Kimi Code 的引导式安装，同时 README 要求按平台确认能力差异。 我使用 Node.js 18+，需要在 Codex 和 Kimi Code 之间复用 ECC 的计划、Skills、Memory 和 AgentShield，但不要求每个平台都具备 Claude Code 的全部 Hooks 能力，ECC 是否合适？
适合读者： 想在 Codex 与 Kimi Code 之间同步 AI 工作流的开发者，使用 Node.js 18+，并要求保留计划、记忆和安全扫描能力

视情况，但总体适合，因为你的目标是跨工具复用工作流，而不是要求所有 Harness 完全等价。

  • README 写明 ECC 2.2 includes guided package setup for Claude Code、Codex 和 Kimi Code；通用包要求 Node.js 18 或更新版本。
  • 项目描述直接列出 Claude Code、Codex、OpenCode、Cursor 等目标 Harness，且说明 Codex 有 supported sync path。
  • 根目录作为 source of truth，平台适配器负责映射或打包相同 workflows，有利于共享 Skills、Rules 和代理角色。
  • 但 README 同时强调应先查看 support status matrix；其他工具可能缺少 Hooks、子代理委派或插件生命周期，因此 Memory、AgentShield 和运行时自动化的实际覆盖需要逐项确认。
  • Install ECC：`ECC 2.2 includes guided package setup for Claude Code, Codex, and Kimi Code`
  • Install ECC：`The universal package requires Node.js 18 or newer`
  • 项目描述：`Skills, instincts, memory, security ... for Claude Code, Codex, Opencode, Cursor and beyond`
  • README 开头：`has a supported Codex sync path`；其他平台为 capability-limited adapters
  • What's Inside：`The root is the source of truth`
npx ecc-universal setup
材料未说明：提供的 README 摘要未列出 Kimi Code 的具体功能覆盖和同步命令；README 未说明 Codex 与 Kimi Code 是否都支持相同的 Memory、Hooks 和 AgentShield 生命周期

✨ 核心亮点

  • 提供68个agents、286个skills和94个commands
  • 用plan→test→implement→review流程组织代理工作
  • AgentShield扫描prompt、hooks、MCP配置与secrets
  • Claude Code支持最完整，其他平台存在能力差异

🔧 工程化

  • npx ecc-universal setup安装并管理ecc@ecc插件
  • hooks、rules和memory负责检查、标准与会话沉淀
  • 68个agents覆盖规划、审查、修复与安全工作
  • 支持Claude Code、Codex及Cursor等多种harness

⚠️ 风险

  • 官方警告第三方镜像可能含恶意软件，只认github.com/affaan-m/ECC等渠道
  • Claude安装路径只能二选一，不能叠加手动安装
  • 通用安装要求Node.js 18+、Git和Claude Code 2.1+
  • README同时写286与284个skills，数量存在不一致

👥 适合谁？

  • 使用Claude Code 2.1+并希望固定TDD与审查流程的开发团队
  • 需要在Claude Code、Codex和Kimi Code间统一安装的用户
  • 关注代理配置安全、MCP和secrets扫描的工程师
  • 只使用GitHub Copilot且需要hooks或subagents的团队不匹配