中文增强版 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 入口） |
→ 打开交互式工作流图 — 点击每个阶段，展开参数详情 + 使用示例
/plugin marketplace add Jerrylalala/compound-engineering
/plugin install compound-engineeringclaude --plugin-dir "/path/to/compound-engineering/plugins/compound-engineering"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 发布前，请使用上面的环境变量方式指向本公共仓库。
ce:work [T] 使用 Claude Code 原生 Agent Teams，不是角色扮演：
- TeamCreate 创建命名团队（时间戳命名，防碰撞）
- 独立 context window 的 verifier teammate，不受执行上下文污染
- SendMessage 实时通信，每 Unit 完成后触发验证
- TeamDelete 收尾清理，无资源泄漏
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 轮自动修复（诊断修复 → 缩小范围 → 仅诊断报告）。
ce:brainstorm [P] 显式启动 party-mode，用 3 个核心视角快速验证；[P+] 启动 12-14 个视角深度发散。两种模式都会保留 emoji + 角色名 + 相互质疑/补充的讨论体验，并在退出后自动触发探索者+挑战者结构化收敛。
Party Mode 结果会进入 requirements 文档：P1-P4 优先级、共识/分歧/风险、复用机会，以及 Reuse / Build Boundary（哪些复用成熟能力、哪些只写胶水代码、哪些必须自研）。
/ce:review [C][G] 同时调用 Codex 和 Gemini 进行交叉验证，双方共同发现的问题优先级自动提升。
Claude 收到外部 AI 审核结果后，会先出裁决表（✅ 认同 / ⚠️ 调整实施 / ❌ 不适用）供用户确认，再动手修复。Claude 是最终裁判，不照单全收——外部 AI 只看局部，Claude 掌握全局上下文。
本插件内置 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 完整设计联动文档（工具列表 · 工作流 · 使用示例）
| 文档 | 说明 |
|---|---|
| 在线文档 | 完整文档站点（自动更新） |
| 交互式工作流 | 参数可视化，点击展开详情 |
| Pencil MCP 设计联动 | AI 设计工作流 · 工具列表 · 使用示例 |
| 安装指南 | 详细安装步骤 |
| 平台支持矩阵 | Claude Code / Codex / Gemini / OpenCode 支持边界 |
| 核心概念 | Skills vs Agents vs Commands |
| npm 发布清单 | @jerry-jian/compound-plugin 发布前置条件 |
| 更新日志 | 版本历史 |
| 贡献指南 | 公共仓库贡献、验证和 PR 规范 |
| 支持入口 | Bug、功能请求和使用问题 |
| 安全策略 | 私密漏洞披露流程 |
以下对比基于公开文档和代码，力求客观。各工具侧重点不同，无绝对优劣之分。
✅ = 原生支持 ⚡ = 部分支持 / 需配置 — = 不提供
| 项目 | 缩写 | 类型 | 核心定位 |
|---|---|---|---|
| 本项目 (Jerry Fork) | CE | 增强 Fork | 中文 Claude Code 深度工作流，真实 Agent Teams + 分层验证 + UI 设计联动 |
| EveryInc/compound-engineering-plugin | CE-UP | 上游原版 | 跨平台工程哲学框架（Brainstorm→Compound 循环） |
| Superpowers plugin | SP | Skill 套件 | 规范化工程流程的精选 Skill 集合，无命名 Agent |
| oh-my-claudecode | OMCC | Agent 套件 | 角色化命名 Agent（executor/reviewer/tester…） |
| ccg-workflow | CCG | Team 命令 | Team 命令式多代理（team-plan/exec/review…） |
| 能力维度 | CE（本项目） | CE-UP（上游） | SP（Superpowers） | OMCC | CCG |
|---|---|---|---|---|---|
| 需求/范围探索 | ce-brainstorm | ce-brainstorm | brainstorming skill | analyst | — |
| 多视角讨论 | [P] 3 视角 / [P+] 全量 + 自动收敛 | — | — | — | — |
| 规划 | ce-plan | ce-plan | writing-plans skill | planner | /ccg:team-plan |
| 计划审查/挑战 | document-review agents | — | — | — | — |
| 架构/设计评审 | architecture-strategist | — | — | architect | init-architect |
| 调试/根因分析 | systematic-debugging | — | systematic-debugging skill | debugger | — |
| 实现/执行 | ce-work (subagents) | ce-work | executing-plans skill | executor | /ccg:team-exec |
| 代码审查（通用） | ce-review + 51 agents | ce-review | requesting-code-review skill | code-reviewer | /ccg:team-review |
| 专项审查 | 安全/性能/正确性/可维护性等 10+ 专属 agent | 安全/性能等基础 | — | — | — |
| 测试/TDD | test-driven-development | — | TDD skill | test-engineer | — |
| 验证/完成证明 | [T] verifier（独立 context） | — | verification-before-completion skill | verifier | /ccg:team-review |
| 知识沉淀 | ce-compound + learnings-researcher | ce-compound | — | — | — |
| UI 设计联动 | Pencil MCP + figma-design-sync + frontend-design | — | — | — | ui-ux-designer |
| 文档写作 | cn-tech-writer agent | — | — | writer | — |
| 特性 | CE | CE-UP | SP | OMCC | CCG |
|---|---|---|---|---|---|
| 真实 Agent Teams (TeamCreate/SendMessage) | ✅ [T] |
— | — | — | ⚡ 命令式 |
| 独立 verifier context | ✅ | — | — | ⚡ 角色模拟 | ⚡ 命令式 |
| 合约白名单门控 | ✅ .team-contract.md | — | — | — | — |
| 分层自验证（CLI→API→浏览器→验收） | ✅ [V] 四层 |
— | ⚡ 验证 skill | — | — |
| 双模型交叉审查 | ✅ Codex + Gemini [C][G] |
— | — | — | — |
| 历史经验检索 | ✅ [R] docs/solutions/ |
⚡ | — | — | — |
| 浏览器自动化 | ✅ agent-browser + [V+] | — | — | — | — |
| UI 设计联动 | ✅ Pencil MCP + Figma | — | — | — | ⚡ |
| 跨 AI 平台支持 | Claude Code 主支持 + Codex/Gemini/OpenCode 转换 | ✅ 12+ 平台 | Claude Code 专注 | Claude Code 专注 | Claude Code 专注 |
| 中文生态 | ✅ 中英双语 + 在线文档 | 英文 | 英文 | 英文 | 中文 |
| Skill 数量 | 66 skills | 40+ skills | 15 skills | — | — |
| Review Agent 数量 | 51 agents | 40+ agents | — | ~9 agents | — |
| 项目 | 最擅长 | 局限 |
|---|---|---|
| CE（本项目） | 真实 Agent Teams；UI 设计联动；专项审查 agent 最多；中文生态 | Claude Code 是完整体验；其他平台以转换支持为准 |
| CE-UP（上游） | 最清晰的工程哲学；跨平台（12+ AI 工具）；社区最成熟 | 无真实 Agent Teams；无分层验证；英文为主 |
| SP（Superpowers） | 轻量；Skill 设计模式清晰；适合个人开发者快速上手 | 无命名 Agent；无 Agent Teams；覆盖较少 |
| OMCC | 角色化 Agent 设计直观；executor/tester/reviewer 职责清晰 | Agent 协作为角色模拟；无合约机制 |
| CCG | Team 命令式多代理架构；有 UI 设计专属 Agent | 命令较固定；知识沉淀弱 |
- 深度使用 Claude Code / 中文团队 → 本项目 CE（真实 Agent Teams + 分层验证 + UI 设计联动）
- 多 AI 平台（Codex/Gemini/Copilot 混用） → CE-UP 上游（跨平台最佳）
- 轻量快速启动 / 个人开发 → SP（Superpowers）（最简洁）
- 偏好角色化 Agent 分工 → OMCC 或 CCG
本项目 fork 自 compound-engineering-plugin（由 EveryInc 创建，MIT 协议）。
在原版基础上进行了以下扩展：
- 全面中文化（命令提示、文档、注释）
- Claude Code Agent Teams 真实多代理实现（TeamCreate/SendMessage/TeamDelete）
- 四层自验证框架（[V] 参数）
- [P] 派对模式后自动结构化收敛
- Codex / Gemini 双重交叉验证
- Pencil MCP + Figma UI 设计联动
- 本地增强层（
skills-custom/）支持 fork 级扩展
MIT — 详见 LICENSE