compound-engineering

Compound Engineering

中文增强版 Claude Code 复合工程插件 — 真实 Agent Teams、分层验证、UI 设计联动，让每一个工程单元都比上一个更容易。

📖 在线文档 | 🔄 更新日志 | 🤝 贡献指南

---

设计哲学

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

复合工程反转了技术债务的积累方向。80% 在规划和审查，20% 在执行：

• 写代码前充分规划，审查以发现问题并沉淀经验
• 将知识编码，使其可复用，保持高质量让未来改动更容易

---

工作流

Resume → 0: Ideate/Ideas → 1: Brainstorm → 2: Plan → 3: Work → 4: Review → 5: Compound → Repeat

命令一览

#	命令	一句话	常用参数
—	/ce:resume	回来了，告诉我现在啥状态	—
0	/ce:ideate	不知道做什么，AI 帮我想方向	—
0.5	/ce:ideas	管理想法停车场，帮我挑一个开始做	—
1	/ce:brainstorm	知道大概要做什么，帮我想清楚	[P] [P+] [C] [G] [R]
2	/ce:plan	想清楚了，拆成可执行的步骤	[T]
3	/ce:work	按计划动手干	[T] [T+] [V] [V+] [R]
4	/ce:review	干完了，帮我审查代码	[C] [G] [T]
5	/ce:compound	审完了，把经验记下来	—

ideate = 让 AI 分析项目现状，生成改进方向建议（输出写入 IDEAS.md） ideas = 管理你已有的想法（无参数=选一个开始做，有参数=加新想法）

不同场景该怎么走

你的状态是什么？
│
├── 刚打开项目，不记得上次干到哪了
│   └── /ce:resume → 看完摘要后选下一步
│
├── 不知道做什么，想找方向
│   ├── 完全没想法 → /ce:ideate → 生成建议到 IDEAS.md
│   └── 之前记了一些 → /ce:ideas → 选一个
│       └── 选好后 → brainstorm → plan → work → review
│
├── 知道要做什么功能
│   └── /ce:brainstorm 我要做XXX → plan → work → review
│
├── 需求已经很清楚，不需要讨论
│   └── /ce:plan 做XXX功能 → work → review
│
├── 修 Bug
│   ├── 简单 bug → 直接改 → /ce:review
│   └── 复杂 bug → brainstorm 分析 → plan → work → review
│
├── 代码写完了，要审查
│   └── /ce:review [C]
│
└── 刚解决了一个有价值的问题
    └── /ce:compound

工具命令

命令	用途
/ce:doctor	健康检查：检测 CLI、MCP、认证状态（skill 入口）
/ce:pr	创建 PR 并询问是否合并（skill 入口）
/ce:sync-upstream	检测上游仓库更新（skill 入口）

交互式工作流可视化

→ 打开交互式工作流图 — 点击每个阶段，展开参数详情 + 使用示例

---

安装

Claude Code（推荐）

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

本地开发

claude --plugin-dir "/path/to/compound-engineering/plugins/compound-engineering"

Codex / Gemini

CLI 转换命令依赖 Bun。发布 @jerry-jian/compound-plugin 前，先使用已发布的上游 CLI 包并显式指向本公共仓库：

# Windows PowerShell
$env:COMPOUND_PLUGIN_GITHUB_SOURCE="https://github.com/Jerrylalala/compound-engineering"
bunx @every-env/compound-plugin install compound-engineering --to codex --includeSkills

# macOS/Linux
COMPOUND_PLUGIN_GITHUB_SOURCE=https://github.com/Jerrylalala/compound-engineering \
  bunx @every-env/compound-plugin install compound-engineering --to gemini --output .

当前 npm 上已发布的是 @every-env/compound-plugin。@jerry-jian/compound-plugin 发布前，请使用上面的环境变量方式指向本公共仓库。

---

主要特性

[T] 真实 Agent Teams（Claude Code 原生）

ce:work [T] 使用 Claude Code 原生 Agent Teams，不是角色扮演：

• TeamCreate 创建命名团队（时间戳命名，防碰撞）
• 独立 context window 的 verifier teammate，不受执行上下文污染
• SendMessage 实时通信，每 Unit 完成后触发验证
• TeamDelete 收尾清理，无资源泄漏

[V] 四层自验证

ce:work [V] 按任务类型自动选择验证层，任务完成必须通过全部激活层：

Layer	内容	触发条件
-1.5	环境指纹：自动检测启动命令 + 测试命令（npm/pytest/cargo/go test）	V/V+ 启用时
0	CLI 构建/语法检查（3 次修复循环）	始终
1	API / 数据库验证	后端变更
2	多路由验证：浏览器 UI + TEST_COMMAND + CLI + API + 设计图对比	按项目类型自动选择
3	独立验收确认	始终

[V+] 额外支持零配置 Electron 桌面应用。Layer 2 自动检测项目类型：前端跑 Playwright，后端跑 TEST_COMMAND + curl，CLI 跑参数验证，有设计图时自动对比。失败后最多 3 轮自动修复（诊断修复 → 缩小范围 → 仅诊断报告）。

[P] 派对模式 + 自动收敛

ce:brainstorm [P] 显式启动 party-mode，用 3 个核心视角快速验证；[P+] 启动 12-14 个视角深度发散。两种模式都会保留 emoji + 角色名 + 相互质疑/补充的讨论体验，并在退出后自动触发探索者+挑战者结构化收敛。

Party Mode 结果会进入 requirements 文档：P1-P4 优先级、共识/分歧/风险、复用机会，以及 Reuse / Build Boundary（哪些复用成熟能力、哪些只写胶水代码、哪些必须自研）。

Codex / Gemini 双重审查 + Claude 裁决

/ce:review [C][G] 同时调用 Codex 和 Gemini 进行交叉验证，双方共同发现的问题优先级自动提升。

Claude 收到外部 AI 审核结果后，会先出裁决表（✅ 认同 / ⚠️ 调整实施 / ❌ 不适用）供用户确认，再动手修复。Claude 是最终裁判，不照单全收——外部 AI 只看局部，Claude 掌握全局上下文。

🎨 UI 设计联动（Pencil MCP + Figma）

本插件内置 UI 设计工作流，支持从设计到实现的完整链路：

• Pencil MCP：在 AI 会话中直接读写 .pen 设计文件，生成/修改设计稿，无需切换工具
• figma-design-sync：自动对比 Figma 设计图与实现截图，发现视觉偏差，迭代修复
• frontend-design skill：生成真实质感的 Web UI（非 AI 模板堆砌），支持响应式、深浅色
• ce:work Figma 同步：执行阶段自动检查 UI 实现是否与设计图匹配

Pencil 设计 → frontend-design 生成实现 → figma-design-sync 对比验证 → 迭代修复

→ Pencil MCP 完整设计联动文档（工具列表 · 工作流 · 使用示例）

---

文档