Plan Builder 是一个用于生成多智能体构建计划的技能，其核心定位是：把“已有研究与构想”与“编排器，开始构建”之间的空白补上。它在生成智能体之前完成必要的思考工作：综合源材料、做出架构决策、把内容映射到组件，并产出一份编排器可立即执行的计划。
一、用途与适用前提 该技能假定采用契约优先的多智能体构建模型：一个编排器并行派发角色智能体；每个角色智能体读取 /contracts/ 中的机器可读契约；qe-agent 通过 qa-report.json 把关构建。若为单智能体或临时性工作，则不适合使用本技能。
二、与其他技能的边界
- Brainstorming：想法模糊时使用，逐个提问澄清意图；若无源材料且仅有模糊想法，应先调用 brainstorming，再带其产出的规格回到本技能。
- Plan Builder（本技能）：综合已知输入生成构建计划；在拥有源材料、明确目标或 brainstorming 规格时适用；最多提 3 个澄清问题，偏向行动。
- Writing-plans：产出 TDD 级实现细节（精确文件路径、测试代码、提交信息），面向单智能体顺序执行。
- Orchestrator：消费本技能产出的计划，负责确定团队规模、编写契约并派发智能体。
- Living-plan：用于维护已有计划，随新报告与工作项持续更新；从源材料首次创建计划用本技能，计划已存在需保持活力时用 living-plan。 典型链路：brainstorming（模糊想法）→ plan-builder（结构化计划）→ orchestrator（智能体团队）。
三、入口判定
- 有 @ 提及文件、附件文档、研究产物、Compass 导出：走路径 A（产物摄取），brainstorming 规格、PRD、需求文档也按产物处理。
- 目标明确但无产物（如“给我做个 X 仪表盘”）：走路径 B（目标驱动）。
- 想法模糊且无产物：转向调用 brainstorming。
- 已有代码库 + 新源材料：走路径 A+（增量变体）。
四、路径 A：产物摄取 当用户提供研究文档、Compass 产物或参考资料并附带构建请求时，按 references/research-extraction.md 执行四步抽取：综合源材料（内容域、自然章节、数据点、隐含功能、体量）；将内容映射到架构（产出源到组件对照表，研究密集型项目先做信息架构再做代码架构）；检查现有代码库（仅路径 A+，遵守既有约定）；与用户确认（简明呈现内容映射与关键决策，至多提 3 个澄清问题）。随后按 references/plan-format.md 产出计划。
五、路径 B：目标驱动（无产物） 请用户说明：要构建什么、面向谁、有哪些约束（技术栈、时间线、现有代码、部署目标），此为一个问题，不要拆成三条消息。若一轮回答后仍模糊，转向 brainstorming 而非继续追问；若目标清晰到足以规划，直接产出计划。
六、行为规则
- 先推理后计划：必须先产出第 1 节“架构推理”，再产出第 2 节“构建计划”。
- 显式暴露歧义：源材料矛盾或决策两可时，在架构推理中写明，避免隐含假设变成集成缺陷。
- 偏向行动：最多 3 个澄清问题，之后先出草稿让用户修正。
- 规模匹配编排器：计划需具体到让编排器能定团队规模、写契约，但不细到剥夺智能体自主性；写组件职责，不写实现伪代码。
- 标注规模：若计划需要超过 6 个并行智能体，建议分阶段（第 1 阶段建核心，第 2 阶段扩展），大规模团队需主动的上下文管理（交接、分阶段派发）。
- 追踪二阶效应：当决策影响超出本次构建范围或时间跨度超过 30 天时，在定稿该部分前应用 references/second-order-effects.md 中的思考方法。
- 尊重既有代码：在既有项目上增量开发时遵循其约定，不因个人偏好提议重写技术栈。
七、交接 计划保存后提示：“Plan saved to docs/plans/YYYY-MM-DD-<name>-plan.md. Ready to build?” 并给出选项：编排式构建（调用 orchestrator 技能派发智能体团队）；单人构建（调用 writing-plans 展开为 TDD 实现步骤）；先审阅。等待用户选择，不得自动调用 orchestrator。
八、反模式与输出 禁止为结构而堆砌阶段；三步足够就写三步。计划默认保存至 docs/plans/YYYY-MM-DD-<project-name>-plan.md，除非用户偏好指定其他位置。参考文档包括 references/plan-format.md（计划文档逐节结构与模板）、references/research-extraction.md（从研究文档中抽取计划的方法）、references/second-order-effects.md（追踪决策下游连锁影响的思考方法）。