Flutter Pub Update

Overview

Flutterプロジェクトのpubspec.yaml依存パッケージを安全に更新するためのスキル。更新前に変更内容を確認し、メジャーバージョン変更時はユーザー確認を挟む。

使用方法

• •/flutter-pub-update パッケージ名 - 指定パッケージを更新
• •/flutter-pub-update パッケージ1 パッケージ2 - 複数パッケージを更新
• •/flutter-pub-update --all - 全パッケージを一括更新

ワークフロー

Step 1: 現在の状態を確認

flutter pub outdated

出力から以下を把握:

• •Current: 現在のバージョン
• •Upgradable: pubspec.yaml制約内で更新可能なバージョン
• •Resolvable: 制約を変更すれば更新可能なバージョン
• •Latest: 最新バージョン

Step 2: 更新対象の特定

指定パッケージの場合: $ARGUMENTSで指定されたパッケージのみ対象

--allの場合: outdatedで表示された全パッケージを対象

Step 3: 各パッケージの更新差分を調査

対象パッケージごとにWebFetchツールを使用して変更内容を確認:

1. •

   pub.devのChangelogを確認

   • •URL: https://pub.dev/packages/{パッケージ名}/changelog
   • •現在バージョンから更新後バージョンまでの変更点を抽出
2. •

   GitHubリリースノートを確認（必要に応じて）

   • •pub.devのパッケージページからリポジトリURLを取得
   • •リリースノートで詳細な変更内容を確認
3. •

   変更内容をまとめて報告

   • •新機能
   • •バグ修正
   • •Breaking Changes（重要）
   • •非推奨になった機能

Step 4: メジャーバージョン更新の確認

メジャーバージョンが変わる場合（例: 1.x.x → 2.x.x）:

1. •Breaking Changesを明確に提示
2. •影響を受ける可能性のあるコードを説明
3. •AskUserQuestionツールで更新の承認を確認

このパッケージはメジャーバージョンが変わります:
- {パッケージ名}: {現在バージョン} → {新バージョン}

Breaking Changes:
- [変更内容1]
- [変更内容2]

更新を続行しますか？

Step 5: パッケージの更新

承認後、flutter pub upgradeコマンドを使用:

指定パッケージの更新:

flutter pub upgrade パッケージ名

メジャーバージョンを含む更新:

flutter pub upgrade --major-versions パッケージ名

全パッケージの更新:

flutter pub upgrade

全パッケージのメジャーバージョン更新:

flutter pub upgrade --major-versions

Step 6: 更新結果の報告

更新完了後、以下を報告:

## 更新完了

| パッケージ | 旧バージョン | 新バージョン | 変更種別 |
|-----------|-------------|-------------|---------|
| xxx       | 1.0.0       | 1.2.0       | Minor   |
| yyy       | 2.0.0       | 3.0.0       | Major   |

### 主な変更点
- xxx: 新機能Aが追加
- yyy: APIが変更（要確認）

注意事項

• •自動生成ファイル（*.g.dart, *.freezed.dart）がある場合はflutter pub run build_runner build --delete-conflicting-outputsの実行を提案