本文分析
ce-plan技能的实现架构，包含 UML 流程图与泳道图，帮助你理解一个工业级 AI 规划技能的设计思想。
本文基于compound-engineering插件 v2.x 源码分析，所涉及的文件路径为plugins/compound-engineering/skills/ce-plan/及其references/目录。
1. 概述：ce-plan 在 ce-* 生态中的定位
ce-plan 是 compound-engineering 插件生态中的核心技能之一，与 ce-brainstorm 和 ce-work 形成完整的开发工作流链路：
1 | ce-brainstorm ──▶ ce-plan ──▶ ce-work |
- ce-brainstorm: 定义产品需求（WHAT），产出
docs/brainstorms/*-requirements.md - ce-plan: 产出技术实现计划（HOW），产出
docs/plans/*-plan.md - ce-work: 按计划逐步执行实现
ce-plan 的独特价值在于：它是从模糊需求到可执行计划的结构化桥梁，而不仅仅是代码生成器。它的核心产出是一份包含实现单元、测试场景、依赖关系和风险分析的结构化计划文档，而非实现代码本身。
2. 核心架构总览
ce-plan 采用 6 阶段流水线架构，每个阶段有明确的输入、输出和门禁条件：
3. 泳道图：多角色交互流程
ce-plan 涉及四个核心参与者：用户(User)、主技能(ce-plan)、子代理(Sub-agents) 和 外部资源(External Resources)。以下是完整交互泳道图：
4. Phase 0 详细流程图：入口路由决策
Phase 0 是最复杂的入口阶段，包含 7 个子步骤和多个路由分支：
5. 深化工作流泳道图：信心检查与目标研究
深化工作流（Phase 5.3）是 ce-plan 最精密的子系统之一。它采用 评分-派发-合成 的三段式架构，有自动和交互两种模式：
6. 综合摘要机制：三桶结构
综合摘要是 ce-plan 的范围安全网——在昂贵的研究投入之前（单飞模式）或计划写入之前（头脑风暴来源）捕获理解偏差。
综合摘要结构纪律
综合摘要的核心设计约束：
| 规则 | 说明 |
|---|---|
| 行文在综合摘要内部 | prose summary 必须在三个桶之前，不能在综合摘要之上单独成块 |
| 禁止计划正文内容 | 无文件路径、无代码形态、无确切错误消息——那是 Phase 5.2 的工作 |
| 决策级粒度 | Inferred 条目用户无需读代码即可肯定/拒绝 |
| 修订 ≠ 确认 | 每次修订后必须重新呈现并等待显式确认才能写入计划 |
| 软截断 | 同一条目被修订两次后触发阻塞问题：继续 vs 重定向 |
7. 计划文档结构：模板引擎
ce-plan 产出的计划文档采用严格的模板结构，根据深度层级（轻量/标准/深度）裁剪：
8. 子代理派发架构
ce-plan 大量依赖子代理进行并行研究。以下展示子代理在各阶段的派发决策树：
代理派发规则
| 阶段 | 代理 | 触发条件 | 模式 |
|---|---|---|---|
| 1.1 | ce-repo-research-analyst | 始终运行 | 并行 |
| 1.1 | ce-learnings-researcher | 始终运行 | 并行 |
| 1.1 | ce-slack-researcher | 用户明确要求 + 工具可用 | 并行 |
| 1.3 | ce-best-practices-researcher | 1.2 决定需要外部研究 | 并行 |
| 1.3 | ce-framework-docs-researcher | 1.2 决定需要外部研究 | 并行 |
| 1.5 | ce-spec-flow-analyzer | 标准/深度计划 | 单独 |
| 5.3 | 多种深化代理 | 按部分-代理映射表 | 并行（≤8个） |
| 5.3.8 | ce-doc-review | 始终运行（headless） | 单独 |
9. 关键设计决策分析
9.1 规划与执行的严格分离
ce-plan 最核心的设计原则是永不编码。整个技能从 Phase 0 到 Phase 5 只产出计划文档，不运行测试、不修改代码。这带来几个关键收益：
- 可审查性：计划可以作为 PR 审查的一部分独立评估
- 可恢复性：计划是磁盘上的持久文件，会话中断后可继续
- 可追溯性：每个实现单元（U-ID）保持稳定，ce-work 可以精确引用
9.2 U-ID 稳定性规则
实现单元使用永不重新编号的 U-ID：
1 | 重排序：U1, U3, U5 在新顺序中保持不变（不重新编号为 U1, U2, U3） |
这确保了 ce-work 的阻塞项和验证引用在计划编辑中不被破坏。
9.3 双重质量门禁
ce-plan 有两道独立的质量检查：
| 门禁 | 工具 | 关注点 |
|---|---|---|
| 信心检查 (5.3) | 深化子代理 | 理由牢固性、顺序、风险处理、系统级思考 |
| 文档审查 (5.3.8) | ce-doc-review | 连贯性、可行性、范围对齐、角色特定问题 |
两者互补——信心检查加强内容质量，文档审查检查结构质量。
9.4 交互模式与无头模式双轨
ce-plan 在交互和无头（管道/CI）两种模式下都能正确运行：
| 特性 | 交互模式 | 无头模式 |
|---|---|---|
| 综合摘要确认 | 呈现并等待用户 | 撰写但跳过确认 |
| Inferred 赌注 | 用户纠正后进入 Key Technical Decisions | 进入 ## Assumptions 供下游审查 |
| 深化模式 | 可选交互模式（逐代理审查） | 强制自动模式 |
| 生成后菜单 | 完整 4-5 选项 | 跳过，返回控制给调用者 |
10. 总结
ce-plan 是一个精心设计的 AI 辅助规划引擎，其架构亮点包括：
- 6 阶段流水线 将模糊需求逐步精化为结构化计划
- 并行子代理派发 最大化研究效率，避免上下文污染
- 三桶综合摘要机制 在昂贵操作前捕获理解偏差
- 确定性代理映射 将信心差距精确路由到专业代理
- U-ID 稳定性 使多技能协作（ce-work 引用 ce-plan 产出）成为可能
- 交互/无头双模式 同时支持人工协作和 CI 管道
这些设计使 ce-plan 不仅仅是一个”写计划”的技能，而是一个从需求到执行的关键路径上的工程化门禁。
本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。
