---
name: grounded-brainstorming
description: "知识驱动的头脑风暴。融合 DeepWiki 知识源 + Tree of Thoughts 多路径推理，将创意转化为有据可循的设计方案。"
---

# 知识驱动的头脑风暴

本技能用于 **grounded_workflows** 工作流中的 **设计前探索阶段**：在用户提出想法、功能构想或架构问题后，智能体必须在 **DeepWiki 本地知识（`.deepwiki/`）** 与 **Tree of Thoughts（ToT）多路径推理** 的双重约束下，将模糊创意收敛为 **可引用、可审计、可进入实施规划** 的设计方案。

**核心目的**：不是「凭感觉写方案」，而是把创意 **接地（ground）** 到项目知识，再通过 **多条独立路径的生成—展开—评估—筛选**，得到单一推荐设计，并输出符合模板的完整文档。

---

<HARD-GATE>
未完成 ToT 多路径分析前，禁止直接给出单一方案。
必须先生成 >= 3 个独立方向，完成展开、评估、筛选后，才能确定最终方案。
</HARD-GATE>

---

## 协议引用

执行本技能时，智能体必须显式依赖下列协议文件（路径相对于 `grounded_workflows` 仓库根目录）：

| 协议文件 | 使用时机与要求 |
|----------|----------------|
| `protocols/context-building.md` | **步骤 2**：在知识就绪后 **完整读取并严格执行**；从 `.deepwiki/` 按五步流程构建与任务强相关的结构化上下文，禁止跳过大纲匹配、禁止无差别通读全部页面。 |
| `protocols/grounding.md` | **贯穿全程**：所有事实性断言、设计结论、风险与前提说明，均须遵守接地规则与 `[DW]` / `[SRC]` / `[EXT]` 标注规范；`[EXT]` 占比与门控以该协议为准。 |
| `protocols/tot-reasoning.md` | **步骤 4**：在开展多路径分析前 **完整读取**；按该协议的四阶段（生成 → 展开 → 评估 → 筛选）执行，并与 grounding 的标签要求对齐。 |

---

## Checklist

智能体必须 **按顺序** 完成下列 7 步；不得在未完成步骤 4 的情况下跳到「唯一最终方案」；不得跳过用户确认点（步骤 5）。

1. **知识就绪检查**  
   - 使用 Shell（例如 `ls`）检查工作区（通常为项目根）下是否存在可用的 `.deepwiki/` 目录（至少应能判断是否存在 `README.md`、`_outline.md` 等 context-building 所依赖的结构）。  
   - **若未就绪或明显残缺**：不得假装已有知识；应向用户说明缺口，并 **引导其先调用 `grounded-knowledge-prepare` skill**（或等价流程）生成/更新知识库，然后重新开始本技能。  
   - **若已就绪**：进入步骤 2。

2. **加载知识**  
   - 读取并严格执行 `protocols/context-building.md`。  
   - 从 `.deepwiki/` 加载与当前任务 **强相关** 的页面与元信息，产出结构化上下文块（含 `[DW]` 与可定位路径），作为后续澄清与 ToT 的 **唯一优先事实源**（在知识覆盖范围内）。

3. **需求澄清**  
   - **一次只向用户提一个问题**；等待回答后再问下一题。  
   - 问题应 **基于已加载的 `[DW]` 知识** 构造（例如引用大纲中的模块名、架构约束、术语），避免脱离项目语境的空泛提问。  
   - **优先使用选择题**（含「其他，请说明」类开放尾巴），降低用户认知负担；仅在选项无法覆盖时再使用简短问答题。  
   - 澄清产出需内化到后续 ToT 的问题陈述与约束中。

4. **ToT 分析**  
   - 读取 `protocols/tot-reasoning.md`。  
   - **四阶段顺序执行**：  
     - **生成**：不少于 **3** 条 **认知上可区分** 的独立方向（若天然仅两条强路径，第三条须为显式基线/反例/「不做」等仍具决策价值的选项，见 ToT 协议）。  
     - **展开**：对每个方向按协议展开要点；每条独立断言遵守 `grounding.md` 的标签与引用要求。  
     - **评估**：在协议规定的统一维度上可复算、可解释地比较各方向。  
     - **筛选**：得到 **唯一** 推荐方向或明确的「暂缓/需数据」门控结论；若暂缓，须说明 unblock 条件。  
   - 在完成本步之前，**禁止** 将任一方向当作最终定案输出给用户（与 HARD-GATE 一致）。

5. **呈现设计**  
   - **分节**展示设计（建议按模块、数据流、接口、迁移与风险等小节组织，与模板第 6 节可对齐）。  
   - **每节末尾征求用户确认**；用户提出修改时，返回 **步骤 3 或 4 的适当子步骤**（小改可只在局部修订，但若动摇前提或架构权衡，应回到 ToT 重新评估）。  
   - 本节及后续文档中，**所有关键结论、约束、取舍** 均须带来源标签：`[DW]`（DeepWiki/项目知识库）、`[SRC]`（仓库源码定位）、`[EXT]`（外部或推断，须符合 grounding 门控）。  
   - **禁止** 将未标注来源的猜测写为确定事实。

