跳到正文

目录

Everything Claude Code:从入门资料库到跨终端 Agent 工作流系统

Everything Claude Code:从入门资料库到跨终端 Agent 工作流系统

预计阅读时间:20 分钟 | 难度:⭐⭐⭐

无论你最初是被"Everything Claude Code"这个名字吸引,还是已经在用 Claude Code 想找一套更完整的配置,都可能低估了这个仓库现在的样子。它早已不是一份"怎么装、怎么用"的资料合集,而是一套跨终端的 Agent 工作流系统——同一份 skills、hooks、rules,能同时落到 Claude Code、Codex、Cursor、Gemini 等多个 editing harness 上。

下文先给一张系统地图,再拆开里面的机制,用一个真实任务把它们串起来,最后说清楚哪些人该用、怎么入手。


一、先看这张地图

仓库里规整的内容,大致按四层组织。每一层回答一个不同的问题:

装在哪回答的问题
基础使用CLI 命令、install.shnpx ecc怎么把系统装进某个 harness
工作流资产.claude/skillsinstincts、memory hooks怎么让 Agent 用得有章法
安全边界AgentShield、密钥扫描、.gitignore怎么让 Agent 不踩坑
跨终端扩展.codex.cursor.gemini.mcp.json怎么让同一套资产换工具也能用

这套结构的关键在于:资产写一次,装到多个终端。你不需要为每个工具各维护一份规则,仓库负责把同一份技能和钩子翻译到各 harness 的目录约定里。


二、这个仓库到底是什么

2.1 项目基本信息(GitHub API 2026-09-01 验证)

属性
GitHubaffaan-m/ECC
原仓库名affaan-m/everything-claude-code(已更名)
Stars244,959
Forks37,013
Open Issues122
Commits2,422
LicenseMIT
主要语言JavaScript
默认分支main
官网ecc.tools

仓库描述自述为 “the agent harness performance optimization system”,覆盖 Claude Code、Codex、Opencode、Cursor 等。README 里自称 Agent Harness Operating System,v2.0.0 的公开数据是 261 个 skills。

2.2 从"资料库"到"操作系统"

这个改名的过程,恰好说明了项目定位的迁移。早期它确实是一份 Claude Code 的社区资料库,收录命令、规则和技巧。但随着内容膨胀,作者发现真正值钱的不是"一条条命令说明",而是把 skills、hooks、rules、memory 组合成一套可复用的工作流层,并且能装到不同 harness 上。

所以现在你看到的是:

  • 一份原始代码仓库(README 明确说 “This repo is the raw code only”),真正的讲解在配套的 The Shorthand Guide、The Longform Guide、The Security Guide 三份指南里。
  • 一个按 harness 分层的目录:.claude.codex.cursor.gemini.kimi.opencode.codebuddy.hermes 等。
  • 一套 npm 包(ecc-universalecc-agentshield)和一个 GitHub App(ECC Tools),把仓库能力变成可安装、可升级的产物。

三、核心资产:skills、instincts、memory、security

仓库反复提到的四类资产,不是四个并列的功能,而是四个不同职责的模块。

3.1 Skills——可调用的技能

Skills 是最容易理解的一层:一个 skill 就是一整套提示词、规则和有时会带上脚本的文件夹。调用它,等于给 Agent 一份"这个任务该怎么做"的完整说明。

仓库里 skill 数量在持续增长,v2.0.0 时公开为 261 个,覆盖 TypeScript、Python、Go、Java、Kotlin、Rust、C++ 等多个语言生态,也包含运维、视频处理、市场研究等领域的技能。

值得注意的一点:skill 是按任务类型组织的,不是按工具组织的。同一个 skill 在 Claude Code 和 Codex 里都能被识别,只是落在各自的 skills/ 目录里。

3.2 Instincts——隐性的行为惯性

Instincts 和 skills 的区别在"显式与隐式"。Skill 是用户主动点名调用的;Instinct 更像一组默认行为,Agent 在平时工作中会自然遵守的倾向,比如"优先读 README 再动手"“改完代码跑一遍测试”。

它不是某个单一文件,而是一组分散在规则和系统提示里的行为约束,靠 hooks 在恰当的时机注入。

3.3 Memory——跨会话的记忆

