我最喜欢的 AI 工程技能：

• 复合工程：https://github.com/EveryInc/compound-engineering-plugin…
• Ryan Singer 的塑形技能：https://github.com/rjs/shaping-skills…
• Matt Pocock 的技能：https://github.com/mattpocock/skills…

我从 Superpowers 切换到了复合工程，因为他们逐渐完善了插件，而且我确信自己仍然只用了其中大约 10% 的功能。

EveryInc/compound-engineering-plugin

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

复合工程

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

人工智能技能和智能体，让每一个工程单元都比上一个更容易。

理念

每一个工程单元都应该让后续单元更容易，而不是更难。

传统开发会积累技术债务。每个功能都会增加复杂性。每个错误修复都会留下一些别人将来需要重新发现的本地知识。代码库变得更大，上下文更难把握，下一次变更变得更慢。

复合工程逆转了这一点。80% 在规划和审查，20% 在执行：

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

关键在于仪式，而在于杠杆效应。好的头脑风暴使计划更清晰。好的计划使执行更精简。好的审查捕捉模式，而不仅仅是错误。好的复合笔记意味着下一个智能体不必从头学习同样的教训。

了解更多

• 完整组件参考 - 所有智能体和技能
• 复合工程：Every 如何与智能体协作编码（https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents）
• 复合工程背后的故事（https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it）

工作流程

/ce-strategy 位于循环的上游——它捕捉产品的目标问题、方法、用户画像、指标，并以一个简短、持久的锚点记录在 STRATEGY.md 中。当存在时，构思、头脑风暴和计划会将其作为基础阅读，从而使战略决策流入功能构思、优先级确定和规格说明。

核心循环是：头脑风暴需求，规划实施，按计划执行，审查结果，将学习复合，然后在更好的上下文中重复。

当你希望智能体在选择一个更大的想法进行头脑风暴之前生成并评估多个想法时，可以在循环之前使用 /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

对于有针对性的错误调查：

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. 安装复合工程智能体（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 安装才能使用复合工程技能。

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

对于非默认的 Codex 配置文件，请对同一个 CODEX_HOME 运行所有与 Codex 相关的步骤。以下示例将复合工程安装到 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 安装才是激活该配置文件的本地复合工程技能的操作。

要从此检出目录进行本地开发，请注册当前工作树并使用本地 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 安装，请在切换前备份过时的复合工程产物：

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

GitHub Copilot

对于 VS Code Copilot Agent 插件：

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 安装，请在切换到本地插件前备份过时的复合工程产物：

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 安装，请在切换到本地插件前备份过时的复合工程产物：

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 安装，请在切换到本地扩展前备份过时的复合工程产物：

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

OpenCode、Pi、Gemini 和 Kiro

此仓库包含一个 Bun/TypeScript 安装程序，可将复合工程插件转换为 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

自定义安装目标会在安装期间运行复合工程旧版清理。要对特定目标手动运行清理：

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 # 仅限已弃用的旧安装

清理操作会将已知的复合工程产物移动到目标根目录下的 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 插件 in