面向 Claude Code/Codex/Cursor 的工程化技能插件,声称让每个工程单元都比上一个更轻松,已支持各主流 IDE 插件市场。
让每一单位工程工作都比上一次更轻松的 AI skills。
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineering
已经安装了 Compound Engineering?Compound Engineering 已迁移到根级原生布局。你必须在更新前刷新 marketplace——请参阅「现有安装」部分。单独运行 /plugin update 会让你停留在旧版本。
在 Cursor Agent chat 中,从插件 marketplace 安装:
/add-plugin compound-engineering
或搜索插件 marketplace 中的 "compound engineering"。
Compound Engineering 尚未列入 Codex 内置插件 marketplace。作为自定义 marketplace 添加:
在 Codex 应用中,从侧边栏打开 Plugins。
在 Codex 应用中,从侧边栏打开 Plugins。
点击 Create 旁的箭头,然后选择 Add marketplace。
点击 Create 旁的箭头,然后选择 Add marketplace。
输入:Field Value Source EveryInc/compound-engineering-plugin Git ref main Sparse paths 留空
点击 Add marketplace。
点击 Add marketplace。
搜索 Compound Engineering,安装 compound-engineering-plugin,然后重启 Codex。
搜索 Compound Engineering,安装 compound-engineering-plugin,然后重启 Codex。
Codex 应用的安装对 Compound Engineering 是自包含的。专业评审员和研究行为作为本地 prompt 资源存在于 skills 内部;不需要单独的 custom-agent 安装步骤。
注册 marketplace,然后安装插件。
使用 Codex 注册 marketplace:codex plugin marketplace add EveryInc/compound-engineering-plugin
使用 Codex 注册 marketplace:
codex plugin marketplace add EveryInc/compound-engineering-plugin
安装插件:codex plugin add compound-engineering@compound-engineering-plugin
你也可以启动 codex,运行 /plugins,找到 Compound Engineering marketplace,选中 compound-engineering 插件,然后选择 Install。安装完成后重启 Codex。
codex plugin add compound-engineering@compound-engineering-plugin
你也可以启动 codex,运行 /plugins,找到 Compound Engineering marketplace,选中 compound-engineering 插件,然后选择 Install。安装完成后重启 Codex。
原生 Codex 插件安装对 Compound Engineering 是自包含的。专业评审员和研究行为作为本地 prompt 资源存在于 skills 内部;不需要单独的 custom-agent 安装步骤。
对于非默认的 Codex profile,所有 Codex 相关步骤都针对同一个 CODEX_HOME 运行。以下示例将 CE 安装到工作 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
marketplace 步骤只是让插件可用;插件安装才是激活该 profile 原生 CE skills 的操作。
如果你之前使用 Bun convert / install --to codex CLI 安装过 Compound Engineering(在原生 Codex 插件支持之前),该流程可能已在你的全局 Codex 指令文件中插入了一个托管块:
<!-- BEGIN COMPOUND CODEX TOOL MAP --> … <!-- END COMPOUND CODEX TOOL MAP -->
位于 $CODEX_HOME/AGENTS.md(默认 ~/.codex/AGENTS.md)。该 Claude 兼容工具映射已废弃——CE skills 在行内命名 Codex 工具——且其中一行错误地告诉 Codex 将 subagent 调度折叠到主线程。原生插件安装不会添加此块。
将此粘贴到 Codex(或其他可以访问你主目录的 agent)中来移除它:
Remove the obsolete Compound Engineering Codex tool-map block from my Codex home AGENTS.md.
1. Check `$CODEX_HOME/AGENTS.md` if CODEX_HOME is set, otherwise `~/.codex/AGENTS.md`. If I use Codex profiles, also check `~/.codex/profiles/*/AGENTS.md`.
2. Look for the exact sentinels `<!-- BEGIN COMPOUND CODEX TOOL MAP -->` and `<!-- END COMPOUND CODEX TOOL MAP -->`.
3. If both are present, delete only the span from the BEGIN line through the END line (inclusive), leaving any other user content untouched. Do not edit project/repo AGENTS.md unless those exact sentinels are present there.
4. If the file is empty after the removal, delete the file.
5. Show a short before/after summary of what you changed (or say the block was already absent). Do not add a replacement tool map.
重新运行 Bun convert/install CLI for Codex 也会剥离该块(如果它仍然存在);它不再插入该块。
其他编辑器或 CLI?Kimi Code CLI、Cline、Grok Build CLI、Devin CLI、GitHub Copilot、Factory Droid、Qwen Code、OpenCode、Pi 和 Antigravity CLI 均已支持——请参阅「更多安装选项」。
每一单位工程工作都应该让后续工作更容易——而不是更难。
调用语法:此 README 使用斜杠技能主机的 /skill-name 示例。在 Codex 中,使用 $skill-name 调用已安装的技能(例如 $ce-plan 和 $lfg);/goal 仍是 Codex 内置命令。
传统开发会积累技术债务。每个功能都增加复杂性。每个 bug 修复都会留下一些本地知识,后续需要有人重新发现。代码库越来越大,上下文越来越难把握,下一次变更也越来越慢。
Compound engineering 反转了这一点。80% 在规划和评审中,20% 在执行中:
在使用基于准备度的计划产物通过 /ce-brainstorm 和 /ce-plan 写代码前进行彻底规划
使用 /ce-code-review 和 /ce-doc-review 进行评审以捕获问题并校准判断
通过 /ce-compound 编纂知识使其可复用
保持高质量以便未来变更更容易
关键不是仪式。关键是杠杆效应。好的头脑风暴让计划更锐利。好的计划让执行更小。好的评审捕获的是模式,而不只是 bug。好的 compound 笔记意味着下一个 agent 不必从零开始学习同样的教训。
技能文档目录
Compound engineering:Every 如何使用 agent 编程
复合工程背后的故事
核心循环是六步:头脑风暴需求、规划实现、按计划工作、简化所写内容、评审结果、然后复合学习——然后用更好的上下文重复。
每个循环都会复合:/ce-compound 编写的学习内容被下一个 /ce-brainstorm 和 /ce-plan 作为基础读取——头脑风暴锐化计划,计划为未来计划提供信息,评审捕获更多问题,模式被记录下来。那条返回箭头就是全部意义所在。
像 docs/solutions/ 和 docs/plans/ 这样的 artifact 文件夹是默认值。如果项目的 docs/ 是被跟踪的内容,可以通过 docs_root 设置将每个 CE artifact 文件夹重定位到一个仓库相对根目录下——请参阅配置。
这些位于循环周围或按需获取——不是每个循环都需要它们。
完整的目录以及每个技能如何链接,请参阅 docs/skills。完整清单如下。
寻找方向——当你还没有具体想法时,先进行构思,然后将最有力的候选带入循环:
/ce-ideate new drawing tools
/ce-ideate surprise me
/ce-ideate open issues # 以你的 tracker 的开放 issue(GitHub、Linear、Jira)为依据构思
/ce-ideate 先做功课(代码库、过去的学习、网络上的先例、可选的你的 issue tracker),然后交给你一组有依据的候选排名,供你带入 /ce-brainstorm。
标准功能循环——将一个粗略想法变成已上线、已评审的代码:
/ce-brainstorm make background job retries safer
/ce-plan
/ce-work
/ce-simplify-code
/ce-code-review
/ce-compound
简化代码——在新的实现工作后使用,或针对那些持续拖慢变更的代码:
/ce-simplify-code
/ce-simplify-code simplify the code in my most-churned file
第一遍在评审前收紧近期的分支变更。针对性的那遍在某个文件持续吸收不相关修复、后续或合并冲突时很有用。
调试 bug——当你从破坏行为而非功能出发时:
/ce-debug the checkout webhook sometimes creates duplicate invoices
/ce-code-review
/ce-compound
自主模式——将一个功能交接给 agent,让它运行整个流程:
/ce-brainstorm describe the feature
/lfg
/lfg 全自动运行循环:它制定计划、执行计划、简化代码、运行代码审查并应用修复、运行浏览器测试、提交代码、推送、打开 PR,然后监控 CI 并修复失败直到变绿。在 /ce-brainstorm 之后启动它,这样它就能基于真实需求而非单行提示来制定计划。它是标准循环的自动驾驶版本——当你想要离开一会儿、回来时已经有一个打开且通过的 PR 时,非常好用。当一个涉及多区域的合格计划仍有未规划的工作时,lfg 也会推荐并说明下一个单独规划的区域;只有当你接受时,它才会为新的会话和单独的计划创建一个 /ce-handoff。
安装完成后,在任意项目中运行 /ce-setup。它会检查仓库本地配置、报告可选的工具能力,并帮助将机器本地的 CE 设置安全地放入 .gitignore。
复合工程插件目前包含 32 个技能和 0 个独立智能体。专业审查、研究和工作流行为作为技能本地的提示资源,位于拥有它们的技能内部。
Claude Code、Cursor 和 Codex 位居榜首。这里的所有内容受到同等支持。
Kimi Code CLI 可以直接从该仓库安装复合工程,因为仓库提供了一个原生的 .kimi-plugin/plugin.json 清单:
/plugins install https://github.com/EveryInc/compound-engineering-plugin
你也可以通过 Kimi 的自定义市场流程浏览它:
/plugins marketplace https://raw.githubusercontent.com/EveryInc/compound-engineering-plugin/main/.kimi-plugin/marketplace.json
安装或更新后,运行 /reload 或启动一个新的 Kimi 会话以加载插件技能。
Cline 从按需加载的 SKILL.md 目录中加载 CE 技能。在 Cline 扩展中启用 Settings -> Features -> Enable Skills,然后全局或按项目链接此仓库的技能:
git clone https://github.com/EveryInc/compound-engineering-plugin
./compound-engineering-plugin/.cline/scripts/install-skills.sh --global
从检出的仓库进行按项目安装:
./compound-engineering-plugin/.cline/scripts/install-skills.sh --project
安装或更新技能后启动一个新的 Cline 任务。参见 .cline/INSTALL.md 了解固定版本、本地开发和卸载步骤。
Grok Build CLI (grok)
xAI 的 Grok Build CLI (grok) 直接从该仓库安装复合工程——仓库根目录是一个有效的 Grok 插件(grok 读取现有的 Claude 兼容清单,仓库也提供了一个原生的 .grok-plugin/plugin.json):
grok plugin install EveryInc/compound-engineering-plugin
这会跟踪仓库;运行 grok plugin update 来拉取最新版本。若要将其作为市场源浏览,仓库提供了一个原生的 .grok-plugin/marketplace.json:
grok plugin marketplace add EveryInc/compound-engineering-plugin
grok plugin install compound-engineering
两条路径都直接跟踪仓库(无提交固定),因此不需要 Bun 安装步骤。添加 --trust 以跳过安装确认。grok 将配置存储在 ~/.grok 下;安装后启动一个新会话以加载技能。
复合工程也已提交至官方 xAI 插件市场;参见 docs/grok-marketplace-submission.md 了解维护者操作手册。
Devin CLI 可以直接从 GitHub 安装复合工程,因为仓库提供了一个原生的 .devin-plugin/plugin.json 清单:
devin plugins install EveryInc/compound-engineering-plugin
验证安装并检查技能:
devin plugins list
devin plugins info compound-engineering
使用 devin plugins update compound-engineering 更新到最新版本。插件在会话启动时加载,因此在安装或更新后启动一个新的 Devin 会话,以便技能显现(以 /compound-engineering:<skill> 斜杠命令的形式)。
部分技能声明了 Devin 未映射的 Claude 风格 allowed-tools 名称(例如 Bash);这些技能仍然可用,但其部分操作会请求权限而非自动批准。参见 docs/specs/devin.md 了解更多详情。
对于 VS Code Copilot Agent 插件:
从 VS Code 命令面板运行 Chat: Install Plugin from Source
仓库使用 EveryInc/compound-engineering-plugin
当 VS Code 显示此仓库中的插件时选择 compound-engineering
对于 Copilot CLI,使用:
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineering@compound-engineering-plugin
从带有 copilot 二进制的 shell 中:
copilot plugin marketplace add EveryInc/compound-engineering-plugin
copilot plugin install compound-engineering@compound-engineering-plugin
Copilot CLI 读取现有的 Claude 兼容插件清单,因此不需要单独的 Bun 安装步骤。
从带有 droid 二进制的 shell 中:
droid plugin marketplace add https://github.com/EveryInc/compound-engineering-plugin
droid plugin install compound-engineering@compound-engineering-plugin
Droid 使用 plugin@marketplace 格式的插件 ID;此处 compound-engineering 是插件名称,compound-engineering-plugin 是市场名称。Droid 安装现有的 Claude Code 兼容插件并自动转换格式,因此不需要 Bun 安装步骤。
qwen extensions install EveryInc/compound-engineering-plugin:compound-engineering
Qwen Code 直接从 GitHub 安装 Claude Code 兼容插件并在安装时转换插件格式,因此不需要 Bun 安装步骤。
将复合工程添加到全局或项目 opencode.json 的插件数组中:
{
"plugin": ["compound-engineering@git+https://github.com/EveryInc/compound-engineering-plugin.git"]
}
更改配置后重启 OpenCode。OpenCode 插件直接注册复合工程技能目录;不需要 Bun 安装程序或生成的技能副本。参见 .opencode/INSTALL.md 了解固定版本示例。
从此仓库将复合工程安装为 Pi 包:
pi install git:github.com/EveryInc/compound-engineering-plugin
CE 工作流的推荐配套工具,用于调度审查者、研究者或实现子智能体:
pi install npm:pi-subagents
用于更丰富的阻塞式问题的推荐配套工具:
pi install npm:pi-ask-user
Antigravity CLI (agy)
Google 已将消费者 Gemini CLI 替换为 Antigravity CLI (agy),它仍在 Gemini 模型上运行。直接从 GitHub 安装复合工程——无需克隆步骤:
agy plugin install https://github.com/EveryInc/compound-engineering-plugin
使用 agy plugin list 验证。仓库根目录是插件包(plugin.json 加 skills/)。
对于本地检出或固定版本:
git clone https://github.com/EveryInc/compound-engineering-plugin
agy plugin install ./compound-engineering-plugin
捆绑的 .agy/ 目录仍然是兼容性入口点(agy plugin install ./compound-engineering-plugin/.agy)。agy 也会从检出的仓库加载 GEMINI.md 工作区上下文。
参见 .agy/INSTALL.md 了解固定版本、本地开发、卸载和旧版 Gemini 导入。
复合工程已迁移到根目录原生、仅技能的结构。现有的市场安装会保留一个缓存的市场快照,该快照仍指向旧的 plugins/compound-engineering 路径,因此仅更新插件会读取那个过时的快照并停留在上一个版本。先刷新缓存的市场,然后更新插件——顺序很重要。
/plugin marketplace update compound-engineering-plugin
/plugin update compound-engineering
codex plugin marketplace upgrade compound-engineering-plugin
codex plugin add compound-engineering@compound-engineering-plugin
没有 codex plugin update 命令;重新运行 add 会从刷新的快照重新安装。对于非默认配置文件,对同一 CODEX_HOME 运行两个命令。
从插件面板刷新市场(如果没有刷新控件,则移除并重新添加 EveryInc/compound-engineering-plugin 市场),然后重新安装 compound-engineering 并重启 Codex。
如果配置了直接路径或 plugins/compound-engineering 下的稀疏路径作为主机,请编辑或重新安装该源以使其指向仓库根目录,且无稀疏路径。
如果之前 Bun 安装的副本仍在遮蔽原生插件技能,请从该仓库的检出中运行当前清理命令:
git clone https://github.com/EveryInc/compound-engineering-plugin.git /tmp/compound-engineering-plugin-cleanup
cd /tmp/compound-engineering-plugin-cleanup
bun install
bun run cleanup --target all
bun install
bun test
bun run release:validate
从你的本地检出中。
对于 active 开发,在你想要测试的 harness 中直接加载此检出。
claude --plugin-dir "$PWD"
cursor-agent --plugin-dir "$PWD"
常规的生产级插件安装,请使用上文 Codex App 或 Codex CLI 说明。下面的工作流仅面向需要在本地检出版或链接 worktree 中加载未发布文件的贡献者。
将当前 worktree 选为活跃的 Codex 开发源:
bun run codex:dev -- local
这会在 $CODEX_HOME/skills/compound-engineering-local(默认为 ~/.codex/skills/compound-engineering-local)创建一个指向该 worktree skills/ 目录的集合符号链接。它会通过 Codex CLI 移除已安装的 Compound Engineering 插件变体,以防止缓存的 marketplace 插件覆盖或重复本地 skills。它不会复制 skills、不会更改检出版、不会拉取 Git、也不会触碰 $CODEX_HOME/skills 下的无关条目。
该链接精确暴露所选 worktree 中的内容,包括已修改和未追踪的 skills。因此常规编辑后无需重新安装,且当前版本的 Codex 会自动检测到直接的 skill 变更。在本地和远程安装模式之间切换时,需启动新会话;如果普通 skill 编辑未生效,请重启 Codex。
使用以下命令检查和切换模式:
bun run codex:dev -- status
bun run codex:dev -- refresh
bun run codex:dev -- remote
bun run codex:dev -- remove
status 报告会呈现 local、remote、mixed、drifted 或 absent 状态,以及链接的检出版、worktree 类型、分支、commit SHA 和脏文件计数。
refresh 是 local 的幂等别名,用于修复意外安装的插件。实时链接已反映文件变更。
remote 会刷新官方 Git marketplace,安装并验证 compound-engineering@compound-engineering-plugin,然后移除本地链接。用它来模拟正式发布后的用户体验。
remove 会移除 Compound Engineering 插件变体和托管链接,保留检出版和非相关的用户 skills 完好无损。
脚本会自动推导仓库路径,因此可以在任意位置的检出版中工作,包括带空格的路径。它会继承活跃的 CODEX_HOME;测试隔离 profile 时在命令中设置 CODEX_HOME。针对同一 CODEX_HOME 运行所有模式,该 CODEX_HOME 即用于启动 Codex。
不要使用 codex plugin marketplace add "$PWD" 进行本地实时开发。它会安装该检出版的缓存副本,因此后续编辑不会生效,需要重新安装插件后才能反映;匹配清单版本也不能证明缓存与 worktree 一致。codex:dev 工作流而是让 Codex 始终链接到当前的 skill 文件。
在 Kimi Code CLI 中:
/plugins install /path/to/compound-engineering-plugin
如需测试本地 marketplace 目录,请传入 catalog 路径:
/plugins marketplace /path/to/compound-engineering-plugin/.kimi-plugin/marketplace.json
/path/to/compound-engineering-plugin/.cline/scripts/install-skills.sh --global
在 Cline 扩展中启用 Settings -> Features -> Enable Skills,然后启动新任务。
devin plugins install /path/to/compound-engineering-plugin
本地安装链接到检出版而非复制,因此 skill 编辑在下一个 Devin 会话中即可生效,无需重新安装。
{
"plugin": ["/path/to/compound-engineering-plugin"]
}
修改 opencode.json 后重启 OpenCode。
pi -e "$PWD"
Antigravity CLI(agy)
agy plugin install "$PWD"
agy plugin validate "$PWD"
或安装打包的 .agy/ 入口:
agy plugin install "$PWD/.agy"
远程安装和固定示例请参见 .agy/INSTALL.md。
OpenCode 和 Pi 使用本仓库的原 生 package/plugin 加载方式。Bun CLI 仍用于仓库开发和转换器维护,而非日常安装。
发布版本由发布自动化管理。常规功能 PR 不应手动提升插件或 marketplace 清单版本。
安装 Compound Engineering 是否需要 Bun?
不需要。Bun 仅用于仓库开发任务和转换器维护。
在哪里查看所有可用 skills?
技能清单在本 README 中,更详细的技能目录在 docs/skills/README.md。每个 skill 的权威运行时规范位于 skills/<skill>/SKANG.md。
发布历史在哪里?
GitHub Releases 是正式的发布说明入口。根目录的 CHANGELOG.md 指向该历史记录。
欢迎贡献。Issue、bug 报告和 Pull Request 都有助于推动这个项目变得更好,我们由衷地感谢——尤其是 bug 报告。
关于预期体验的说明:Compound Engineering 从设计上是有主见的。它由 @kieranklaassen 和 @tmchow 维护,其方向体现了对 AI 辅助工程应该如何运作的特定观点。因此虽然我们欢迎帮助,但无法承诺接受每一项更改——有些提案即使本身是好想法,也不符合该愿景。
欢迎提交 issue 或发送 PR,我们会将推动插件朝正确方向发展的内容合并进来。只是想提前说明,并非所有内容都会最终纳入。