database-migration

概覽

什麼是 database-migration？

database-migration 是一項後端開發技能，協助團隊管理包括 Sequelize、TypeORM 和 Prisma 等主流 ORM 的資料庫結構與資料遷移。它提供零停機部署策略、完善的回滾程序及資料轉換功能，非常適合需要可靠資料庫變更且不中斷服務的專案。

誰適合使用此技能？

此技能最適合後端開發人員、資料庫工程師及 DevOps 專業人士，適用於以下需求：

• 不同 ORM 之間的遷移
• 結構轉換
• 資料庫間的資料移動
• 回滾程序的實施
• 零停機部署資料庫變更
• 資料庫版本升級
• 資料模型重構

解決的問題

• 安全且可靠的結構變更
• 自動化遷移工作流程
• 失敗遷移的回滾支援
• 多種 ORM 的相容性

使用說明

安裝步驟

安裝 database-migration，請執行：

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

快速開始

1. 閱讀 SKILL.md 檔案，了解遷移工作流程及支援的 ORM。
2. 探索 README.md、AGENTS.md 和 metadata.json，獲取詳細說明與背景資訊。
3. 查看 rules/、resources/、references/ 和 scripts/ 資料夾，尋找遷移輔助工具與範例。
4. 根據專案的程式庫、ORM 及部署需求，調整遷移策略。

支援的 ORM 遷移範例

Sequelize

• 在 migrations/ 建立遷移檔案。
• 使用 npx sequelize-cli db:migrate 執行遷移。
• 使用 npx sequelize-cli db:migrate:undo 回滾。

TypeORM

• 在 migrations/ 建立遷移類別。
• 使用 TypeORM CLI 指令執行遷移。
• 使用 TypeORM 的回滾功能進行回滾。

Prisma

• 使用 Prisma 的遷移工具進行結構變更與回滾。

最佳實踐

• 在測試環境先行測試遷移，確保無誤後再部署至正式環境。
• 使用版本控制管理遷移腳本。
• 對關鍵變更實施回滾程序。

常見問題

我在哪裡可以找到遷移範例？

請查看 SKILL.md 檔案及 migrations/ 資料夾，內含 Sequelize、TypeORM 和 Prisma 的遷移範例腳本。

database-migration 支援零停機部署嗎？

支援，該技能提供零停機資料庫遷移的指導與策略，將結構變更期間的服務中斷降至最低。

我可以用 database-migration 進行資料轉換嗎？

完全可以。此技能設計涵蓋結構與資料遷移，包括複雜的資料轉換流程。

如何回滾遷移？

每個支援的 ORM 都包含回滾指令與程序，請參考遷移範例與文件了解詳細步驟。

database-migration 適合前端專案使用嗎？

不適合，此技能專注於後端資料庫工程，不適用於前端或 UI 遷移。

我在哪裡可以查看所有檔案與腳本？

請開啟 Files 分頁，預覽完整檔案樹，包括巢狀參考與輔助腳本。