splitting-notes

splitting-notes 是一項系統性的重構技能，專為維護和優化大型文件儲存庫而設計。當 Markdown 檔案過大（超過 1000 行）或因主題混雜而難以閱讀時，該技能可透過漸進式分組原則將龐大的內容拆解為模組化、專注於單一主題的檔案（目標約 500 行），並生成具備階層導航的索引檔案。此過程能顯著降低認知負荷、提升檢索效率，並改善網站生成的建置效能。

• 自動識別大型 H2 章節，將其提取為獨立檔案。

• 根據特定規則建構索引檔案，格式為： - Name - Description。

• 強制執行嚴格的 Frontmatter 標準，包括 sidebar_position 與 tags。

• 支援多步驟重構工作流程，要求進入 Plan Mode 以確保結構完整性。

• 遷移後會自動更新檔案內部的連結參考並修正資源路徑（如圖片路徑）。

• 與 pnpm build、Lint 工具鏈及 Grep 檢測整合，確保遷移後的檔案品質。

• 在執行拆分前，務必先呼叫 EnterPlanMode 以規劃遷移策略。

• 非常適合技術文件、個人知識庫或學習筆記（TIL）的管理。

• 輸入要求：現有的 Markdown 檔案需具備結構明確的 H2 標題。

• 輸出結果：整潔的模組化目錄結構以及作為目錄頁的專用索引檔案。

• 限制條件：不要拆分低於 500 行的檔案，確保主題分組的連貫性，並在完成前務必執行 pnpm lint:content 進行驗證。