gh-mileschou-claude-marketplace-plugins-document/commands/expand.md

description, model

description	model
Document expand	claude-sonnet-4-5

將概要文件透過互動式詢問擴充為完整文件。

分析指定文件的大綱或概要內容，識別需要補充的細節，透過主動詢問和探索來擴充文件深度與廣度。

執行流程

1. 初步分析與規劃

   • 掃描現有文件結構
   • 識別內容缺口和不明確處
   • 制定擴充策略和優先順序

2. 互動式探索

   • 主動提出澄清問題
   • 詢問具體使用場景
   • 確認技術細節和邊界條件
   • 收集實際案例和最佳實踐

3. 智能擴充

   • 根據回饋補充缺失內容
   • 添加範例程式碼和配置
   • 增加故障排除指南
   • 補充相關參考資源

擴充策略

探索領域

• 概念定義: 什麼是？為什麼重要？
• 使用場景: 何時使用？誰會使用？
• 實作細節: 如何運作？有哪些選項？
• 最佳實踐: 推薦做法？常見陷阱？
• 相關資源: 延伸閱讀？相關工具？

互動問題範例

• "這個功能的主要使用者是誰？"
• "有哪些常見的錯誤配置？"
• "能否提供實際的使用案例？"
• "這個流程的異常處理如何進行？"
• "是否有性能或安全考量？"

內容補充重點

• 前置條件: 環境需求、相依性
• 詳細步驟: 完整操作流程
• 程式範例: 實際可執行的程式碼
• 配置說明: 參數詳解、預設值
• 故障排除: 常見問題與解法
• 進階用法: 客製化、整合方案

品質標準

擴充後的文件應達到：

• 完整性: 涵蓋從入門到進階的完整知識
• 實用性: 包含可直接使用的範例
• 可讀性: 循序漸進的結構安排
• 準確性: 經過驗證的技術內容
• 深度性: 提供深入的技術洞察

使用場景

• 將簡要規格擴充為詳細文件
• 補充 API 文件的使用範例
• 完善安裝指南的故障排除
• 擴充配置文件的參數說明
• 豐富教學文件的實作細節

互動流程範例

AI Assistant: 我注意到文件提到了「快取策略」但缺少具體實作。
      請問：
      1. 快取的過期時間是多久？
      2. 是否支援手動清除快取？
      3. 快取失效時的降級策略為何？

User: 快取24小時過期，支援 --no-cache 參數，失效時直接呼叫 API

AI Assistant: 了解！我會補充以下內容：
      - 快取生命週期管理
      - 清除快取的指令範例
      - API 降級的錯誤處理機制

注意事項

重要提醒

• 擴充過程可以多次詢問細節
• 請準備相關技術規格和案例
• 可隨時中斷並保存進度
• 建議分階段進行大型文件擴充
• 透過持續對話來確保文件的完整性和準確性

輸出格式

擴充後的文件將：

1. 保持原始架構並新增章節
2. 標註新增內容的來源依據
3. 提供版本變更記錄