依存関係アップグレードプランナー は何をしますか?
計画を作成します。ユーザーが計画を承認するまでは、何もアップグレードしません。
手順
- マニフェストからエコシステムを検出します:
package.json、requirements.txtまたはpyproject.toml、go.mod、Cargo.toml、Gemfile、pom.xml。複数存在する場合は、どれの計画を立てるか尋ねるか、それぞれ別々に計画します。 - マニフェストとロックファイル(
package-lock.json、poetry.lock、go.sum、Cargo.lock、Gemfile.lock)から現在のバージョンを読み取ります。 - エコシステム独自のツールを使って利用可能なバージョンを探し、実際に得られた出力を報告します:
- npm:
npm outdated - Python:
pip list --outdatedまたはuv pip list --outdated - Go:
go list -u -m all - Rust:
cargo outdated - Ruby:
bundle outdatedツールが利用できない場合はその旨を伝え、マニフェストから作業し、バージョンを未確認としてマークします。
- npm:
- 各アップデートが必要なパッケージを分類します:
- パッチ / マイナー — 通常は安全。
- メジャー — 計画を立てる前に、変更ログまたはリリースノートを読み、破壊的変更を確認します。
- セキュリティ —
npm audit、pip-audit、govulncheck、cargo audit、bundle auditでフラグが立ったもの。これらを最優先します。
- 作業をバッチに分割します:
- バッチ0:セキュリティ修正(メジャーでも可)。
- バッチ1:パッチおよびマイナーバンプ。エリアごとにグループ化。
- バッチ2:他の依存関係に影響しないメジャー。1コミットにつき1つ。
- バッチ3:同時に移動する必要があるメジャー(例:フレームワークとそのプラグイン)。
- 各バッチについて、以下の内容を記述します:パッケージ名、更新前後のバージョン、該当する破壊的変更、変更が必要なコードまたは設定、検証方法。
出力テンプレート
## アップグレード計画
エコシステム: <npm / pip / go / cargo / ...>
マニフェスト: <パス>
### バッチ0 — セキュリティ
| パッケージ | 変更前 | 変更後 | 理由 | 破壊的変更あり? |
| --- | --- | --- | --- | --- |
### バッチ1 — パッチおよびマイナー
...
### バッチ2 — メジャー(独立)
...
### バッチ3 — メジャー(同時に移動)
...
### 検証
各バッチ後:<後退がないことを証明する正確なコマンド>
### ロールバック
バッチごと:<戻し方、例:バッチコミットの git revert>
### 保留
<意図的にそのままにしたパッケージとその理由>
ルール
- 計画中にマニフェストを編集してはいけません。計画を出力し、そこで停止します。
- メジャーバンプが利用可能な場合は実際の変更ログを読みます。メジャーバージョン番号が変わったからといって破壊的変更と決めつけてはいけません。
- 必ず検証コマンドを指定します。「テストを実行」はコマンドではありません。
npm testがコマンドです。 - パッケージを保留する場合はその理由を明記します(例:リリースノートが読めなかったメジャー)。
- ツリーを変更する install、upgrade、audit コマンドを実行してはいけません。
npm outdated、npm audit、およびそれらと同等のコマンドは読み取り専用であり、使用して問題ありません。
関連ファイル
references/upgrade-strategy.md には、バッチ処理、セマンティックバージョニングのエッジケース、および保留しなければならないパッケージの扱い方が説明されています。