project-migrate

project-migrate 技能專為希望將現有專案納入 AgenticDev 方法論的開發者與 AI 代理設計。此工具並非盲目搬移檔案，而是利用 Gemini CLI 對 Markdown 文件進行深度內容分析。它能理解檔案的語境與意圖，精確識別規格說明、研究紀錄與技術提案，並將其對應至標準化的 AgenticDev 目錄架構中。透過內容分析與後設資料增強，此工具能建立一個符合搜尋需求與自動化工作流規範的專案環境。

• 自動發現並智慧化分類既有文件，涵蓋 docs/、wiki/ 等常見路徑。

• 運用 Gemini AI 深度分析文件內容，自動識別規格書 (specs)、ADR 與產品需求文件 (PRD)。

• 使用 git mv 指令完整保留 Git 歷史紀錄，確保文件演變過程可追溯。

• 基於大型語言模型 (LLM) 的連結修復功能，能理解上下文並自動修復遷移後失效的相對路徑。

• 自動產生符合規範的 YAML frontmatter，包含標題、文件類型與摘要，提升文件可讀性與索引效率。

• 提供安全性保障，包含完整的時間戳備份與自動生成的 rollback.sh 復原腳本，確保遷移過程零資料遺失。

• 提供三種執行模式：互動模式供手動審核、乾跑模式 (dry-run) 預覽規劃、以及自動核准模式 (auto-approve) 適用於 CI/CD 流程。

• 執行時須確保系統環境已安裝 Gemini CLI 並完成身份驗證。

• 建議在遷移完成後執行 doc-indexer 技能，以驗證文件架構的完整性與合規性。

• 適合需要快速統一專案文件標準的技術團隊，將散亂的技術文檔轉化為結構化的數位資產。

• 在執行遷移前，建議保持 git 工作區清潔，並在遷移執行過程中詳細檢視預覽計畫，以確保在必要時能快速復原。