博士级百科全书 · 3.34.0-zh.20261031 · 2026-10-31
compound-engineering-plugin 百科
面向 36 个面向用户的技能、1 个内部技能、跨平台 CLI、编排状态机以及设计理念的完整参考手册 —— 为需要理解、修改或在此插件之上构建的资深从业者而写。
什么是 compound-engineering?
compound-engineering 是一个单源插件,分发到多种 AI Agent 宿主(Claude Code、Codex、Cursor、Gemini、OpenCode、oh-my-pi、Pi、Copilot、Kiro、Droid、Antigravity)。它包含 36 个面向用户的技能 + 1 个内部编写技能 + 一个将源仓库转换为各目标格式的 Bun/TypeScript CLI。
该插件引导 Agent 走完整个工程循环:
compound-engineering 循环。每次发布的变化都可以成为 <root>/solutions/ 下的一条学习;每条学习都会喂给未来的规划与评审。
技能一览
按生命周期中的作用分组:
上游 — 战略、构思、规划
ce-strategy
维护 STRATEGY.md:产品、用户、指标、轨道、边界。
ce-ideate
在头脑风暴前生成有依据的想法;砍掉证据 scout 后成本减半。
ce-brainstorm
模糊想法 → 仅含需求的统一计划;发布副本只投用户点名的发布方。
ce-bakeoff
独立竞争的方案,经评判后综合;ce-plan 与 ce-debug 各按自身条件路由进来。
ce-pov
对某个问题或文档给出有依据的判断;进度更新只说在核对什么、谁在核对。
ce-plan
设计构建方式,包含信心度检查 + 文档评审;审查结果按路径返回。
ce-doc-review
多角色评审计划/规格;简短宣布团队后保持安静,结果走文件不进对话。
ce-prototype
当走错代价高昂时使用的一次性原型;来源引用一路保留到计划与 worker。
中游 — 实现、简化、调试
ce-work
端到端执行一个计划;多 PR 提前构建、按合并顺序落地,计划 ID 不写进产物。
ce-worktree
建立隔离的 git worktree。
ce-simplify-code
5 位评审者并行:复用、质量、效率、注释、测试价值。
ce-debug
五阶段诊断循环,移除既有 bug 形态而非补检查;修复方案先比选(bakeoff),无可修时给下一步动作。
下游 — 提交、发布、监控
ce-commit
本地提交;绝不提交到默认分支;他人工作补 Co-authored-by 尾注。
ce-commit-push-pr
提交、推送、交接给 babysit;UI 变更带前后截图证据。
ce-babysit-pr
守护 PR 至可合并状态;先判断旧 PR 是否还该更新(intake),识别托管栈;GitLab fork 由 mr-snapshot 帧生产者提供同等看护。
ce-resolve-pr-feedback
应用、回复、解决 PR 评审意见;越出 PR 目的的发现按 declined 留给后续,安全/数据丢失类转 needs-human。
ce-code-review
带跨模型同行评审和多深度闸门的代码评审;读仓库 REVIEW.md 评审政策,peer 统一 pinned acpx 路由。
质量与测试
ce-test-browser
为受影响页面编写浏览器测试。
ce-test-xcode
DISABLED
通过 XcodeBuildMCP 在 iOS 模拟器上测试。
ce-dogfood
DISABLED
脱离人工的 diff 范围浏览器 QA;优先内置浏览器,只有两种情况叫人。
ce-polish
基于真实用户反馈打磨 UX;v3.30.5 启用 live mode(riffrec@^2.2.1 npm 装)。
知识与沟通
ce-compound
将已解决的问题沉淀为持久的学习。
ce-compound-refresh
对照当前代码审计学习库;retirement condition 字段与 resolution 模板同步。
ce-handoff
把会话交接给另一个 Agent。
ce-explain
解释「怎么做/为什么」 — 差异、回顾、想法或概念;公开发布需先确认。
ce-riffrec-feedback-analysis
将 Riffrec 录音分析为证据。
ce-noslop
抹掉散文中的 AI 痕迹;保持主张确定性,禁分号代短横线。
ce-promote
DISABLED
起草发布/营销文案。
ce-proof
发布到 Proof 协作编辑器;支持 self-hosted 端点({PROOF_BASE_URL} 占位),非托管基址时跳过 proof_* MCP 工具。
ce-product-pulse
DISABLED
时间窗口内的产品脉搏报告。
运维
ce-optimize
基于度量循环的优化,含基线与评判;执行面三项能力决定状态、等待与实验位置,八条停止标准。
ce-retune
DISABLED
为新模型重新调优语料,先度量;候选选择后做 streak 资格检查。
ce-sweep
DISABLED
清扫反馈源,产出 lfg 可消费的计划。
ce-setup
健康检查 + 搭建 Compound Packs + standards 起草规范与 review 文档;config 模板含 gitlab_token。
顶层编排器
lfg
一站式把请求带到 PR,全程无人值守。通过 6 条路由规划,11 个步骤执行;多 PR 计划按 PR 组栈交付,链式 unit 调用 inline 跑。
ce-skill-work
INTERNAL
skills/** 的编写流程,供维护者使用,不面向终端用户。
架构总览
Source-of-truth 架构。源仓库被转换为每种平台格式。lfg 是唯一的顶层技能,其余都是它的下游。
接下来看哪里
compound-engineering 是什么、由谁维护、做什么、不做什么。
全部 5 个 mode: 令牌、15+ 辅助令牌、状态枚举。
6 条路由、11 步状态机、已定决策摘要、待办交接。
3 种姿态(target、stack-ready、stack-land)、8 步 tick、分支时效规则、settle 判断。
贯穿每个技能的 9 条共性规则。读一次,随时翻阅。
docs_root、双层 yaml、每个 CE 配置项、只读项与可覆盖项。
Bun CLI、每个转换器、每个目标、每个平台清单。
完整 skills/<n>/scripts/ 目录,附参数和状态。
按技能分组的 skills/<n>/references/ 文件清单。
docs/solutions/ 的清单,含分类、标签、摘要。
关于版本
本百科反映插件版本 3.34.0-zh.20261031(市场版本 1.0.3,提交日期 2026-10-31)。插件处于活跃开发中;设计语言和大多数规则是稳定的,但具体令牌拼写与技能名称会演进。设计理念 中的结构性规则与版本无关。