Initial commit

commands/expand.md

@@ -0,0 +1,102 @@
+---
+description: Document expand
+model: claude-sonnet-4-5
+---
+
+將概要文件透過互動式詢問擴充為完整文件。
+
+分析指定文件的大綱或概要內容，識別需要補充的細節，透過主動詢問和探索來擴充文件深度與廣度。
+
+## 執行流程
+
+1. **初步分析與規劃**
+   - 掃描現有文件結構
+   - 識別內容缺口和不明確處
+   - 制定擴充策略和優先順序
+
+2. **互動式探索**
+   - 主動提出澄清問題
+   - 詢問具體使用場景
+   - 確認技術細節和邊界條件
+   - 收集實際案例和最佳實踐
+
+3. **智能擴充**
+   - 根據回饋補充缺失內容
+   - 添加範例程式碼和配置
+   - 增加故障排除指南
+   - 補充相關參考資源
+
+## 擴充策略
+
+### 探索領域
+- **概念定義**: 什麼是？為什麼重要？
+- **使用場景**: 何時使用？誰會使用？
+- **實作細節**: 如何運作？有哪些選項？
+- **最佳實踐**: 推薦做法？常見陷阱？
+- **相關資源**: 延伸閱讀？相關工具？
+
+### 互動問題範例
+- "這個功能的主要使用者是誰？"
+- "有哪些常見的錯誤配置？"
+- "能否提供實際的使用案例？"
+- "這個流程的異常處理如何進行？"
+- "是否有性能或安全考量？"
+
+### 內容補充重點
+- **前置條件**: 環境需求、相依性
+- **詳細步驟**: 完整操作流程
+- **程式範例**: 實際可執行的程式碼
+- **配置說明**: 參數詳解、預設值
+- **故障排除**: 常見問題與解法
+- **進階用法**: 客製化、整合方案
+
+## 品質標準
+
+擴充後的文件應達到：
+
+- **完整性**: 涵蓋從入門到進階的完整知識
+- **實用性**: 包含可直接使用的範例
+- **可讀性**: 循序漸進的結構安排
+- **準確性**: 經過驗證的技術內容
+- **深度性**: 提供深入的技術洞察
+
+## 使用場景
+
+- 將簡要規格擴充為詳細文件
+- 補充 API 文件的使用範例
+- 完善安裝指南的故障排除
+- 擴充配置文件的參數說明
+- 豐富教學文件的實作細節
+
+## 互動流程範例
+
+```
+AI Assistant: 我注意到文件提到了「快取策略」但缺少具體實作。
+      請問：
+      1. 快取的過期時間是多久？
+      2. 是否支援手動清除快取？
+      3. 快取失效時的降級策略為何？
+
+User: 快取24小時過期，支援 --no-cache 參數，失效時直接呼叫 API
+
+AI Assistant: 了解！我會補充以下內容：
+      - 快取生命週期管理
+      - 清除快取的指令範例
+      - API 降級的錯誤處理機制
+```
+
+## 注意事項
+
+**重要提醒**
+- 擴充過程可以多次詢問細節
+- 請準備相關技術規格和案例
+- 可隨時中斷並保存進度
+- 建議分階段進行大型文件擴充
+- 透過持續對話來確保文件的完整性和準確性
+
+## 輸出格式
+
+擴充後的文件將：
+1. 保持原始架構並新增章節
+2. 標註新增內容的來源依據
+3. 提供版本變更記錄