返回资讯

EveryInc/compound-engineering-plugin

发布时间 2026-09-19 11 天前
来源 GitHub TypeScript
字数 3,616 字
查看原文

AI智能总结

Compound Engineering 是面向 AI 编程智能体的开源插件，内含 36 个技能，围绕头脑风暴、规划、构建、评审、复盘沉淀的闭环组织工作，使每次变更产生的知识可被下一次读取。

Kieran Klaassen 和 Trevin Chow 维护，社区亦有贡献。

Compound Engineering

Compound Engineering 是一个面向 AI 编程智能体（coding agent）的插件，内含 36 个技能（skill）。它围绕一个闭环来组织工作——头脑风暴、规划、构建、评审，然后把你学到的东西沉淀下来——这样每一次变更所产生的知识都会被写入下一个变更可以读到的地方。

它在 14 个智能体宿主（agent host）上运行，包括 Claude Code、Cursor 和 Codex。

由 Kieran Klaassen 和 Trevin Chow 维护，并得到了开源社区的贡献支持。

在变更开始之前想要理解现有行为时，可以调用 ce-explain 来询问相关行为是如何工作的、为什么这样设计。如果需要建议，则使用 ce-pov；加上 "oracle this"（请神谕判断）可以引入独立模型的第三方意见。两者都可以在不需要额外人工介入的情况下，为另一个工作流提供输入。

安装

Claude Code

/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineering

[!IMPORTANT]
已经安装过 Compound Engineering？ 更新前请先刷新市场——参见升级指南。只运行 /plugin update 会停留在旧版本。

Cursor

在 Cursor Agent 对话中，通过插件市场安装：

/add-plugin compound-engineering

或者在插件市场中搜索 "compound engineering"。

Grok Bot

Grok Bot 虽然是独立的应用，但它使用的是你的 Cursor 账号与插件库，并不存在独立的 Grok Bot 登录。只需在该账号上安装一次 Compound Engineering，Grok Bot 中的智能体即可加载它。

在 Cursor Agent 对话中：

/add-plugin compound-engineering

或者在 Cursor 插件市场中搜索 "compound engineering"。请勿在 Grok Bot 对话中运行 /add-plugin，也不要将本仓库克隆到 Grok Bot 的机器上。

Codex App

Compound Engineering 暂未上架 Codex 的内置插件市场，需要作为自定义市场添加：

  1. 在 Codex 应用中，从侧边栏打开 Plugins。

  2. 点击 Create 旁边的箭头，选择 Add marketplace。

  3. 填写：

    字段 值
    Source EveryInc/compound-engineering-plugin
    Git ref main
    Sparse paths 留空

  4. 点击 Add marketplace。

  5. 搜索 Compound Engineering，安装 compound-engineering-plugin，然后重启 Codex。

Codex App 中的安装对 Compound Engineering 而言是自包含的。专家级评审与研究能力作为本地提示资产内嵌于技能中，无需额外的自定义智能体（custom-agent）安装步骤。

Codex CLI

先注册市场，再安装插件。

  1. 向 Codex 注册市场：

    codex plugin marketplace add EveryInc/compound-engineering-plugin

  2. 安装插件：

    codex plugin add compound-engineering@compound-engineering-plugin

    也可以启动 codex，运行 /plugins，找到 Compound Engineering 市场，选中 compound-engineering 插件并选择 Install。安装完成后重启 Codex。

原生的 Codex 插件安装对 Compound Engineering 而言是自包含的。专家级评审与研究能力作为本地提示资产内嵌于技能中，无需额外的自定义智能体安装步骤。

如果使用非默认的 Codex profile，请对所有 Codex 相关步骤使用同一个 CODEX_HOME。下面的示例将 CE 安装到 work profile：

CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add EveryInc/compound-engineering-plugin
CODEX_HOME="$HOME/.codex/profiles/work" codex plugin add compound-engineering@compound-engineering-plugin

市场注册步骤只是让插件变得可用；真正激活该 profile 下原生 CE 技能的是插件安装本身。

使用其他编辑器或 CLI？ Kimi Code CLI、Cline、Grok Build CLI、Devin CLI、GitHub Copilot、Factory Droid、Qwen Code、OpenCode、Pi、oh-my-pi (omp) 以及 Antigravity CLI 全部受支持——请参阅更多安装选项。

