affaan-m/ECC
# 中文学习卡：ECC
一、一句话定位
ECC 是一个为 AI 编程代理（Agent）设计的“工具腰带操作系统”，让代理可以自动完成“规划→测试→实现→审查→验证→记忆→改进”的完整工程闭环，避免重复提示。
二、核心技术/架构亮点
1. 多语言/多平台适配：原生支持 Shell、TypeScript、Python、Go、Java 等语言，并可接入 Claude Code、Codex、Cursor、Gemini 等 8+ 种 AI 编程工具。
2. 模块化技能体系：内置 68 个代理、292 个技能、94 个命令 shims，代理可基于规则和钩子组合复用。
3. 上下文化记忆：通过持久化记忆机制（“优化上下文窗口，持久化一切”），避免代理每次从头理解项目。
4. NPM + GitHub App 双入口：提供 `ecc-universal` 和 `ecc-agentshield` 两个 npm 包，以及官方 GitHub App，支持公共/私有仓库。
5. 开放生态与赞助模式：MIT 许可，核心开源，Pro 版面向私有仓库收费（$19/人/月），社区活跃（Discord、 Sponsor 计划）。
三、适用场景与目标用户
- 目标用户：使用 AI 编码代理（尤其是 Claude Code）的开发者、DevOps 工程师、希望提升代码质量与自动化流程的团队。
- 典型场景：自动生成测试、代码审查、项目重构、技术债务清理、知识复用到跨项目技能迁移。
四、可动手动作
1. 快速试用：在 Claude Code 中运行 `ecc@ecc` 插件安装命令，立即获得规划→测试→实施→审查的能力。
2. npm 接入：`npm install ecc-universal` 或 `npm install ecc-agentshield`，在 Node.js 项目中引入。
3. GitHub App 安装：访问 github.com/apps/ecc-tools，一键授权到仓库，自动触发代理流水线。
4. 借鉴思路：阅读 `rules/` 和 `hooks/` 目录，模仿其“技能→规则→钩子”架构，为自己的代理定义工作流。
五、学习优先级
P0（本周动手）
理由：如果你已在用 Claude Code 或类似 AI 编程助手，15 分钟即可安装并体验全自动工程闭环，显著减少重复提示，值得立即尝试。⌂