复合工程

一个插件市场，主打 Compound Engineering 插件 —— 由 AI 技能与智能体组成的工具集，旨在让每一项工程任务都比上一项更加轻松。

理念

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

传统开发往往会积累技术债务。每增加一个功能，复杂性就会提升。随着时间的推移，代码库会变得越来越难以维护。

而复合工程则颠覆了这一模式。它将 80% 的时间用于规划和评审，仅 20% 用于执行：

• 在编写代码之前进行充分的规划
• 通过评审发现并解决问题，同时总结经验教训
• 将知识体系化，以便重复利用
• 保持高质量的代码，使未来的改动更加容易

了解更多

• 完整组件参考 —— 所有智能体、命令和技能
• 复合工程：Every 如何使用智能体进行编码
• 复合工程背后的故事

工作流程

头脑风暴 -> 计划 -> 执行 -> 评审 -> 复合 -> 循环
    ^
  构思（可选——当你需要创意时）

命令	目的
/ce:ideate	通过发散式构思和对抗性筛选，发现具有高影响力的项目改进方案
/ce:brainstorm	在规划前探索需求和方案
/ce:plan	将功能想法转化为详细的实施计划
/ce:work	使用工作树和任务跟踪来执行计划
/ce:review	合并前的多智能体代码评审
/ce:compound	记录经验教训，以简化未来的工作

/ce:brainstorm 是主要入口——它通过交互式问答将想法提炼为需求计划，并在不需要仪式感时自动跳过。/ce:plan 则可以接受来自头脑风暴的需求文档或详细的想法，并将其精炼成智能体（或人类）可以直接执行的技术计划。

/ce:ideate 使用频率较低，但可以显著提升效率——它会根据你的代码库主动提出优秀的改进建议，并可根据你的需求进行调整。

每个循环都会不断累积：头脑风暴使计划更加清晰，计划反过来指导未来的计划，评审能够发现更多问题，而模式也会被记录下来。

---

安装

Claude Code

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

Cursor

/add-plugin compound-engineering

OpenCode、Codex、Droid、Pi、Gemini、Copilot、Kiro、Windsurf、OpenClaw 和 Qwen（实验性）

本仓库包含一个基于 Bun/TypeScript 的 CLI，可将 Claude Code 插件转换为 OpenCode、Codex、Factory Droid、Pi、Gemini CLI、GitHub Copilot、Kiro CLI、Windsurf、OpenClaw 以及 Qwen Code 格式。

# 将 compound-engineering 插件转换为 OpenCode 格式
bunx @every-env/compound-plugin install compound-engineering --to opencode

# 转换为 Codex 格式
bunx @every-env/compound-plugin install compound-engineering --to codex

# 转换为 Factory Droid 格式
bunx @every-env/compound-plugin install compound-engineering --to droid

# 转换为 Pi 格式
bunx @every-env/compound-plugin install compound-engineering --to pi

# 转换为 Gemini CLI 格式
bunx @every-env/compound-plugin install compound-engineering --to gemini

# 转换为 GitHub Copilot 格式
bunx @every-env/compound-plugin install compound-engineering --to copilot

# 转换为 Kiro CLI 格式
bunx @every-env/compound-plugin install compound-engineering --to kiro

# 转换为 OpenClaw 格式
bunx @every-env/compound-plugin install compound-engineering --to openclaw

# 转换为 Windsurf 格式（默认全局范围）
bunx @every-env/compound-plugin install compound-engineering --to windsurf

# 转换为 Windsurf 工作区范围
bunx @every-env/compound-plugin install compound-engineering --to windsurf --scope workspace

# 转换为 Qwen Code 格式
bunx @every-env/compound-plugin install compound-engineering --to qwen

# 自动检测已安装的工具，并全部安装
bunx @every-env/compound-plugin install compound-engineering --to all

各目标输出格式详情

