SKILL.md
readonlyread-only
name
update-markdown-file-index
description
更新一個 Markdown 檔案區段，加入指定資料夾的檔案索引/表格。
更新 Markdown 檔案索引
更新 Markdown 檔案 ${file}，加入資料夾 ${input:folder} 的檔案索引/表格。
處理流程
- 掃描：讀取目標 Markdown 檔案
${file}，了解現有結構 - 探索：列出指定資料夾
${input:folder}中符合模式${input:pattern}的所有檔案 - 分析：判斷是否有現有的表格/索引區段需要更新，或建立新的結構
- 結構化：根據檔案類型和現有內容，產生適當的表格/列表格式
- 更新：取代現有區段或新增區段，加入檔案索引
- 驗證：確保 Markdown 語法正確且格式一致
檔案分析
針對每個發現的檔案，提取：
- 名稱：根據上下文決定是否包含副檔名
- 類型：副檔名與分類（例如
.md、.js、.py） - 說明：第一行註解、標題或推斷的用途
- 大小：檔案大小供參考（選填）
- 修改日期：最後修改日期（選填）
表格結構選項
根據檔案類型和現有內容選擇格式：
選項 1：簡單列表
## ${folder} 中的檔案
- [filename.ext](path/to/filename.ext) - 說明
- [filename2.ext](path/to/filename2.ext) - 說明
選項 2：詳細表格
| 檔案 | 類型 | 說明 |
|---|---|---|
| filename.ext | 副檔名 | 說明 |
| filename2.ext | 副檔名 | 說明 |
選項 3：分類區段
依類型/分類將檔案分組，使用獨立區段或子表格。
更新策略
- 🔄 更新現有：若表格/索引區段已存在，保留結構並取代內容
- ➕ 新增：若無現有區段，使用最適合的格式建立新區段
- 📋 保留：維持現有 Markdown 格式、標題層級與文件流程
- 🔗 連結：使用相對路徑作為檔案連結（在儲存庫內）
區段識別
尋找符合以下模式的現有區段：
- 標題包含：「index」、「files」、「contents」、「directory」、「list」
- 包含檔案相關欄位的表格
- 包含檔案連結的列表
- 標記檔案索引區段的 HTML 註解
需求
- 保留現有 Markdown 結構與格式
- 使用相對路徑作為檔案連結
- 若檔案有說明則包含說明
- 預設依字母順序排序檔案
- 處理檔名中的特殊字元
- 驗證所有產生的 Markdown 語法