Memory 是仓库里最工程化的一块。它靠 hooks 实现:在会话开始(SessionStart)时把上次的上下文加载进来,在会话结束(Stop 阶段)时把摘要写回,这样下次会话不用重新解释一遍项目背景。

仓库的 Longform Guide 里专门讲了 token 优化和 memory persistence,核心思路是用结构化的会话摘要替代原始对话记录,减少上下文占用。

3.4 Security——Agent 的安全边界

Agent 能读文件、跑命令,安全就变成硬需求。仓库这一层包含:

  • AgentShield:一个独立的 npm 包,做安全扫描。
  • 密钥检查:扫描代码里的硬编码 token、API key。
  • .gitignore.mcp.json 治理:避免敏感信息进版本库。
  • 配套的 Security Guide,讲攻击向量、沙箱、CVE 等。

README 里有一句很明确:非官方渠道的转发和镜像不被维护,可能带恶意软件,所以安装只走官方渠道(GitHub、npm、GitHub App、插件 slug ecc@ecc、官网 ecc.tools)。

四、一个任务如何流过系统

用一个具体例子把上面四层串起来:你接手一个不熟悉的 TypeScript 项目,想让它改一个 bug。

  1. 启动:SessionStart hook 加载上次会话摘要,Agent 恢复对项目的记忆,不用你重新交代背景。
  2. 读上下文:Agent 读取根目录的 CLAUDE.md(或其他 harness 的等价文件),拿到技术栈、代码规范、约束。
  3. 调用 skill:你在对话里调用一个 typescript-debug 之类的 skill,Agent 收到该 skill 的完整工作流说明。
  4. 执行并验证:Agent 按 instinct 的默认倾向,改完代码先跑一遍该项目的测试或 lint,而不是直接交差。
  5. 收尾:Stop 阶段 hook 把这次会话的摘要写回,下次会话能接着用。

这个流程里,四层资产各司其职:memory 管前后衔接,rules 管行为约束,skills 管任务方法,security 在背后防止它乱动不该动的东西。

五、数据与规模怎么读

仓库公开了几个数字,需要分清它们各自说明什么:

  • Stars 245k / Forks 37k:反映的是关注度和二次开发的规模,不能直接推出"它的配置在你的项目里也一定好用"。
  • 261 个 skills / 多个语言生态:说明覆盖面广,但不能推出"每个 skill 都适合你"——大量技能是作者在真实产品迭代中为特定场景沉淀的。
  • “生产就绪、10 个月高强度使用”:这是作者的自我描述,说明他确实在真实项目里跑过,但迁移到你的项目仍需要按你的技术栈裁剪。

一句话:这些数字说明"系统性"和"覆盖面",不说明"拿来即用"。

六、什么时候该用,怎么入手

适合用的人

  • 已经在用某款 AI 编程工具,想从"偶尔用一下"升级到"有方法地用"。
  • 在多款工具之间切换(比如 Claude Code 和 Codex 混用),想要一套统一的配置。
  • 团队想沉淀可复用的审查、测试、技术栈规则,而不是每人各写一份。

不适合一上来就全量用的人

  • 只想快速查一个命令:官方文档更直接。
  • 项目极其简单:装一套 261 个 skills 的系统,多半是在给一个用不着复杂度的项目增加维护负担。

建议的采用顺序

  1. 先用官方渠道装:按 README 走 install.shnpx ecc,装 minimal profile,别一次装全。
  2. 只挑一两个 skill 试:从你最常用的任务类型里选一个 skill,跑一次真实任务,看输出是否贴合你的项目。
  3. 按项目裁剪:把不需要的语言规则、无关技能删掉,只保留与你技术栈相关的部分。
  4. 稳定后再扩展:确认第一套资产稳定了,再考虑 memory hooks、GitHub App 等更重的部分。

七、结尾

Everything Claude Code 最值得看的地方,不是它有多少个 skill,而是它把"怎么让 Agent 工作得有章法"这件事,从一堆散落的技巧整理成了一层可跨终端复用的系统,并配套了安全边界和采用路径。

它仍在快速增长,数据和定位都会继续变化。阅读时以仓库当前状态为准,把它当作"工作流组织方式的参考",而不是一份需要照抄的配置清单。


八、延伸阅读

参与讨论

使用 GitHub 登录。欢迎补充事实、异议与实践。