「循序揭露」的本質就是將龐大的說明書改為
「階層式選單」,維持主文件精簡,細節採按需載入。
你可以將技能資料夾設計為以下結構:
- 主入口檔(SKILL.md):扮演導覽員角色,只包含 50~100 字的精準觸發條件描述,以及各子模組的快速索引表。
- 子說明文件(/docs):將特殊例外處理、詳細 API 規格或極端案例拆分置於此目錄。例如 `edge-cases.md` 或 `schema-guide.md`。
- 自動化腳本(/scripts):將複雜的檢查邏輯直接寫成 Shell 或 Python 腳本,讓 AI 直接呼叫執行,而不是在文本中一步步教 AI 怎麼做。
當模型接到任務時,會先讀取主入口檔判斷是否需要此技能,只有在真正需要深入時才會進一步讀取子文件,藉此大幅節省上下文空間。