我们刚刚使 Compound Engineering 仓库获得了 20K 星标！https://github.com/EveryInc/compound-engineering-plugin…

EveryInc/compound-engineering-plugin

来源：https://github.com/EveryInc/compound-engineering-plugin

Compound Engineering

构建状态 (https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.yml) npm (https://www.npmjs.com/package/@every-env/compound-plugin)

让每项工程工作都比上一次更轻松的 AI 技能和智能体。

理念

每一项工程工作都应该让后续工作更容易，而不是更难。

传统开发会累积技术债务。每个功能都会增加复杂性。每个 bug 修复都会留下一些后来者需要重新发现的局部知识。代码库越来越大，上下文越来越难以把握，下一次变更也越来越慢。

Compound engineering 扭转了这一局面。80% 花费在规划和评审上，20% 花费在执行上：

• 在编写代码前使用 /ce-brainstorm 和 /ce-plan 进行充分的规划
• 使用 /ce-code-review 和 /ce-doc-review 进行评审以发现问题并校准判断
• 使用 /ce-compound 将知识编码以便复用
• 保持高质量，使未来的变更更容易

重点不在于形式，而在于杠杆效应。好的头脑风暴能让计划更清晰。好的计划能让执行更精简。好的评审能发现问题模式，而不仅仅是 bug。好的复合笔记意味着下一个智能体不必从头学习同样的经验。

了解更多

• 完整组件参考 - 所有智能体和技能
• Compound engineering：Every 如何使用智能体编写代码 (https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents)
• Compound engineering 背后的故事 (https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it)

工作流

/ce-strategy 位于循环的上游——它捕捉产品的目标问题、方法、用户画像、指标，并以 STRATEGY.md 作为短期的持久锚点。/ce-ideate、/ce-brainstorm 和 /ce-plan 在存在时会读取它作为基础，因此策略选择会流入功能概念、优先级排序和规格说明。

核心循环是：集思广益确定需求，规划实现，按计划执行，评审结果，沉淀学习，然后带着更好的上下文重复。

在进入循环之前，如果你希望智能体生成并批判更大的想法，然后再选择其中一个进行头脑风暴，可以使用 /ce-ideate。它会生成一个排序后的创意产物，而不是需求、计划或代码。

/ce-product-pulse 是读取侧的伴侣——一个时间窗口内的报告，展示用户在给定时间窗口（24小时、7天等）内的实际体验和产品表现，保存到 docs/pulse-reports/，使过去的脉搏报告形成可浏览的用户结果时间线。下一次策略更新和下一次头脑风暴将获得真实的信号作为锚点。

每个周期都在复合：头脑风暴使计划更清晰，计划为未来的计划提供信息，评审发现更多问题，模式被记录下来。

快速示例

一个典型的周期从将粗略想法转化为需求文档开始，然后根据该文档进行规划，再将执行交给 /ce-work：

text /ce-brainstorm "让后台作业重试更安全" /ce-plan docs/brainstorms/background-job-retry-safety-requirements.md /ce-work /ce-code-review /ce-compound

针对有针对性的 bug 调查：

text /ce-debug "结账 webhook 有时会创建重复的发票" /ce-code-review /ce-compound

入门指南

安装完成后，在任何项目中运行 /ce-setup。它会检查你的环境，安装缺失的工具，并引导项目配置。

compound-engineering 插件目前提供 37 项技能和 51 个智能体。请参阅完整组件参考获取完整清单。

安装

Claude Code

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

Cursor

在 Cursor Agent 聊天中，从插件市场安装：

text /add-plugin compound-engineering

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

Codex

三个步骤：注册市场，安装智能体集，然后通过 Codex 的 TUI 安装插件。

1. 向 Codex 注册市场：

   bash codex plugin marketplace add EveryInc/compound-engineering-plugin

2. 安装 Compound Engineering 智能体（Codex 的插件规范尚不支持注册自定义智能体）：

   bash bunx @every-env/compound-plugin install compound-engineering --to codex

3. 通过 Codex 的 TUI 安装插件： 启动 codex，运行 /plugins，找到 Compound Engineering 市场，选择 compound-engineering 插件，然后选择 Install。安装完成后重启 Codex。Codex 的 CLI 可以注册市场，但目前没有提供从已添加市场安装插件的插件安装子命令——需要使用 /plugins TUI 安装才能启用 CE 技能。

以上三个步骤都是必需的。市场注册加上 TUI 安装处理技能；Bun 步骤添加了 $ce-code-review、$ce-plan 和 $ce-work 等技能在 Codex 中调用的评审、研究和工作流智能体。如果没有智能体步骤，委托技能会报告缺少智能体。

对于非默认的 Codex 配置文件，所有 Codex 相关步骤需要针对同一个 CODEX_HOME 执行。以下示例将 CE 安装到 work 配置文件中：

bash CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add EveryInc/compound-engineering-plugin CODEX_HOME="$HOME/.codex/profiles/work" bunx @every-env/compound-plugin install compound-engineering --to codex CODEX_HOME="$HOME/.codex/profiles/work" codex

在 Codex 内部，运行 /plugins，选择 Compound Engineering，然后安装 compound-engineering。市场步骤仅使插件可用；TUI 安装才能真正为该配置文件激活原生 CE 技能。

如果要在本地开发中使用此仓库的检出版本，请注册当前工作树并使用本地 CLI：

bash CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add "$PWD" CODEX_HOME="$HOME/.codex/profiles/work" bun run src/index.ts install ./plugins/compound-engineering --to codex CODEX_HOME="$HOME/.codex/profiles/work" codex

注意： 一旦 Codex 的原生插件规范支持自定义智能体，Bun 的智能体步骤将不再需要。只需 TUI 安装即可。

如果你之前使用过仅 Bun 的 Codex 安装方法，在切换前请备份旧的 CE 产物：

bash bunx @every-env/compound-plugin cleanup --target codex

GitHub Copilot

对于 VS Code Copilot Agent Plugins：

1. 从 VS Code 命令面板运行 Chat: Install Plugin from Source
2. 使用 EveryInc/compound-engineering-plugin 作为仓库
3. 当 VS Code 显示此仓库中的插件时，选择 compound-engineering

对于 Copilot CLI，请使用以下命令：

在 Copilot CLI 内部：

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

从包含 copilot 二进制的 shell 中：

bash copilot plugin marketplace add EveryInc/compound-engineering-plugin copilot plugin install compound-engineering@compound-engineering-plugin

Copilot CLI 会读取现有的与 Claude 兼容的插件清单，因此无需额外的 Bun 安装步骤。

如果你之前使用过旧的 Bun Copilot 安装方法，在切换到原生插件前请备份旧的 CE 产物：

bash bunx @every-env/compound-plugin cleanup --target copilot

Factory Droid

从包含 droid 二进制的 shell 中：

bash 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 安装步骤。

如果你之前使用过旧的 Bun Droid 安装方法，在切换到原生插件前请备份旧的 CE 产物：

bash bunx @every-env/compound-plugin cleanup --target droid

Qwen Code

bash qwen extensions install EveryInc/compound-engineering-plugin:compound-engineering

Qwen Code 会直接从 GitHub 安装与 Claude Code 兼容的插件，并在安装过程中转换插件格式，因此无需 Bun 安装步骤。

如果你之前使用过旧的 Bun Qwen 安装方法，在切换到原生扩展前请备份旧的 CE 产物：

bash bunx @every-env/compound-plugin cleanup --target qwen

OpenCode、Pi、Gemini 和 Kiro

此仓库包含一个 Bun/TypeScript 安装程序，可将 Compound Engineering 插件转换为 OpenCode、Pi、Gemini CLI 和 Kiro CLI 的格式。

bash bunx @every-env/compound-plugin install compound-engineering --to opencode bunx @every-env/compound-plugin install compound-engineering --to pi bunx @every-env/compound-plugin install compound-engineering --to gemini bunx @every-env/compound-plugin install compound-engineering --to kiro

Pi 先决条件。 Pi 没有内置的子智能体原语，因此 Pi 安装依赖于 nicobailon/pi-subagents (https://github.com/nicobailon/pi-subagents)（必需），并推荐使用 edlsh/pi-ask-user (https://github.com/edlsh/pi-ask-user) 以获得更丰富的阻塞用户问题功能：

bash pi install npm:pi-subagents # 必需——为调度并行智能体的技能提供 `subagent` 工具 pi install npm:pi-ask-user # 推荐——提供 `ask_user` 工具；当该工具缺失时，技能会回退到聊天中的编号选项

要自动检测自定义安装目标并安装到所有目标：

bash bunx @every-env/compound-plugin install compound-engineering --to all

自定义安装目标在安装时会执行 CE 遗留清理。要手动对特定目标进行清理：

bash bunx @every-env/compound-plugin cleanup --target codex bunx @every-env/compound-plugin cleanup --target opencode bunx @every-env/compound-plugin cleanup --target pi bunx @every-env/compound-plugin cleanup --target gemini bunx @every-env/compound-plugin cleanup --target kiro bunx @every-env/compound-plugin cleanup --target copilot # 仅限旧的 Bun 安装 bunx @every-env/compound-plugin cleanup --target droid # 仅限旧的 Bun 安装 bunx @every-env/compound-plugin cleanup --target qwen # 仅限旧的 Bun 安装 bunx @every-env/compound-plugin cleanup --target windsurf # 仅限已弃用的旧安装

Cleanup 会将已知的 CE 产物移至目标根目录下的 compound-engineering/legacy-backup/ 目录中。

本地开发

bash bun install bun test bun run release:validate

从本地检出

如果你进行积极开发——对插件源文件的编辑会立即生效。

Claude Code——添加一个 shell 别名，让你的本地副本与正常插件一起加载：

bash alias cce='claude --plugin-dir ~/Code/compound-engineering-plugin/plugins/compound-engineering'

运行 cce 代替 claude 来测试你的更改。你的生产安装保持不变。

Codex 和其他目标——对你的检出运行本地 CLI：

``bash

从仓库根目录

bun run src/index.ts install ./plugins/compound-engineering –to codex

其他目标同理

bun run src/index.ts install ./plugins/compound-engineering –to opencode ``

从推送的分支

用于测试他人的分支或你自己工作树中的分支，而无需切换检出。使用 --branch 将分支克隆到确定性的缓存目录。

未推送的本地分支：如果分支仅存在于本地工作树中且尚未推送，请直接将 --plugin-dir 指向工作树路径（例如 claude --plugin-dir /path/to/worktree/plugins/compound-engineering）。

Claude Code——使用 plugin-path 获取缓存克隆路径：

``bash

从仓库根目录

bun run src/index.ts plugin-path compound-engineering –branch feat/new-agents

输出：

claude –plugin-dir ~/.cache/compound-engineering/branches/compound-engineering-feat~new-agents/plugins/compound-engineering

``

缓存路径是确定性的。重新运行会将检出更新到该分支的最新提交。

Codex、OpenCode 和其他目标——将 --branch 传递给 install：

``bash

从仓库根目录

bun run src/index.ts install compound-engineering –to codex –branch feat/new-agents

适用于任何目标

bun run src/index.ts install compound-engineering –to opencode –branch feat/new-agents

结合 –also 用于多个目标

bun run src/index.ts install compound-engineering –to codex –also opencode –branch feat/new-agents ``

这两个功能都使用 COMPOUND_PLUGIN_GITHUB_SOURCE 环境变量来解析仓库，默认为 https://github.com/EveryInc/compound-engineering-plugin。

Shell 别名

添加到 ~/.zshrc 或 ~/.bashrc。所有别名都使用本地 CLI，因此不依赖于 npm 发布。plugin-path 仅将路径输出到标准输出，因此可以与 $() 组合使用。

``bash CE_REPO=~/Code/compound-engineering-plugin

ce-cli() { bun run “CE_REPO/src/index.ts" "@”; }

— 本地检出（积极开发） —

alias cce=‘claude –plugin-dir $CE_REPO/plugins/compound-engineering’

codex-ce() { ce-cli install “CE_REPO/plugins/compound-engineering" --to codex "@” }

— 推送的分支（测试 PR、工作树工作流） —

ccb() { claude –plugin-dir “(ce-cli plugin-path compound-engineering --branch "1”)“ “${@:2}” }

codex-ceb() { ce-cli install compound-engineering –to codex –branch “1" "{@:2}” } ``

用法：

bash cce # 使用本地检出在 Claude Code 中测试 codex-ce # 将本地检出安装到 Codex ccb feat/new-agents # 使用 Claude Code 测试推送的分支 ccb feat/new-agents --verbose # 将额外标志传递给 claude codex-ceb feat/new-agents # 将推送的分支安装到 Codex

Codex 安装会将生成的插件技能隔离在 ~/.codex/skills/compound-engineering/ 下，并且不会向 ~/.agents 写入新文件。当安装程序能够证明旧版 CE 管理的 .agents/skills 符号链接指向 CE 的 Codex 管理存储时，它会删除这些链接，从而防止旧的 Codex 安装覆盖 Copilot 的原生插件安装。

故障排除

Codex 技能正常工作，但评审或研究委托失败

运行智能体安装步骤：

bash bunx @every-env/compound-plugin install compound-engineering --to codex

原生 Codex 插件安装处理技能。Bun 步骤安装这些技能委托的自定义智能体。

Codex 显示过时或重复的 CE 技能

在切换到原生 Codex 插件流程之前，备份旧的 Bun 安装产物：

bash bunx @every-env/compound-plugin cleanup --target codex