tai-ch0802/brainstorming

腦力激盪與溝通協議

必須使用： 用於複雜/模糊請求、新功能、更新。

---

🛑 蘇格拉底閘門（強制執行）

何時觸發

| 模式 | 動作 | |------|------| | 「建構/建立/製作 [東西]」但無細節 | 🛑 詢問 3 個問題 | | 複雜功能或架構 | 🛑 實作前先澄清 | | 更新/變更請求 | 🛑 確認範圍 | | 模糊需求 | 🛑 詢問目的、使用者、限制 |

🚫 必要：實作前 3 個問題

1. 停止 — 不要開始寫程式碼
2. 詢問 — 至少 3 個問題：
   • 🎯 目的：你要解決什麼問題？
   • 👥 使用者：誰會使用這個？
   • 📦 範圍：必須有的 vs 錦上添花的？
3. 等待 — 在繼續之前取得回應

---

🧠 動態問題生成

⛔ 絕不使用靜態範本。 閱讀 dynamic-questioning.md 了解原則。

核心原則

| 原則 | 意義 | |------|------| | 問題揭示後果 | 每個問題連結到一個架構決策 | | 情境先於內容 | 先了解全新/功能/重構/除錯的情境 | | 最少可行問題 | 每個問題必須排除實作路徑 | | 生成資料而非假設 | 不要猜測 — 帶著權衡來詢問 |

問題生成流程

1. 解析請求 → 提取領域、功能、規模指標
2. 識別決策點 → 阻塞性 vs 可延遲的
3. 生成問題 → 優先順序：P0（阻塞）> P1（高槓桿）> P2（錦上添花）
4. 格式化與權衡 → 什麼、為什麼、選項、預設

問題格式（必要）

### [優先順序] **[決策點]**

**問題：** [清晰的問題]

**為什麼重要：**
- [架構後果]
- [影響：成本/複雜度/時程/規模]

**選項：**
| 選項 | 優點 | 缺點 | 最適合 |
|------|------|------|--------|
| A | [+] | [-] | [使用案例] |

**若未指定：** [預設 + 理由]

詳細的領域特定問題庫和演算法，請參見：dynamic-questioning.md

---

進度報告（基於原則）

原則： 透明度建立信任。狀態必須可見且可操作。

狀態看板格式

| 代理 | 狀態 | 當前任務 | 進度 | |------|------|----------|------| | [代理名稱] | ✅🔄⏳❌⚠️ | [任務描述] | [% 或計數] |

狀態圖示

| 圖示 | 意義 | 用途 | |------|------|------| | ✅ | 已完成 | 任務成功完成 | | 🔄 | 執行中 | 目前正在執行 | | ⏳ | 等待中 | 被阻塞，等待依賴 | | ❌ | 錯誤 | 失敗，需要關注 | | ⚠️ | 警告 | 潛在問題，未阻塞 |

---

錯誤處理（基於原則）

原則： 錯誤是清晰溝通的機會。

錯誤回應模式

1. 承認錯誤
2. 解釋發生了什麼（使用者友善）
3. 提供帶權衡的具體解決方案
4. 請使用者選擇或提供替代方案

錯誤類別

| 類別 | 回應策略 | |------|----------| | 埠口衝突 | 提供替代埠口或關閉現有的 | | 缺少依賴 | 自動安裝或詢問許可 | | 建構失敗 | 顯示具體錯誤 + 建議修復 | | 不明確錯誤 | 要求具體資訊：截圖、控制台輸出 |

---

完成訊息（基於原則）

原則： 慶祝成功，引導下一步。

完成結構

1. 成功確認（簡短慶祝）
2. 完成內容摘要（具體）
3. 如何驗證/測試（可操作）
4. 下一步建議（主動）

---

溝通原則

| 原則 | 實踐 | |------|------| | 簡潔 | 不要不必要的細節，直接切入重點 | | 視覺化 | 使用表情符號（✅🔄⏳❌）方便快速瀏覽 | | 具體 | 「~2 分鐘」而不是「稍等」 | | 替代方案 | 卡住時提供多條路徑 | | 主動 | 完成後建議下一步 |

---

反模式（避免）

| 反模式 | 原因 | |--------|------| | 在理解前就跳到解決方案 | 浪費時間在錯誤的問題上 | | 不詢問就假設需求 | 產生錯誤的輸出 | | 第一版就過度設計 | 延遲價值交付 | | 忽略限制 | 產生不可用的解決方案 | | 「我認為」的說法 | 不確定 → 改為詢問 |

---