マイグレーションガイド
コーディング上級
React 18→19、Next.js 14→15などのメジャーバージョンアップグレードやフレームワーク移行時に、変更点を分析し段階的なマイグレーション計画とコード修正をガイドします。
トリガー
/migrate使用頻度四半期1回
レガシープロジェクト担当の開発者なら？ /migrate react 19でアップグレード時のブレイキングチェンジを自動検出
CTOなら？ 技術スタック移行の影響範囲を素早く把握
マイグレーションアップグレード互換性レガシー
動作フロー
/migrate [from → to] 実行
↓
フェーズ1: 3つの分析を並列実行
breaking-scan
ブレイキングチェンジの探索
dep-check
依存関係の互換性確認
code-impact
コード影響範囲分析
↓
段階的マイグレーション計画の策定
↓
✓ マイグレーション計画 + 自動コード修正
スキルコード
# Migration Guide Skill
## Trigger: /migrate [framework/library] [from version] [to version]
When invoked:
1. Identify breaking changes:
- Read official migration guide / changelog
- Scan codebase for affected patterns
- List deprecated APIs in use
2. Analyze impact:
- Files affected (count + list)
- Dependencies that need updating
- Test coverage of affected areas
3. Generate step-by-step plan:
---
## 🔄 Migration: [lib] v[X] → v[Y]
### Impact Summary
- Files affected: [N]
- Breaking changes: [N]
- Estimated effort: [hours/days]
### Pre-migration Checklist
- [ ] Ensure all tests pass on current version
- [ ] Create migration branch
- [ ] Backup database (if applicable)
### Step-by-Step Plan
1. **Update dependencies**
`npm install [package]@[version]`
2. **Fix breaking change: [name]**
- Before: `[old code]`
- After: `[new code]`
- Files: [list]
3. [Continue for each breaking change]
### Post-migration
- [ ] Run full test suite
- [ ] Verify build passes
- [ ] Test critical user flows
---
コピーしてCLAUDE.mdに貼り付ければ、すぐに使えます。
マイグレーションガイド の仕組み
Migration Guideは現在のフレームワーク/ライブラリバージョンを分析し、ターゲットバージョンの破壊的変更と非推奨化を比較した上で、コード変換例を含むステップバイステップのアップグレード計画を生成します。
マイグレーションガイド が力を発揮する場面
メジャーバージョンアップグレード（React 18→19、Next.js 14→15）で数百の破壊的変更が存在し、手動マイグレーションでは数日かかる場面で不可欠です。リスク順に変更を優先し、安全なマイグレーション順序を提供します。
主な強み
- 破壊的変更を実際のコードベースの使用状況にマッピング
- 安全な依存関係順序でマイグレーションステップを生成
- 各変更のコード変換例を含む
- 体系的アプローチで数日のマイグレーションを数時間に短縮