Upgrade Strategies

概要

依存関係の安全なアップグレード戦略と段階的更新手法を専門とするスキル。本スキルは、複雑なバージョン管理、互換性検証、段階的ロールアウト、リスク最小化を含む包括的なアップグレード戦略の策定と実行をサポートします。

詳細な手順や背景は references/Level1_basics.md（基礎）、references/Level2_intermediate.md（実務）、references/Level3_advanced.md（応用）、references/Level4_expert.md（専門）を参照してください。

ワークフロー

Phase 1: 計画策定

目的: アップグレード計画を策定し、リスクを評価する

Task: agents/upgrade-planning.md

入力:

• package.json、ロックファイル、アップグレード対象

出力:

• アップグレード計画書、互換性マトリクス

Phase 2: 依存関係分析

目的: 依存関係グラフを構築し、影響範囲を把握する

Task: agents/dependency-analysis.md

入力:

• package.json、ロックファイル

出力:

• 依存関係レポート、競合・脆弱性情報

Phase 3: テスト戦略設計

目的: アップグレードの安全性を検証するテスト計画を設計する

Task: agents/test-strategy.md

入力:

• 影響範囲、既存テストスイート

出力:

• テスト計画書、テストケース

Phase 4: 段階的ロールアウト

目的: アップグレードを段階的に展開し、モニタリングを行う

Task: agents/rollout-execution.md

入力:

• アップグレード計画、テスト計画、環境情報

出力:

• ロールアウトレポート

Task仕様（ナビゲーション）

ベストプラクティス

すべきこと

• 前提条件の確認: references/Level1_basics.mdを参照し、アップグレード前に環境・依存関係を完全に把握する
• 段階的実施: 本番環境への一括アップグレードを避け、開発→ステージング→本番の段階的展開を実施する
• 互換性検証: references/strategy-selection-guide.mdに基づき、アップグレード前に詳細な互換性テストを実施する
• ロールバック計画の事前準備: references/rollback-procedures.mdに従い、問題発生時の復旧手順を明確にしておく
• テスト自動化: references/tdd-integration.mdを参照し、アップグレード検証をテスト化・自動化する
• ドキュメント更新: アップグレード計画、テスト結果、変更内容を記録・共有する
• チーム間のコミュニケーション: 変更スケジュール、影響範囲、リスク要因を関係者に事前通知する

避けるべきこと

• 十分なテストなしに本番環境でアップグレードを実行しない
• 単一バージョンへの一括アップグレードにより複数の破壊的変更を同時に導入しない
• ロールバック手段なしにアップグレードを開始しない
• 依存関係の相互影響やバージョン競合を考慮せずにアップグレードを進めない
• アップグレード前のバックアップやスナップショット作成を省略しない
• 既知の問題や互換性の警告を無視して進めない
• 自動スクリプトによるアップグレードを十分にレビューなしで実行しない

リソース参照

references/ - 学習リソース

scripts/ - 自動化スクリプト

node .claude/skills/upgrade-strategies/scripts/check-upgrades.mjs --help
node .claude/skills/upgrade-strategies/scripts/validate-skill.mjs --help
node .claude/skills/upgrade-strategies/scripts/log_usage.mjs --help

assets/ - テンプレート

cat .claude/skills/upgrade-strategies/assets/upgrade-plan-template.md

変更履歴