6. **输出文档**  
   - 在用户对设计各节确认后，按 `templates/brainstorming-output.md` **完整填充** 各章节，写入 **一份** 设计文档文件（路径可由用户指定；若未指定，默认建议写入 `docs/designs/` 或会话约定目录，文件名包含主题与日期）。  
   - 文档中的知识上下文、ToT 方向、评估矩阵、选定方案与未采纳方向须与对话中 **最终一致**；来源统计与路径字段须真实，不得留占位符式的虚假数字。

7. **过渡**  
   - 交付文档后，明确建议用户下一步调用 **`grounded-planning` skill**，基于已定稿设计与 grounding 规则制定可执行实施计划（含任务拆分与依赖）。  
   - 若仍存在未解决的 `[EXT]` 高风险假设，须在过渡说明中列出 **须在 planning 前补齐的证据或实验**。

---

## 流程图

```mermaid
graph TD
    Start[用户调用 brainstorming] --> Check[知识就绪检查]
    Check -->|未就绪| KP[引导使用 grounded-knowledge-prepare]
    Check -->|就绪| Load[按 context-building 协议加载知识]
    Load --> Clarify[逐个澄清需求]
    Clarify --> ToT[ToT 多路径分析]
    ToT --> Present[分节呈现设计]
    Present -->|已确认| Output[输出设计文档]
    Present -->|需修改| Clarify
    Output --> Next[建议 grounded-planning]
```

---

## 关键原则

- **单点提问**：任意时刻最多一个待用户回答的问题；禁止一次性列出长问卷式追问。  
- **选择题优先**：默认提供 2～4 个选项 +「不确定/其他」；选项文案应可读、互斥且覆盖常见意图。  
- **YAGNI（You Aren't Gonna Need It）**：只设计用户明确要求或已由 `[DW]`/`[SRC]` 证成的必要能力；不擅自扩展「未来可能有用」的功能面。  
- **探索替代方案（ToT 强制）**：在 HARD-GATE 与 `tot-reasoning.md` 约束下，必须完成多方向探索与比较后再定案。  
- **增量验证**：设计按节呈现、按节确认，避免长篇一次性输出后再问意见。  
- **来源透明**：所有重要判断均可追溯到 `[DW]` / `[SRC]` / `[EXT]`；`[EXT]` 不得伪装为仓库事实。

---

## 工具映射

| 步骤 | 工具 | 用途 |
|------|------|------|
| 知识检查 | Shell（`ls` 等） | 检查 `.deepwiki/` 目录是否存在及基本结构是否可加载 |
| 加载知识 | Read | 读取 `protocols/context-building.md`、`protocols/grounding.md` 及 `.deepwiki/` 下按协议选中的页面 |
| 需求澄清 | 直接对话 | 向用户单次提问并接收回答 |
| ToT 分析 | Read + 推理 | 读取 `protocols/tot-reasoning.md` 并按四阶段执行；结合已加载页面与源码证据进行标注与比较 |
| 呈现设计 | 直接对话 | 分节输出并等待用户确认 |
| 输出文档 | Write | 按 `templates/brainstorming-output.md` 写入完整设计文档文件 |

---

## 与其他技能的关系

- **前置**：`grounded-knowledge-prepare` — 确保 `.deepwiki/` 可用、时效可接受。  
- **后继**：`grounded-planning` — 将本技能定稿设计转化为计划与任务分解。  
- **横向约束**：凡涉及事实与引用，均以 `protocols/grounding.md` 为最高优先级之一；与本技能 HARD-GATE 冲突时，以 **更严格** 者为准。

---

## 常见反模式（禁止）

- 未检查 `.deepwiki/` 或未完成 context-building 即「直接给方案」。  
- 将 ToT 简化为「写三个很相似的段落」而无实质差异维度。  
- 单次向用户抛出大量问题或无选项的开放追问堆叠。  
- 在设计文档中使用占位符日期、虚假来源统计或与对话结论不一致的表述。  
- 在用户未确认前一节时继续输出后续大量设计细节并假定默认同意。

---

## 成功标准（本技能可验收）

- `.deepwiki/` 状态已检查；未就绪时正确引导 `grounded-knowledge-prepare`。  
- 已按 `context-building` 加载知识且后续问题与设计明显 **引用** 了加载内容。  
- ToT：**≥3** 方向 → 每方向展开 → 统一维度评估 → 筛选结论，且全程符合 `tot-reasoning.md` 与 HARD-GATE。  
- 用户已对分节设计逐节确认（或明确记录其选择的修订路径）。  
- 已输出符合 `templates/brainstorming-output.md` 的完整文档，来源标签与统计真实一致。  
- 已建议用户进入 `grounded-planning`。