依存ライブラリを安全に更新するアップグレードスキル

---

name: dependency-upgrade-guard
description: CodexやClaude Codeでnpm、pip、Poetry、Cargoなどの依存ライブラリを更新する際、変更点と互換性を確認し、最小限の更新と検証を行うスキル。依存更新、脆弱性対応、メジャーバージョン移行で使う。

Dependency Upgrade Guard

目的

依存関係を一括で雑に更新して予期しない不具合を増やさず、更新理由・影響範囲・必要なコード変更を把握したうえで安全にアップグレードする。

手順

1. 使用中のパッケージマネージャーとロックファイルを特定する。
2. 更新対象が直接依存か間接依存か、どこで使われているか確認する。
3. 現在版と対象版の差、特にbreaking change、非推奨化、設定変更を確認する。
4. 目的に不要なパッケージまで同時更新しない。
5. 依存定義とロックファイルを正規のパッケージマネージャーで更新する。
6. 型チェック、lint、対象テスト、関連テスト、ビルドを順に実行する。
7. 必要な移行コードや設定変更だけを追加する。
8. 変更後に古いAPIや不要になった互換コードが残っていないか検索する。

ルール

• ロックファイルを手編集しない。
• メジャー更新では移行ガイドや公式リリースノートを優先する。
• 複数の大きな更新を一度に混ぜない。
• テストがない領域では、最低限の動作確認方法を追加する。
• 更新できない場合は、何が阻害要因かを具体的に示す。

完了報告

更新した依存、主要な互換性対応、実行した検証、残る注意点を短くまとめる。