用Claude Code写代码总是翻车?Compound Engineering Plugin 用四步工作流,把AI编程变成了可复用的工程方法。
直到我发现 Compound Engineering Plugin —— EveryInc 官方出品的 AI 编程工作流插件。
用上它之后,我的AI编程成功率从50%提升到了90%。
● ● ●
Compound Engineering 是什么?
简单说:它是一种把AI编程从「聊天模式」变成「工程模式」的方法论。
创始人 Nathan Baschez(Every.to 创始人)发现,直接用AI写代码的问题在于:
「AI就像个聪明但健忘的实习生,你让它干啥它干啥,但从不主动理解上下文。」
所以 EveryInc 设计了 Compound Engineering 四步工作流:
┌─────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐ │ Plan │ → │ Execute │ → │ Review │ → │ Learn │ │ (规划) │ │ (执行) │ │ (审查) │ │ (学习) │ └─────────┘ └──────────┘ └─────────┘ └──────────┘ 80%时间 20%时间 关键节点 持续优化
关键洞察: 80%的工作在 Plan 和 Review,只有20%在 Execute。
这和传统的AI编程(直接让AI写代码)完全相反。
● ● ●
四步工作流详解
第一步:Plan(规划)
传统做法:
「帮我写个用户系统」
Compound Engineering 做法:
先让AI写一份详细的设计文档,包括:
- 功能范围(哪些做,哪些不做)
- 数据模型设计
- API 接口定义
- 错误处理策略
- 测试用例
实际效果:
我上周要写一个「文章收藏」功能。
以前:直接让Claude写代码 → 改了5版才搞定
用 Compound:先让AI写 Plan 文档 → 发现了3个边界情况(重复收藏、取消收藏、收藏上限)→ 代码一次过
Plan 阶段多花10分钟,Execute 阶段省1小时。
第二步:Execute(执行)
关键改变:AI不是自由发挥,而是按Plan执行。
Compound Engineering Plugin 会给 Claude Code 一个「执行上下文」:
基于以下Plan执行: 1. 创建 bookmarks 表(user_id, article_id, created_at) 2. 添加唯一索引(user_id + article_id) 3. 实现 createBookmark() 方法 4. 实现 deleteBookmark() 方法 5. 添加单元测试 不要偏离Plan,如有疑问先暂停。
这样AI就不会「胡思乱想」,也不会漏掉边界情况。
第三步:Review(审查)
这是最牛的一步。
代码写完后,Compound 会:
- 01静态检查:代码规范、潜在bug、性能问题
- 02逻辑验证:是否符合Plan中的设计
- 03测试覆盖:是否写了足够的测试用例
- 04安全扫描:SQL注入、XSS等常见漏洞
实例:
我写的收藏功能,Review 阶段发现:
- ❌ 缺少「用户最多收藏1000篇文章」的限制
- ❌ 删除收藏时没有事务保护
- ❌ 单元测试没有覆盖「重复收藏」场景
这些问题如果在生产环境才发现,修复成本是现在的100倍。
第四步:Learn(学习)
每次编程都是一次学习机会。
Compound 会把这次的经验沉淀下来:
- 哪些边界情况容易漏?
- 哪些设计模式最有效?
- 哪些错误是AI经常犯的?
下次写类似功能时,AI会自动应用这些经验。
复利效应: 用得越久,AI越懂你的 codebase 和你的习惯。
● ● ●
为什么用插件而不是自己Prompt?
你可能会问:「我自己写Prompt也能实现四步工作流啊?」
理论上可以,实际上很难:
| 维度 | 自己写Prompt | Compound Engineering Plugin |
|---|---|---|
| 一致性 | 每次Prompt可能不一样 | 标准化流程,每次一致 |
| 上下文管理 | 容易超出token限制 | 自动管理Plan/Review上下文 |
| 工具集成 | 需要手动调用各种工具 | 内置静态检查、测试、安全扫描 |
| 团队协作 | 只有你自己知道流程 | 整个团队用同一套标准 |
| 持续学习 | 经验无法积累 | 自动沉淀最佳实践 |
最关键是:Instruction Files。
你可以在项目根目录放一个 COMPOUND.md,定义:
- 代码风格规范
- 常用设计模式
- 测试要求
- 安全红线
Claude 会自动读取并遵守。不用每次都口头叮嘱「我们项目用两个空格缩进」。
● ● ●
安装使用(3分钟搞定)
Compound Engineering Plugin 支持多个AI编程工具:
- Claude Code(推荐)
- OpenAI Codex
- Cursor
- GitHub Copilot
Claude Code 安装
# 进入项目目录 cd your-project # 安装 Compound 插件 claude install everyinc/compound-engineering-plugin # 初始化配置文件 claude compound init
会自动创建:
COMPOUND.md # 项目规范 .compound/ ├── plan.md # Plan 模板 ├── review.md # Review 清单 └── lessons/ # 学习记录
使用流程
# 1. 开始新任务,先Plan claude compound plan "实现文章收藏功能" # 2. AI生成Plan文档,你review确认 # 3. 确认后执行 claude compound execute # 4. 代码写完后自动Review claude compound review # 5. 通过后才提交 claude compound commit
● ● ●
真实案例:一个需求的完整流程
需求: 添加「文章收藏」功能
以前的做法(翻车版)
我:帮我写个收藏功能 Claude:(一顿操作)写好了 我:(测试)重复收藏会报错啊 Claude:(改)现在好了 我:(再测)取消收藏后数据没删干净 Claude:(再改)现在应该行了 我:(继续测)卧槽,没做用户权限校验 ... 总耗时:2小时,改了8版
用 Compound Engineering(顺利版)
$ claude compound plan "实现文章收藏功能" 【Plan文档生成】 功能:文章收藏 - 创建 bookmarks 表 - 唯一约束:user_id + article_id - 限制:每个用户最多1000条收藏 - API:POST/DELETE /api/bookmarks - 错误码:409(重复), 404(不存在), 429(超限) 我:确认Plan $ claude compound execute 【按Plan执行,不偏离】 $ claude compound review 【发现问题】 - 警告:事务保护缺失(已自动修复) - 建议:添加收藏数量查询接口 $ claude compound commit 【生成commit:feat: 实现文章收藏功能】 总耗时:30分钟,一次过
● ● ●
写在最后:AI编程的下一个阶段
Compound Engineering 让我意识到:
AI编程不是「让AI替我写代码」,而是「让AI成为我的工程搭档」。
- Plan 阶段:AI是架构师,帮我理清思路
- Execute 阶段:AI是程序员,按规范写代码
- Review 阶段:AI是Code Reviewer,找出问题
- Learn 阶段:AI是知识库,积累经验
这种「人机协作」的模式,才是AI编程的正确打开方式。
参考链接:
- GitHub: https://github.com/EveryInc/compound-engineering-plugin
- 官方文档: https://deepwiki.com/EveryInc/compound-engineering-plugin
- Every.to 介绍: https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents
夜雨聆风