Compound Engineering 教程：在 Codex 安装 3.28.1 并跑一轮六步流程
Compound Engineering 把 AI 编码拆成可审阅的步骤，并把每次修改学到的经验写回仓库。当前官方资料是 36 个技能、14 个 agent host。旧页面写的 37 个技能已经过期。
1. 这套插件实际做什么
官方仓库把核心流程定义为六步：
$ce-brainstorm # 澄清需求，形成 requirements-only 计划 $ce-plan # 补成可执行实施计划 $ce-work # 按计划实现并验证 $ce-simplify-code $ce-code-review $ce-compound # 把可复用经验写入 docs/solutions/
ce-compound 不是普通的会话总结。它把经过验证的经验变成项目文档，后续 ce-brainstorm 与 ce-plan 会再次读取。默认产物在 docs/plans/ 和 docs/solutions/；如果仓库的 docs/ 本身是网站内容，可以通过 docs_root 把 CE 产物迁到另一个仓库相对目录。
2. 在 Codex CLI 中安装
Codex CLI 当前有原生 marketplace 路径。运行：
codex plugin marketplace add EveryInc/compound-engineering-plugin codex plugin add compound-engineering@compound-engineering-plugin
安装完成后重启 Codex。也可以在 Codex 内打开 /plugins，进入 Compound Engineering marketplace 后选择安装。marketplace 命令只让插件出现在列表里，第二条 plugin add 才会为该 profile 激活技能。
如果你使用非默认 CODEX_HOME，注册、安装和之后启动 Codex 必须指向同一目录：
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
普通安装不需要 Bun。官方 README 说明，Bun CLI 现在用于仓库开发和转换器维护，不是用户安装插件的前提。
3. 先在小项目里手动跑一轮
进入一个可丢弃或有完整 Git 备份的测试仓库，先运行 $ce-setup。它会报告可选工具能力，在缺失时创建 .compound-engineering/config.yaml，并处理本地 override 的忽略规则。
随后选一个范围小、验收明确的修改，按六步逐项执行。每一步都检查内容：brainstorm 有没有把需求写对，plan 是否指向真实文件，work 是否运行了合适测试，simplify 有没有改变行为，review 的问题是否有证据，compound 写入的经验是否值得未来重复使用。
这样跑通后再考虑 $lfg。官方说明它可以自动选择计划或调试路径，完成实现、简化、审查、修复、经验沉淀和浏览器测试，随后提交；有远端时还可能 push、开 PR 并观察 CI，但不会在没有授权的情况下合并。自动流程越长，越需要先确认宿主权限和仓库规则。
4. 更新时先刷新 marketplace
这是当前最容易踩的坑。插件曾迁移到根目录原生、skills-only 布局，旧安装可能缓存旧 marketplace 路径。官方升级说明明确说，只运行 /plugin update 可能继续留在旧版本；必须先刷新 marketplace，再更新插件。
具体刷新命令随宿主不同。升级前先打开官方 upgrading 文档，按你的 host 操作，重启后再核对技能数量和 release。不要把 Claude Code、Cursor、Codex 的命令混用。
5. 配置、数据与外部调用
官方隐私文档说明，插件包本身没有 telemetry 或 analytics，也不会启动后台服务自动上传仓库内容。但这不代表整个使用过程离线：
- Codex、Claude Code、Cursor 等宿主会按各自配置把 prompt、上下文或代码发送给模型 provider。
- 显式调用 Context7、Proof、图像生成或云上传类技能时，会请求相应外部服务。
- npm、bunx 等安装过程会访问包仓库或 CDN。
因此团队应审查宿主 provider、插件配置和即将调用的技能。包含客户代码、密钥或受监管数据的仓库，要先按组织政策限制网络工具和可发送上下文。
6. 商业化判断
Every 是商业机构，官网还有其他订阅内容，但本项目仓库按 MIT 发布，官方插件安装流程中没有充值、额度分发、订阅转售或付费下载。它提供的可选外部集成可能各有服务费用，这属于宿主或第三方调用成本，不是插件内的销售漏斗。
7. 与 Superpowers 对比
Superpowers 官方仓库也是编码代理的技能方法论，强调技能自动触发、先澄清设计、写实施计划、严格 TDD，再用子代理执行。
Compound Engineering 的区别是六步入口更显式：计划之后还有专门的代码简化与报告式审查，并用 ce-compound 把经验写回 docs/solutions/。希望代理自动遵循固定开发纪律时可先评估 Superpowers；希望团队逐步调用、检查每个产物并经营项目知识库时，Compound Engineering 更直接。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合希望把 AI 编码过程留下可复查计划、审查结论和项目经验的团队，尤其是会反复修改同一代码库的长期项目。第一次不要直接把 /lfg 交给重要分支；先在小任务上逐步执行六个技能，检查生成文档的位置、宿主权限、测试命令和提交行为，再决定是否采用自动流水线。
原教程未展开的系统信息
架构与数据流
仓库根目录是跨宿主插件包，skills/<skill>/SKILL.md 是每个技能的权威运行规范，各 host 通过自己的 manifest 或 marketplace 装载这些技能。ce-setup 在目标仓库创建 .compound-engineering/config.yaml；计划和经验文档默认写到 docs/plans/ 与 docs/solutions/。审查、研究或实现技能可调用宿主提供的子代理或外部模型，但执行、权限和网络行为仍由宿主及所选集成控制。
技术栈和运行条件
语言
Markdown 技能与配置文件，仓库另含用于转换和开发的 TypeScript/Bun CLI
框架
面向多种 AI 编码宿主的 skills-only 插件布局
关键依赖
- 受支持的 AI 编码宿主之一，例如 Codex、Claude Code 或 Cursor
- Git 仓库，用于计划、提交、审查和经验文档
- Codex 使用原生 plugin marketplace；普通安装不需要 Bun
- 部分跨模型审查、文档查询或分享功能依赖可选 provider/集成
运行环境
插件在宿主进程中工作；项目配置为 .compound-engineering/config.yaml
常见问题
Compound Engineering 现在是 36 个还是 37 个技能？
当前官方 README 明确写 36 个技能。旧页面中的 37 已经过期，更新时应以仓库当前 catalog 为准。
为什么只运行 /plugin update 可能没有升级 Compound Engineering？
旧安装可能仍使用缓存的 marketplace 路径。官方要求先刷新 marketplace，再更新插件；顺序错了可能继续停在旧版本。
在 Codex 里应该用 /ce-plan 还是 $ce-plan？
官方 README 用斜杠展示跨宿主示例，但明确说明 Codex 应使用美元前缀，例如 $ce-plan 和 $lfg。
Compound Engineering 会自动上传仓库代码吗？
插件自身没有遥测，也不会运行后台服务自动上传。宿主模型 provider 以及你显式调用的 Context7、Proof、云上传等集成仍可能发送数据。