如何安装ECC并跑通第一个AI编码任务:Everything Claude Code 代理框架完整上手指南
【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC
Everything Claude Code(ECC)是一套 AI 代理框架系统:它把 285+ 项技能、68 个专职代理、代码审查与安全扫描装进 Claude Code、Codex 等编码工具,让 AI 按"先计划、再实现、后验证"的流程干活。读完本文,你能在几分钟内装好 ECC,并独立完成一次链式命令任务和几个关键设置调整。
🚀 跑起来:5分钟完成安装
先在终端克隆仓库,进入目录:
git clone https://gitcode.com/GitHub_Trending/ev/everything-claude-code cd everything-claude-code然后运行安装脚本,--profile minimal装最小集,脚本会自动检测你的环境并写入配置:
./install.sh --profile minimalWindows 用户改用install.ps1,参数一致。装完后执行下面的命令做验证,终端会打印 ECC 已安装的技能、命令和 hook 清单,看到列表就说明安装成功:
node scripts/ecc.js list-installed如果列表为空,先跑一次node scripts/ecc.js doctor看自检报告,再重试安装。
🧪 实战演练:3个高频任务
安装完成后,在 Claude Code 里打开你的项目,直接输入斜杠命令。以下三个场景按"要达成什么→怎么做→看到什么"组织。
批量清理旧代码并补上回归测试
你要达成的效果:一个目录重构完成,且测试覆盖不下降。
- 输入
/refactor-clean @src/hooks/,指定要清理的目录。 - 结束后紧接着输入
/test-coverage,检查覆盖率缺口。 - 查看输出:重构改动说明加一条测试缺口清单。
两个命令可以用一句话串起来,AI 会按顺序执行,相当于给 AI 排了一条工作流水线:
合并前审查一次提交
你要达成的效果:在代码合入前拿到一份带优先级的审查意见。
- 输入
/code-review,对当前改动做审查。 - 若要审查 Pull Request,改用
/review-pr。 - 查看输出:问题按"必须修复"和"建议修改"分组,每条附文件位置。
给未覆盖的模块补测试
你要达成的效果:明确哪些函数没有测试,并生成测试草稿。
- 输入
/test-coverage扫描项目。 - 让 AI 针对报告中覆盖率最低的文件生成测试。
- 本地运行测试框架确认新用例全部通过。
改动较大时,先跑/plan生成一份计划文档,确认方向后再动手,能省掉一轮返工。
⚙️ 改这几个设置:收益最大
默认配置能跑,但下面 4 项值得按自己的情况调一次:
| 设置项 | 作用 | 推荐值 |
|---|---|---|
--profile | 控制安装的技能与规则数量,full装全量 285+ 项技能 | 先用minimal,不够再升级 |
--target | 指定安装到哪个代理环境,如claude、cursor、gemini、zed | 选你日常实际使用的那个 |
rules/规则包 | 常驻生效的编码规范,插件路径默认不带 | 从rules/复制common加一个你主力语言的包 |
| 子代理模型分配 | 决定搜索、编码、审查各用哪个模型,直接影响成本 | 搜索用 Haiku,多文件编码用 Sonnet,架构设计用 Opus |
模型分配可以直接写在提示词里,也可以放进agent.yaml的model.preferred作为默认值,主模型默认是claude-opus-4-6,预算紧张可换成 sonnet 档位。
🔧 进阶定制:两条扩展路径
想加自己的技能:在skills/目录下建一个文件夹放入SKILL.md,或在 Claude Code 里直接跑/skill-create生成骨架,保存后重启会话即可被识别。技能结构可参考docs/SKILL-DEVELOPMENT-GUIDE.md。
想让 AI 先画计划再动手:试试 plan canvas,用/plan-canvas生成可视化计划板,在图里标注反馈后再让 AI 执行:
如果你习惯在 IDE 里工作,./install.sh --profile minimal --target cursor可以把 ECC 装进 Cursor,生成项目本地的.cursor/适配器,命令和规则在编辑器内同样可用。
🩹 卡住了怎么办:先跑一条自查命令
- 技能或命令出现两份:通常是叠加了两种安装方式(插件加手动安装),ECC 明确不建议混装。先卸载再按单一方式重装。
- hook 没有生效或终端没有 hook 事件:多半是 hook 配置没落盘,跑自查命令看诊断项。
- AI 输出不稳定、不符合团队规范:检查是否复制了规则包,没有的话把
rules/common加进你的环境。
任何情况先执行这条命令,它会逐项检查安装状态并列出修复建议:
node scripts/ecc.js doctor更完整的故障对照见项目自带的 TROUBLESHOOTING.md,安全相关问题查 the-security-guide.md。
下一步
今天先跑一次node scripts/ecc.js doctor,把报告里标黄的项目修掉。然后打开 the-longform-guide.md 通读一遍,理解计划和验证两个环节的设计。想贡献技能或文档,从 CONTRIBUTING.md 进入。
【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考