最近 GitHub 趋势榜上出了个有意思的项目：EveryInc/compound-engineering-plugin。一天涨了 250 多个星，总星数快到 19000。
我花了一下午装上试了试，说说感受。
先说问题
用 Claude Code 写代码有个普遍的毛病——上来就干。你丢一句"给我加个重试机制"，它哗哗开始改代码，改完你发现：逻辑跟你想的不一样，边界情况没考虑，测试也没跑。
回头一看，问题出在哪？没想清楚就动手了。
Compound Engineering（复合工程）的思路是反过来：80% 的时间花在规划和审查上，20% 才是写代码。听起来慢，但实际每个迭代积累下来的经验会让后续工作越来越快。
Compound Engineering 是什么
这是 Every 公司提出的一套开发方法论，配套做了一个 Claude Code 插件。核心想法很朴素：
传统开发越写越慢。每加一个功能，复杂度增加一点，下次改动就难一点。代码库膨胀，上下文变得难以把握，新人接手更是一头雾水。
Compound Engineering 试图反过来——每次工程工作让后续工作更简单。怎么做到？靠五个环节形成闭环：
第五步最关键。每次写完代码，你得把踩过的坑、发现的模式记录下来，下次 Agent 就不用从头学。
安装
插件支持 Claude Code、Codex、Cursor 三个平台。安装方式不太一样。
Claude Code（推荐）：
# 注册市场源
/plugin marketplace add EveryInc/compound-engineering-plugin
# 安装插件
/plugin install compound-engineering
装完重启 Claude Code，输入 /ce-setup 初始化项目配置。
Codex：
Codex 的安装分三步，稍微麻烦一点：
# 1. 注册市场源
codex plugin marketplace add EveryInc/compound-engineering-plugin
# 2. 安装 Agent（Codex 目前不能自动注册自定义 Agent）
bunx @every-env/compound-plugin install compound-engineering –to codex
# 3. 在 Codex 里打开 /plugins 界面手动安装
三步缺一不可。第二步装的是审查、调研类 Agent，跳过会导致 /ce-code-review 之类的命令报找不到 Agent。
Cursor：
在 Agent 聊天里输入：
/add-plugin compound-engineering
或者在插件市场搜 "compound engineering" 安装。
核心命令速查
插件一共有 37 个 Skill 和 51 个 Agent，但日常用到的就下面这几个：
| /ce-brainstorm | 交互式问答，理清需求，输出需求文档 |
| /ce-plan | 把需求文档转成实施方案 |
| /ce-work | 按计划执行开发，带任务追踪 |
| /ce-code-review | 多 Agent 代码审查 |
| /ce-compound | 把这次开发学到的东西记下来 |
| /ce-debug | 系统化排查 bug：复现 → 定位 → 修复 |
| /ce-strategy | 写项目策略文档（STRATEGY.md） |
| /ce-ideate | 大方向构思，比 brainstorm 更上层 |
| /ce-product-pulse | 生成产品运行报告 |
实际工作流演示
拿一个真实场景来走一遍：给后台任务加安全重试机制。
第一步：脑暴需求
/ce-brainstorm "后台任务重试经常出现重复执行，需要加幂等性保护"
Agent 不会直接开写，而是开始问你问题：
- 哪些任务需要重试？全部还是特定类型？
- 现在的重试策略是什么？固定间隔还是指数退避？
- 重复执行会造成什么后果？扣款重复？消息重发？
- 有没有现成的幂等键可以用？
一轮问答下来，Agent 生成一份需求文档保存到 docs/brainstorms/ 目录。
第二步：制定计划
/ce-plan docs/brainstorms/background-job-retry-safety-requirements.md
Agent 读完需求文档，拆分成具体任务：
任务 1: 给 Job 基类加 idempotency_key 字段
任务 2: 实现幂等检查中间件（Redis SETNX）
任务 3: 修改重试调度器，执行前先查幂等键
任务 4: 给支付相关 Job 加集成测试
任务 5: 更新监控面板，添加重复执行告警
计划文档也存到文件里，方便后续 review。
第三步：执行
/ce-work
Agent 按照计划一个一个任务来，用 worktree 隔离开发。做完一个标记完成，做下一个。中途有问题会停下来问你。
第四步：代码审查
/ce-code-review
这步是多 Agent 协作。一个 Agent 检查代码逻辑，另一个查安全问题，还有一个看性能。审查结果汇总后给你一份报告。
我实测的时候，它指出了一个问题：我的幂等键过期时间设了 24 小时，但有些定时任务的间隔是 25 小时，可能导致同一任务下次执行时上一轮的幂等键已经过期。这种边界情况人工 review 很容易漏掉。
第五步：沉淀
/ce-compound
Agent 把这次开发中的教训写成笔记：
- Redis SETNX 做幂等检查时，过期时间要大于任务最大执行间隔
- 支付类 Job 的集成测试必须覆盖"重试时前一次已成功"的场景
- worktree 分支命名建议带日期前缀，方便清理
这些笔记会影响后续的 brainstorm 和 plan。下次有人做类似功能，Agent 已经知道这些坑了。
几个实用的附加命令
调试专用：
/ce-debug "结算 webhook 偶尔会创建重复发票"
Agent 会系统化地排查：先复现问题，再逐层追踪调用链，最后定位根因。比你直接说"帮我修这个 bug"靠谱得多，因为它会先确认自己能稳定复现。
产品脉搏：
/ce-product-pulse –window 7d
生成最近 7 天的产品运行报告，包括使用量、报错率、性能趋势。报告存到 docs/pulse-reports/ 目录，时间长了可以回头看趋势。
踩坑记录
装了两天，踩了几个坑，记一下：
1. Codex 安装顺序不能乱
必须先 marketplace add，再 bunx install，最后 TUI 安装。我第一次跳过了第二步，结果 /ce-code-review 直接报错说找不到 review agent。
2. 非默认 Profile 需要统一 CODEX_HOME
如果你 Codex 用了多个 Profile，安装时每一步都要带同一个 CODEX_HOME 环境变量：
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
不然就装到默认 Profile 里了，你切到 work Profile 发现啥也没有。
3. /ce-setup 别跳过
第一次在项目里用的时候一定要跑 /ce-setup。它会检查环境、装缺失的依赖、初始化项目配置。我一开始嫌麻烦跳过了，结果 /ce-work 的 worktree 功能没法正常用。
4. 文档积累需要时间
Compound 的核心优势在"积累"。用了一两次感觉跟普通 Agent 没太大区别，连续用两周以后才开始体会到好处——Agent 的 brainstorm 问题变得更精准了，plan 也更贴合项目实际情况。
和直接用 Claude Code 有什么区别
坦白说，如果你的需求就是"快速写一段代码"，这个插件反而会拖慢你。brainstorm 一轮，plan 一轮，review 一轮，简单功能搞得很重。
但如果你在做中大型项目，或者团队多人协作，Compound Engineering 的价值就体现出来了。需求文档、实施计划、审查报告、经验笔记——这些东西都自动沉淀成文件，新人接手的时候直接看 docs/ 目录就能理解项目脉络。
我个人觉得最有用的是 /ce-compound 这一步。写代码的时候学到的东西，不写下来过两周就忘了。Agent 帮你记，下次遇到类似问题它自己就知道怎么处理。
项目信息
- GitHub：https://github.com/EveryInc/compound-engineering-plugin
- 安装方式：Claude Code / Codex / Cursor 插件市场
- 开源协议：查看仓库 LICENSE
- 规模：37 个 Skill，51 个 Agent
- npm 包：@every-env/compound-plugin
感兴趣的可以先在一个小项目上试试，跑通一个完整的 brainstorm → plan → work → review → compound 循环，感受一下"先想后做"的开发节奏。
