# Expand

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

- Skill: `mileschou/expand` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mileschou/expand`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mileschou/expand/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: MilesChou (https://skillmd.com/u/mileschou)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mileschou/expand

---


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

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

## 執行流程

1. **初步分析與規劃**
   - 掃描現有文件結構
   - 識別內容缺口和不明確處
   - 制定擴充策略和優先順序

2. **互動式探索**
   - 主動提出澄清問題
   - 詢問具體使用場景
   - 確認技術細節和邊界條件
   - 收集實際案例和最佳實踐

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

## 擴充策略

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

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

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

## 品質標準

擴充後的文件應達到：

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

## 使用場景

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

## 互動流程範例

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

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

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

## 注意事項

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

## 輸出格式

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