命令行工具
EveryInc/compound-engineering-plugin avatar
EveryInc/compound-engineering-plugin

compound-engineering-plugin 评测:用 33 个技能把 AI 编码代理的每次改动变成下一次的垫脚石

适用于 Claude Code、Codex、Cursor 等的官方复合工程插件。

25,076 个 Star2,046 个 ForkTypeScriptMIT

秒懂

它是什么?
EveryInc 的 compound-engineering-plugin 为 Claude Code、Cursor、Codex 等 14 个代理宿主提供 33 个技能,核心是一个六步循环:头脑风暴、计划、执行、简化、评审、沉淀。本文基于 README 与仓库结构分析其机制、安装方式与适用边界。
适合谁用?
这个插件适合那些已经用 AI 编码代理做日常开发、并且愿意为计划与评审投入时间的团队。它不适合只想让代理更快写出代码的人,因为 80% 的精力被放在计划与评审上,执行只占 20%。
能商用吗?
可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库最近一次提交在 1 天前。
用什么语言写的?
主要是 TypeScript(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月14日)和我们的分析,不构成法律意见。

开源项目深度解析

它解决的是技术债的复利问题

传统开发模式里,每次改动都会留下一点局部知识,这些知识散落在代码、注释和人的记忆里。下一次改动时,代理或开发者需要重新摸索一遍,代码库越大,上下文越难把握,改动就越慢。这个插件想逆转这个过程:它把工程工作组织成一个循环,每次循环结束时把学到的经验写下来,让下一次循环从更高的起点开始。README 里有一句话点明了核心观点:每个单位的工程工作应该让后续单位更容易,而不是更难。它服务的对象是那些已经在用 AI 编码代理、并且对代码质量有持续要求的个人开发者或小团队,而不是偶尔用代理写脚本的人。

六步循环:从头脑风暴到知识沉淀的闭环

插件定义了六个技能,对应一个完整的开发循环。第一步 /ce-brainstorm 通过交互式问答把需求想清楚,产出一份只含需求的统一计划。第二步 /ce-plan 把这份需求计划丰富成可执行的实施计划。第三步 /ce-work 按计划执行,可以原生执行,也可以交给经过认证的跨模型作者,但宿主仍然保留验证、提交和发布的权利。第四步 /ce-simplify-code 在评审前把刚写的代码整理得更清晰、更可复用。第五步 /ce-code-review 是一个只报告的多代理评审,它对照计划检查代码,但不会自动应用修改,本地应用是显式操作。最后一步 /ce-compound 把学习到的内容写入 docs/solutions/ 目录。这个目录就是下次循环的输入,/ce-brainstorm 和 /ce-plan 会读取它作为背景知识。整个循环的回报箭头是核心,没有这一步,前面五步就只是普通的开发流程。

安装方式:一个 marketplace,十四个宿主

插件通过 marketplace 机制分发。Claude Code 的安装最直接,在聊天里执行两条命令:/plugin marketplace add EveryInc/compound-engineering-plugin,然后 /plugin install compound-engineering。Cursor 和 Grok Bot 都用 /add-plugin compound-engineering,但 Grok Bot 没有独立登录,它复用 Cursor 的账号和插件库,而且文档明确警告不要在 Grok Bot 聊天里运行 /add-plugin,也不要克隆仓库到 Grok Bot 的电脑上。Codex App 比较特殊,它还没有上架内置 marketplace,需要手动添加:在 Plugins 界面选择 Add marketplace,Source 填 EveryInc/compound-engineering-plugin,Git ref 填 main,Sparse paths 留空,安装后还要重启 Codex。Codex CLI 则用两条命令:codex plugin marketplace add EveryInc/compound-engineering-plugin,然后 codex plugin add compound-engineering@compound-engineering-plugin。非默认 profile 需要统一指定 CODEX_HOME,否则插件会装错地方。

技能调用语法因宿主而异