目标	输出路径	备注
opencode	~/.config/opencode/	命令以 .md 文件形式存在；opencode.json MCP 配置深度合并；覆盖前会制作备份
codex	~/.codex/prompts + ~/.codex/skills	Claude 命令变为提示词与技能对；标准的 ce:* 工作流技能也会添加提示词包装；废弃的 workflows:* 别名将被省略
droid	~/.factory/	工具名称映射（Bash->Execute, Write->Create）；去除命名空间前缀
pi	~/.pi/agent/	提示词、技能、扩展以及用于 MCPorter 互操作性的 mcporter.json
gemini	.gemini/	来自智能体的技能；命令以 .toml 文件形式存在；带命名空间的命令会变成目录（workflows:plan -> commands/workflows/plan.toml）
copilot	.github/	智能体以带有 Copilot 前言的 .agent.md 文件形式存在；MCP 环境变量前加 COPILOT_MCP_ 前缀
kiro	.kiro/	智能体以 JSON 配置文件和提示词 .md 文件的形式存在；仅支持 stdio MCP 服务器
openclaw	~/.openclaw/extensions/<plugin>/	入口 TypeScript 技能文件；用于 MCP 服务器的 openclaw-extension.json
windsurf	~/.codeium/windsurf/（全局）或 .windsurf/（工作区）	智能体成为技能；命令变为扁平的工作流；mcp_config.json 被合并
qwen	~/.qwen/extensions/<plugin>/	智能体以 .yaml 文件形式存在；环境变量中的占位符会被提取为设置；嵌套命令使用冒号分隔

所有目标平台均为实验性，随着格式的演进可能会发生变化。

---

本地开发

从本地克隆仓库

适用于活跃开发——对插件源码的修改会立即生效。

Claude Code —— 添加一个 shell 别名，使你的本地副本与常规插件同时加载：

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

运行 cce 而不是 claude 来测试你的更改。你的生产环境将不受影响。

Codex 及其他目标 —— 对你的本地仓库运行 CLI：

# 从仓库根目录
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 获取缓存的克隆路径：

# 从仓库根目录
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：

# 从仓库根目录
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 仅将路径输出到标准输出（进度信息输出到标准错误），因此可以与 $() 组合使用。

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}"
}

用法：

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

---

同步个人配置

将您的个人 Claude Code 配置（~/.claude/）同步到其他 AI 编程工具。省略 --target 参数可自动同步到所有检测到的受支持工具：

# 同步到所有检测到的工具（默认）
bunx @every-env/compound-plugin sync

# 将技能和 MCP 服务器同步到 OpenCode
bunx @every-env/compound-plugin sync --target opencode

# 同步到 Codex
bunx @every-env/compound-plugin sync --target codex

# 同步到 Pi
bunx @every-env/compound-plugin sync --target pi

# 同步到 Droid
bunx @every-env/compound-plugin sync --target droid

# 同步到 GitHub Copilot（技能 + MCP 服务器）
bunx @every-env/compound-plugin sync --target copilot

# 同步到 Gemini（技能 + MCP 服务器）
bunx @every-env/compound-plugin sync --target gemini

# 同步到 Windsurf
bunx @every-env/compound-plugin sync --target windsurf

# 同步到 Kiro
bunx @every-env/compound-plugin sync --target kiro

# 同步到 Qwen
bunx @every-env/compound-plugin sync --target qwen

# 同步到 OpenClaw（仅同步技能；MCP 受验证限制）
bunx @every-env/compound-plugin sync --target openclaw

# 同步到所有检测到的工具
bunx @every-env/compound-plugin sync --target all

此操作会同步：

• 个人技能，位于 ~/.claude/skills/（以符号链接形式）
• 个人斜杠命令，位于 ~/.claude/commands/（作为提供商原生的提示、工作流，或在支持的情况下转换为技能）
• MCP 服务器，位于 ~/.claude/settings.json

技能以符号链接形式同步（而非复制），因此在 Claude Code 中的更改会立即反映出来。

支持的同步目标包括：

• opencode
• codex
• pi
• droid
• copilot
• gemini
• windsurf
• kiro
• qwen
• openclaw

注意事项：

