task-folder-migrator

Task Folder Migrator 是專為 drupal-dev-framework 設計的工具，協助開發者將舊版 v2.x 單檔案任務文件遷移至現代化的 v3.0.0 資料夾結構。對於維護中的 Drupal 專案，此工具能確保任務內容在需求擴張時依然條理分明。透過自動解析如「研究 (Research)」、「架構 (Architecture)」與「實作 (Implementation)」等 Markdown 標題，該技能能在保持數據完整性的同時，提升任務相關資料的搜尋與檢索效率。它會自動識別遺留的任務檔案，建立對應的目錄，並將內容拆解為 task.md、research.md、architecture.md 與 implementation.md，大幅降低手動整理的工作負載。

• 自動偵測並遷移舊版 .md 任務檔案至標準化的專案資料夾結構中。

• 支援雙模式操作：可由 project-orchestrator 自動觸發以實現無縫接軌，或由使用者透過手動模式進行確認與規劃。

• 具備資料安全性，在重建目錄前強制建立原始檔案的 .bak 備份。

• 具備智慧內容解析能力，可根據 Markdown 約定提取目標、驗收標準、相關任務與備註等區塊。

• 與專案編排器（project-orchestrator）緊密整合，能動態識別並處理專案狀態。

• 提升複雜開發週期的狀態追蹤能力，特別適合轉換至分階段編寫流程的專案。

• 適用於管理 Drupal 模組、佈景主題或多階段實作專案的開發者。

• 需運行於 drupal-dev-framework 環境，以確保正確讀取專案狀態與路徑。

• 針對空白區塊、遺失內容或備份檔衝突等邊緣情況，提供健全的處理機制（例如透過時間戳記重新命名）。

• 執行前請確認專案根目錄或目標路徑的可寫權限，以防路徑解析失敗。

• 遷移完成後請檢視產出的遷移報告，確認所有任務皆已成功轉換至新架構並可正確連結。