同一个技能在不同宿主上有不同的调用方式。README 用 /skill-name 作为示例,但实际规则更细。Codex 里要用 $skill-name,比如 $ce-plan 和 $lfg,/goal 则是 Codex 的内置命令。oh-my-pi (omp) 里,可见技能可以走模型路由,但手动或隐藏技能必须用确定性的 /skill:<name> 形式,比如 /skill:ce-polish。这个差异对用户来说是实际的认知负担,你换一个宿主就得重新记一套调用语法。文档没有解释为什么不能统一,但可以推测是各宿主对插件命令的原生支持程度不同。如果你同时在 Claude Code 和 Codex 之间切换,这一点需要提前适应。

升级路径有一个明确陷阱

README 里有一段醒目的警告:如果已经安装了旧版,必须先刷新 marketplace 再更新。它给出的命令是 /plugin marketplace add EveryInc/compound-engineering-plugin,然后才执行 /plugin install compound-engineering。文档明确说,直接运行 /plugin update 会让你停留在旧版本。这是一个容易踩的坑,特别是自动化更新脚本可能会忽略这个顺序。从发布频率看,这个项目更新很勤,v3.23.2 到 v3.23.4 只隔了两天,说明技能内容在快速迭代。如果你依赖自动更新,需要把刷新 marketplace 这一步写进流程,否则你会一直用着旧技能而不自知。

局限:文档薄的地方与不适合的场景

README 给出了完整的安装说明和技能列表,但没有提供任何性能基准或成功率数据。它声称 80% 的精力在计划与评审,20% 在执行,这个比例没有量化依据,更像是一种设计哲学。另一个明显的局限是,/ce-compound 会把学习记录写入 docs/solutions/ 目录,这意味着每个使用插件的项目都会多出一个文档目录,而且这些文档需要维护。如果团队没有写文档的习惯,这个目录很快就会变成垃圾场。另外,插件只适合那些愿意为计划投入时间的场景。如果你只是想让代理快速修一个 bug,或者写一个一次性脚本,六步循环的仪式感会显得很重。文档里没有提到任何离线或私有化部署的选项,对于有严格数据隔离要求的团队,把代码交给第三方代理宿主本身就是一道门槛。

替代方案:普通的提示词工程与自定义脚本

这个插件本质上是一套精心组织的提示词集合,外加 marketplace 分发机制。如果你不想引入第三方依赖,完全可以在自己的配置里写类似的提示词,比如让代理每次改动后输出一段学习笔记,或者强制先写计划再写代码。区别在于,插件把流程固化成了可复用的技能,并且跨宿主统一了调用方式,而自定义脚本需要你为每个宿主单独维护。另一个替代方案是直接使用各宿主自带的插件系统,比如 Claude Code 的原生插件,它们可能已经包含类似评审或计划的技能,但不会像这个插件那样把六步循环串成一个闭环。如果你只需要其中一两个技能,比如代码评审,单独安装一个轻量插件可能比引入整套循环更划算。

维护成本与许可证

项目以 MIT 许可证发布,这意味着你可以自由使用、修改和再分发,但许可证不附带任何担保,使用前需要自己确认合规性。维护成本方面,插件更新频繁,v3.23.2 到 v3.23.4 只隔了两天,说明上游在持续迭代。这意味着你需要定期处理升级,而且升级前必须刷新 marketplace,否则会停留在旧版本。另外,技能内容以本地 prompt 资产的形式存在,Codex 的安装是自包含的,不需要额外配置自定义代理,这降低了部署复杂度。但反过来,如果上游改变了技能的行为或调用语法,你的工作流可能被破坏。由于文档没有提供变更日志的细节,升级前最好先查看 releases 页面或 docs/guides 目录,确认新版本是否改变了你依赖的技能行为。

编辑结论

这个插件适合那些已经用 AI 编码代理做日常开发、并且愿意为计划与评审投入时间的团队。它不适合只想让代理更快写出代码的人,因为 80% 的精力被放在计划与评审上,执行只占 20%。采用前需要先验证两件事:一是你的代理宿主是否在支持列表内,特别是 Codex App 需要手动添加 marketplace,且安装后必须重启;二是你的团队是否接受把学习记录写入 docs/solutions/ 目录,这等于要求每个成员在每次改动后都做一次知识沉淀。如果这两点都能接受,插件值得一试;如果不能,它只会变成一套没人用的流程负担。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记