# 腦力激盪 (Brainstorming) 技能指南

## 概述
`brainstorming` 技能旨在將模糊的想法轉化為精確的設計方案。它強制執行「先設計，後開發」的原則，避免在實作過程中因假設錯誤而導致的重複工作。

## 🚀 運作流程
1. **上下文探索**：AI 分析專案現有代碼、文檔及提交記錄。
2. **釐清需求**：透過**一次一個問題**的對話，確認目的、限制與成功標準。
3. **方案對比**：提供 2-3 種實現方式及其優缺點（Trade-offs），並給出推薦建議。
4. **分段設計**：詳細說明架構、元件與數據流，每段需經用戶確認。
5. **文件化 (Spec)**：將共識記錄於 `docs/brainstorm/` 下的設計文檔中。
6. **最終審核**：AI 自查 $\rightarrow$ 用戶審核文檔 $\rightarrow$ 批准。
7. **轉入計畫**：調用 `writing-plans` 技能制定詳細實作計畫。

## 🌐 視覺助手 (Visual Companion) 使用說明
當文字不足以表達視覺概念（如 UI 佈局、架構圖）時，AI 會啟動視覺助手。

### 如何使用
1. **啟動**：AI 請求權限 $\rightarrow$ 用戶同意 $\rightarrow$ AI 提供 `localhost` 連結。
2. **互動**：
    - 用戶打開連結查看 AI 生成的 HTML 原型圖或圖表。
    - 用戶可直接在網頁上**點擊選項**（例如：選擇佈局 A 或 B）。
3. **反饋迴圈**：
    - AI 讀取用戶的點擊紀錄與終端機文字反饋。
    - AI 更新 HTML 內容 $\rightarrow$ 用戶再次查看 $\rightarrow$ 直到達成共識。

### 適用場景
- ✅ **使用視覺助手**：UI 原型、佈局對比、導航結構、系統架構圖、流程圖。
- ❌ **使用終端機**：需求定義、邏輯討論、API 規格、技術權衡。

## 🔒 安全與隱私
- **完全本地化**：視覺助手運行於本地伺服器，所有數據僅在本地傳輸，**絕無資料外傳**行為。
- **透明控制**：所有視覺助手操作均需用戶明確同意後方可啟動。