• Codex 同步会保留非托管的 config.toml 内容，并且现在还包括远程 MCP 服务器。
• 命令同步会复用各提供商现有的 Claude 命令转换，因此某些目标会收到提示或工作流，而另一些目标则会收到转换后的技能。
• Copilot 同步会将个人技能写入 ~/.copilot/skills/，并将 MCP 配置写入 ~/.copilot/mcp-config.json。
• Gemini 同步会将 MCP 配置写入 ~/.gemini/，并避免镜像 Gemini 已经从 ~/.agents/skills 中发现的技能，从而防止出现重复技能警告。
• Droid、Windsurf、Kiro 和 Qwen 同步会将 MCP 服务器合并到提供商文档中记录的用户配置中。
• OpenClaw 目前仅同步技能。由于该仓库尚未记录明确的用户级 OpenClaw 命令界面，因此跳过个人命令同步；同时，由于当前官方 OpenClaw 文档并未清晰定义 MCP 服务器配置规范，因此也跳过 MCP 同步。

Compound Engineering Plugin 快速上手指南

Compound Engineering 是一款旨在通过 AI 智能体（Agents）和技能（Skills）让工程工作“越做越简单”的插件。它颠覆了传统开发中技术债务累积的模式，强调在规划和审查阶段投入更多精力，将知识固化以便复用，从而确保代码库质量随时间推移而提升。

环境准备

• 系统要求：支持 macOS、Linux 或 Windows (WSL)。
• 前置依赖：
  • 已安装 Node.js (推荐 v18+) 和 Bun (用于运行转换 CLI)。
  • 已安装以下任一 AI 编程工具：
    • Claude Code (首选，原生支持)
    • Cursor
    • 或其他支持插件的工具 (OpenCode, Codex, GitHub Copilot, Windsurf, Qwen Code 等，需通过 CLI 转换安装)。

安装步骤

根据你的开发工具选择对应的安装方式：

1. Claude Code (原生支持)

直接在 Claude Code 中运行以下命令添加并安装插件：

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

2. Cursor

在 Cursor 的聊天窗口或命令面板中输入：

/add-plugin compound-engineering

3. 其他工具 (OpenCode, Copilot, Windsurf, Qwen 等)

对于其他编辑器，需要使用提供的 Bun CLI 将插件转换为对应格式。请确保已安装 bun。

自动检测并安装到所有支持的工具：

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

指定安装到特定工具（示例）：

# 安装到 GitHub Copilot
bunx @every-env/compound-plugin install compound-engineering --to copilot

# 安装到 Windsurf (工作区范围)
bunx @every-env/compound-plugin install compound-engineering --to windsurf --scope workspace

# 安装到 Qwen Code
bunx @every-env/compound-plugin install compound-engineering --to qwen

# 安装到 OpenCode
bunx @every-env/compound-plugin install compound-engineering --to opencode

注意：非 Claude Code 平台的安装功能目前处于实验阶段，格式可能会随平台更新而变化。

基本使用

安装完成后，插件的核心工作流遵循 Brainstorm -> Plan -> Work -> Review -> Compound 循环。

核心命令速查

命令	用途
/ce:brainstorm	(入口) 探索需求和方案，通过互动问答将想法转化为需求计划。若无需复杂流程会自动跳过。
/ce:plan	将需求文档或详细想法转化为可供 AI 或人类执行的技术实施计划。
/ce:work	执行计划，包含工作树 (worktrees) 管理和任务追踪。
/ce:review	在合并代码前进行多智能体代码审查。
/ce:compound	记录本次开发的经验教训，固化知识以降低未来工作难度。
/ce:ideate	(可选) 主动发现代码库中高影响力的改进点。

最简单的使用示例

假设你有一个新功能想法，想要开始开发：

1. 启动构思与规划 在对话框中输入：

   /ce:brainstorm 我想添加一个用户导出功能，支持 CSV 和 JSON 格式
   

   AI 会与你互动，澄清需求，并生成一份详细的需求计划。

2. 生成技术方案 当需求明确后（或者你已有明确想法），输入：

   /ce:plan
   

   AI 将基于上一步的输出或你的描述，生成具体的技术实施步骤。

3. 执行开发 确认计划无误后，输入：

   /ce:work
   

   AI 将开始编写代码、创建文件并执行任务。

4. 审查与沉淀 开发完成后，先进行审查：

   /ce:review
   

   最后，记录本次开发的收获以便未来复用：

   /ce:compound
   

通过不断重复此循环，你的项目知识库将越来越丰富，后续的开发效率也会显著提升。