理念

每一份工程工作都应当让后续工作更轻松，而不是更困难。

调用语法说明：本 README 中的示例使用 /skill-name 这种斜杠命令形式，面向基于 slash-skill 的宿主。在 Codex 中，请使用 $skill-name 调用已安装的技能（例如 $ce-plan 和 $lfg）。在 oh-my-pi (omp) 中，这些提示词可以将模型路由到可见的技能；若需要手动调用仅限本地或隐藏的技能，请使用其原生确定的 /skill: 形式（例如 /skill:ce-polish）。/goal 仍然是 Codex 的内置命令。

传统开发会不断累积技术债：每个功能都增加复杂性，每次修 bug 都会留下一点局部知识，等着后人重新发现。代码库越来越大，完整上下文越来越难以掌握，下一次变更也越来越慢。

Compound Engineering（复合工程）则颠倒这一过程。80% 投入在规划与评审，20% 投入在执行：

  • 在写代码之前，先用 /ce-brainstorm 与 /ce-plan 做彻底规划，沿用同一份计划产物（artifact），从需求一路演进到实现规划
  • 用 /ce-code-review 和 /ce-doc-review 做评审，发现问题并校准判断
  • 用 /ce-compound 将知识沉淀下来，使其可被复用
  • 持续保持高质量，让未来的变更更容易

其要义在于杠杆效应，而非形式主义。一次好的头脑风暴让规划更锐利；一份好的规划让执行更小；一次好的评审抓住的是模式，而不仅仅是 bug；一条好的复合笔记意味着，下一位智能体不必从零学习同样的教训。

闭环

核心闭环共六步：头脑风暴（brainstorm）需求，规划（plan）实现，执行（work）计划，简化（simplify）所写代码，评审（review）结果，然后复合（compound）所学——并带着更好的上下文再次循环。

技能 用途
/ce-brainstorm 通过交互式问答梳理特性或问题，在规划之前先产出一份仅含需求的统一计划
/ce-plan 将特性想法或仅含需求的计划，丰富为可实施的实现规划
/ce-work 通过原生或合格的跨模型作者来执行可实施的计划，同时保留宿主端的验证、提交与发布
/ce-simplify-code 在评审之前，对刚刚写好的代码进行清晰度与可复用性方面的打磨
/ce-code-review 在合并前对照计划进行仅报告式的多智能体评审，是否就地应用需明确选择
/ce-compound 将所学沉淀到 docs/solutions/，让下一次循环更聪明地开始

每一次循环都会叠加（compound）。/ce-compound 写下的心得，会作为下一次 /ce-brainstorm 与 /ce-plan 的依据（grounding）。头脑风暴让规划更锐利，规划孕育未来的规划，评审发现更多问题，模式被文档化。正是这条回指的箭头，才是闭环的全部意义所在。

一次 ce-compound 运行写入了一条关于环境变量陷阱的心得；18 天后，在一项不相关的工作中，一次 ce-plan 运行找到了这条心得，并将其约束带入了新的规划

运行一次，是教会它。运行两次，它便记住了。

该演示复刻自相隔 18 天的真实一对会话，对其中的名字与路径做了匿名化处理，并将原本六分钟的运行压缩到了约 30 秒。所展示的一切都是这些技能真实具备的行为——源码与替换说明请见 assets/demo。

像 docs/solutions/、docs/plans/ 这类产物目录只是默认值。如果某个项目的 docs/ 是被纳入版本控制的内容，可以通过 docs_root 设置，把所有 CE 产物目录统一搬到同一个相对仓库的根目录下——参见配置文档。

希望同样的知识——团队约定、安全策略、某个技术栈来之不易的硬性规则——能在你组织内的每一个仓库中持续叠加，而不是在每个仓库里都重新摸索一遍？可以将其声明为 Compound Packs：一组带有规定性规则（rule）的文件夹（可以是本地路径，也可以是指向 git 仓库的固定引用 ref），让规划以此为依据、评审以此为准则，每次引用都会回指到对应的规则文件（实验性特性）——参见 Compound Packs。