angular-migration

概覽

什麼是 angular-migration？

angular-migration 是一個專門設計來協助前端開發者將舊版 AngularJS (1.x) 應用程式遷移到現代 Angular (2+) 框架的技能。它提供混合應用程式設置、漸進式元件重寫、依賴注入現代化以及路由遷移的指導。這項技能對於希望升級、重構或現代化 AngularJS 代碼庫而不干擾持續開發的團隊來說至關重要。

誰應該使用這項技能？

• 維護 AngularJS 應用程式的前端開發者與團隊
• 計劃分階段或完整遷移到 Angular 的組織
• 尋求混合 AngularJS/Angular 應用最佳實踐的開發者
• 希望在降低風險的同時現代化舊有代碼的團隊

angular-migration 解決的問題

• 透過經驗證的策略實現從 AngularJS 到 Angular 的漸進式遷移
• 支援大型或複雜專案的混合應用架構
• 指導如何將指令轉換為 Angular 元件
• 協助更新依賴注入與路由系統至現代標準

使用說明

安裝步驟

1. 直接使用以下指令安裝技能：

   npx skills add https://github.com/wshobson/agents --skill angular-migration

2. 首先閱讀 SKILL.md 檔案，了解遷移的高階概覽與工作流程。

3. 探索支援文件，如 README.md、AGENTS.md、metadata.json，以及任何 rules/、resources/ 或 scripts/ 目錄，獲取詳細遷移步驟與輔助腳本。

支援的遷移策略

• 一次完成（全面重寫）： 將整個應用程式用 Angular 重寫，適合小型或新專案。
• 漸進式（混合方法）： 使用 ngUpgrade 同時運行 AngularJS 與 Angular，適合大型應用或持續交付環境。
• 垂直切片： 一次遷移一個功能，允許新功能以 Angular 開發，同時保留舊有代碼在 AngularJS，適合中型應用或功能明確分離的情況。

調整工作流程

• 以提供的遷移策略為範本，根據專案大小、複雜度及交付需求調整方法。
• 利用混合應用設置範例，在遷移期間同時啟動 AngularJS 與 Angular 代碼庫。

常見問題

什麼時候適合使用 angular-migration？

當您需要將現有 AngularJS 應用升級到 Angular，尤其想透過漸進式遷移或維持混合應用以降低風險和停機時間時，angular-migration 是理想選擇。

我應該先查看哪些檔案？

建議先從 SKILL.md 開始，了解遷移策略與最佳實踐摘要。接著查看 README.md 以及任何腳本或規則目錄，掌握實作細節。

angular-migration 有提供程式碼範例嗎？

有的，該技能包含混合應用設置範例，以及元件轉換和依賴注入更新的概要。請參閱倉庫中的檔案以取得實用的程式碼片段。

這項技能適合小型還是大型專案？

angular-migration 同時支援全面重寫（適合小型專案）與漸進式遷移（適合大型或複雜應用），具備多種專案規模的彈性。

我在哪裡可以找到更多資源？

請開啟倉庫的 Files 標籤，存取所有支援文件、參考資料與輔助腳本，獲得完整的遷移工作流程。