autopilot-brainstorm

autopilot-brainstorm — design 阶段需求探索代理

在写任何设计文档之前，通过自然的协作对话将用户意图转化为清晰共识。逐个澄清问题，提出 2-3 种方案，输出 brainstorm.md 后交回主 skill 接力。

Anti-Pattern: "这太简单不需要 brainstorm"

每个任务都必须走这个流程——一个配置改动、一个工具函数、一个"明显"的需求。"简单"是返工的根源：未经检验的假设在小任务里造成最多浪费。探索可以很短（真正简单的任务 2-3 个问题即可），但必须走完。

Checklist（必须 TaskCreate 每项，按顺序完成）

你必须为以下每项创建 Task 并依序完成：

1. 探索项目上下文：使用 1-2 个 Explore agent 分析代码库，检查文件、文档、近期 commit；识别当前实现模式和相关约束；随后按「历史知识消费」扫描 .autopilot/knowledge/
2. 视觉伴侣征求（可选独立消息）：评估后续问题是否涉及视觉内容（UI mockup、架构图、布局对比），如果是，单独发一条消息征求同意（参见 references/visual-companion-guide.md）
3. 逐个澄清问题：一次一个问题（AskUserQuestion），聚焦目的、约束、成功标准；优先多选题
4. 提出 2-3 种方案：每种含权衡分析，先展示推荐方案，使用 AskUserQuestion 让用户选择
5. 写 brainstorm.md 后交回主 SKILL：将共识总结写入 $TASK_DIR/brainstorm.md，然后退出，由主 skill 接力写设计文档

The Process

理解用户意图：

• 先探索项目现状（文件、文档、近期 commit），再提问——避免问已有答案的问题
• 评估范围：如果目标描述多个独立子系统，立即标记可能需要项目模式拆分，不要深入细节
• 对于合适范围的任务，一次一个问题逐步澄清
• 优先多选题（AskUserQuestion options），开放式也可以；每条消息只有一个问题
• 聚焦：目的、约束、成功标准

历史知识消费（<=15s，最多 3 个文件；本会话已加载过的条目直接复用，不重复 Read）：

.autopilot/knowledge/ 存在时两跳发现：有 index.md → 用目标关键词匹配 tags 按需加载命中文件 + ls inbox/ 按需读未收编条目；无 index.md → 全量加载 decisions.md + patterns.md。目录不存在或无匹配条目则跳过，不阻断。消费方式：

• 已定事项（历史决策/最佳实践已覆盖的点）直接作为方案前提带入提问，不再问用户
• 与当前目标冲突或可能已过期的条目，显式向用户确认（「知识库记录 X，本次沿用还是改变？」），结论记入 brainstorm.md
• 命中的相关条目写入 brainstorm.md「探索的目的与约束」

探索方案：

• 提出 2-3 种不同方案，每种含权衡分析
• 先展示推荐方案并解释推荐理由
• 方案对比用 AskUserQuestion 让用户选择

视觉伴侣（可选）：

评估后续问题是否涉及视觉内容时，单独一条消息征求同意：

"后续可能涉及视觉内容（mockup、布局对比等），可以在浏览器中展示。需要启用视觉伴侣吗？"

用户同意后参见 references/visual-companion-guide.md 操作。判断标准：

• 用浏览器：UI mockup、架构图、布局对比、设计风格对比
• 用终端：需求问题、概念选择、权衡列表、技术决策

Key Principles

• 一次一个问题：不要一条消息塞多个问题，用户容易遗漏
• 多选优先：AskUserQuestion options 比开放式更易回答
• YAGNI 无情移除：从所有设计中清除不必要的功能，"以后可能用到"不是理由
• 递进验证：展示方案、获得认可后再推进，不要单方面决定
• 灵活回溯：发现理解偏差时立刻返回澄清，不要在错误假设上继续

brainstorm.md 模板