依存関係アップグレードプランナー

プロジェクトの依存関係を安全かつ体系的な順序でアップグレードするための計画を立案します。変更を加える前に、破壊的変更をグループ化し、リスクを明示します。

依存関係アップグレードプランナー とは?

このスキルは、ユーザーが依存関係のアップグレードを依頼した際に、安全で秩序立った計画を自動生成するために設計されています。package.json, requirements.txt, go.mod, Cargo.toml など、複数のエコシステムのマニフェストとロックファイルを読み取り、現在のバージョンと利用可能なバージョンを特定します。npm outdated や pip list --outdated などのエコシステム固有の読み取り専用ツールを活用し、各パッケージをパッチ/マイナー、メジャー、セキュリティに分類します。セキュリティ修正は最優先でバッチ0にまとめ、その後にパッチ/マイナー、独立したメジャーアップグレード、そしてフレームワークとそのプラグインのように同時に移動しなければならないメジャーアップグレードを順次バッチ処理します。各バッチについて、パッケージ名、バージョン、破壊的変更の有無、検証コマンド、ロールバック手順を具体的に提示します。計画の承認を得るまでは実際のアップグレードやインストールは一切実行しない、という厳格なポリシーに従います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/teejayfpi/agensi-skills/tree/add-agensi-skills/repo-maintenance-pack/skills/dependency-upgrade-planner

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

依存関係アップグレードプランナー は何をしますか?

計画を作成します。ユーザーが計画を承認するまでは、何もアップグレードしません。

手順

  1. マニフェストからエコシステムを検出します:package.json、requirements.txt または pyproject.toml、go.mod、Cargo.toml、Gemfile、pom.xml。複数存在する場合は、どれの計画を立てるか尋ねるか、それぞれ別々に計画します。
  2. マニフェストとロックファイル(package-lock.json、poetry.lock、go.sum、Cargo.lock、Gemfile.lock)から現在のバージョンを読み取ります。
  3. エコシステム独自のツールを使って利用可能なバージョンを探し、実際に得られた出力を報告します:
    • npm: npm outdated
    • Python: pip list --outdated または uv pip list --outdated
    • Go: go list -u -m all
    • Rust: cargo outdated
    • Ruby: bundle outdated ツールが利用できない場合はその旨を伝え、マニフェストから作業し、バージョンを未確認としてマークします。
  4. 各アップデートが必要なパッケージを分類します:
    • パッチ / マイナー — 通常は安全。
    • メジャー — 計画を立てる前に、変更ログまたはリリースノートを読み、破壊的変更を確認します。
    • セキュリティ — npm audit、pip-audit、govulncheck、cargo audit、bundle audit でフラグが立ったもの。これらを最優先します。
  5. 作業をバッチに分割します:
    • バッチ0:セキュリティ修正(メジャーでも可)。
    • バッチ1:パッチおよびマイナーバンプ。エリアごとにグループ化。
    • バッチ2:他の依存関係に影響しないメジャー。1コミットにつき1つ。
    • バッチ3:同時に移動する必要があるメジャー(例:フレームワークとそのプラグイン)。
  6. 各バッチについて、以下の内容を記述します:パッケージ名、更新前後のバージョン、該当する破壊的変更、変更が必要なコードまたは設定、検証方法。

出力テンプレート

## アップグレード計画

エコシステム: <npm / pip / go / cargo / ...>
マニフェスト: <パス>

### バッチ0 — セキュリティ
| パッケージ | 変更前 | 変更後 | 理由 | 破壊的変更あり? |
| --- | --- | --- | --- | --- |

### バッチ1 — パッチおよびマイナー
...

### バッチ2 — メジャー(独立)
...

### バッチ3 — メジャー(同時に移動)
...

### 検証

各バッチ後:<後退がないことを証明する正確なコマンド>

### ロールバック

バッチごと:<戻し方、例:バッチコミットの git revert>

### 保留

<意図的にそのままにしたパッケージとその理由>

ルール

  • 計画中にマニフェストを編集してはいけません。計画を出力し、そこで停止します。
  • メジャーバンプが利用可能な場合は実際の変更ログを読みます。メジャーバージョン番号が変わったからといって破壊的変更と決めつけてはいけません。
  • 必ず検証コマンドを指定します。「テストを実行」はコマンドではありません。 npm test がコマンドです。
  • パッケージを保留する場合はその理由を明記します(例:リリースノートが読めなかったメジャー)。
  • ツリーを変更する install、upgrade、audit コマンドを実行してはいけません。npm outdated、npm audit、およびそれらと同等のコマンドは読み取り専用であり、使用して問題ありません。

関連ファイル

references/upgrade-strategy.md には、バッチ処理、セマンティックバージョニングのエッジケース、および保留しなければならないパッケージの扱い方が説明されています。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル