| name | flutter-upgrade-creator |
| description | Generate a dedicated Flutter upgrade skill (e.g. flutter-upgrade-3-47) for a specific Flutter stable release by fetching and analyzing release notes, breaking changes, and migration guides. Use when the user asks to create an upgrade skill for a new Flutter stable release, or asks to generate 'flutter-upgrade-X-YY'. |
flutter-upgrade-creator
このスキルは、Flutterの新しい stable バージョン（例: 3.47 など）がリリースされた際に、その特定バージョンにプロジェクトを追従・アップグレードするための専用Skill（例: flutter-upgrade-3-47）を自動生成（調査・構築）するメタスキルです。
🎯 目的と役割
ユーザーから「Flutter 3.47 へのアップグレードSkillを作って」のように特定バージョンを指定された場合、公式ドキュメントやリリース情報を網羅的に調査し、/Users/mono/Git/skills/flutter-upgrade-<major>-<minor> ディレクトリに高品質な追従Skillを出力します。
🧭 生成・調査のフロー
指定されたバージョン（例: VERSION = 3.47 または 3.47.0）を受け取ったら、以下の順序で情報を調査・抽出し、専用Skillを作成します。
Step 1: 公式リリース情報・一次ドキュメントの網羅的リサーチ
以下のURLおよび関連ページを read_url_content や search_web で読み込み・解析します。
- Flutter Announcement Blog (What's New):
https://flutter.dev/blog/whats-new-in-flutter-<major>-<minor> (例: https://flutter.dev/blog/whats-new-in-flutter-3-47) または https://blog.flutter.dev/whats-new-in-flutter-<major>-<minor>https://flutter.dev/blog?category=release- 指定バージョン（例: Flutter 3.47）の公式発表記事・What's New記事を探して全文およびURLを確認。
- Dart Release Blog:
https://dart.dev/blog- Flutterの該当バージョンに同梱されている Dart（例: Dart 3.13 / 3.7 / 3.8 など）の更新情報・ブログ記事を確認。
- Breaking Changes:
https://docs.flutter.dev/release/breaking-changes- 指定バージョンで追加された破壊的変更（非互換なAPI変更、減衰/非推奨 API、削除された機能など）を抽出。
- Specific Release Notes:
https://docs.flutter.dev/release/release-notes/release-notes-<VERSION> (例: release-notes-3.47.0 や release-notes-3.47.0.md など)- 詳細なチェンジログ、機能変更、マイグレーションコードを収集。
Step 2: 収集情報の分析・分類
リサーチした情報を以下の5つのカテゴリに整理します。
- 一次情報・公式リファレンスURL一覧:
- What's New ブログ、Release Notes、Breaking Changes、Dart ブログなどの固定直リンクを収集。
environment (sdk, flutter) caret指定バージョン下限更新方針:
- 通常プロジェクト:
pubspec.yaml の environment 指定 (例: sdk: "^3.13.0", flutter: "^3.47.0") の更新。
- Melos モノレポ: ルート
pubspec.yaml の melos.bootstrap.environment 指定の更新。
- その後
melos bs で配下全パッケージの指定を一括適用・更新する手順。
flutter create . テンプレート差分・標準構成:
- 当該バージョンで推奨される設定ファイル記述 (
analysis_options.yaml, Android Gradle Plugin / Kotlin / Gradle バージョン, iOS Xcode / Podfile 設定, Web構成など)。
- 自動修正コマンド & オプトイン/ベータ機能 (Migration code):
- 例:
dart fix --apply --code=migrate_design_widgets
- 各オプトイン/ベータ機能について以下を整理：
- 概要・何が変わるか
- メリット
- デメリット・リスク
- 推奨度（「推奨 (Recommended)」「任意 (Optional)」「慎重・確認推奨 (Caution)」）
- 動作変化の懸念点・不安要素（ランタイム影響の警告）:
- コンパイルエラーにならないが挙動が変わる変更点（UIのデフォルトスタイル変更、イベント伝播の変更、レンダリング/アニメーション仕様変更、廃止予定フラグの変更など）。
- コンパイルエラーになる明確な Breaking Changes と手動修復パターン。
- PR作成ノウハウ:
- 変更理由、テンプレート追従、適用したオプトイン機能、確認が必要な懸念事項、参考リンクを網羅するPRテンプレート。
Step 3: 特定バージョン用Skill (flutter-upgrade-X-YY/SKILL.md) の作成
/Users/mono/Git/skills/flutter-upgrade-<major>-<minor> ディレクトリを作成し、以下の構造で SKILL.md を書き出します。
生成される flutter-upgrade-X-YY/SKILL.md の標準構造
---
name: flutter-upgrade-<major>-<minor>
description: Upgrade a Flutter project to Flutter <VERSION> (e.g. 3.47). Includes official reference URLs (What's new blog, release notes, breaking changes). Handles cases whether Flutter SDK is already upgraded to <VERSION> or not. Follows latest flutter create template defaults, updates pubspec.yaml environment SDK & Flutter bounds with caret notation (^3.13.0 & ^3.47.0), configures melos.bootstrap.environment & runs melos bs if applicable, applies dart fixes, prompts for opt-in migration tools, warns about runtime breaking changes, and creates a detailed Pull Request.
---
# flutter-upgrade-<major>-<minor>
このスキルは、Flutterプロジェクトを **Flutter <VERSION>** へ安全かつスムーズに追従・アップグレードするための専用スキルです。すでにローカル環境/FVMが <VERSION> に更新済みの場合でも、未更新の場合でもスムーズに対応します。
---
## 📚 一次情報・公式リファレンス (Reference Links)
アップグレード作業時に参照すべき公式の重要情報源一覧です：
- 📢 **What's New in Flutter <VERSION> (Official Blog)**: [https://flutter.dev/blog/whats-new-in-flutter-<major>-<minor>](https://flutter.dev/blog/whats-new-in-flutter-<major>-<minor>)
- 📝 **Flutter <VERSION>.0 Release Notes**: [https://docs.flutter.dev/release/release-notes/release-notes-<VERSION>.0](https://docs.flutter.dev/release/release-notes/release-notes-<VERSION>.0)
- ⚠️ **Flutter Breaking Changes**: [https://docs.flutter.dev/release/breaking-changes](https://docs.flutter.dev/release/breaking-changes)
- 📰 **Flutter Release Category**: [https://flutter.dev/blog?category=release](https://flutter.dev/blog?category=release)
- 🎯 **Dart Blog**: [https://dart.dev/blog](https://dart.dev/blog)
---
## 🚀 実行フロー
### 1. 環境確認・Flutter SDK 昇格 / FVM 切り替え & Draft PR作成
- **現在の SDK バージョンおよび FVM 設定を確認**:
- `flutter --version` および `.fvmrc` の有無を確認。
- **バージョン昇格 / スキップ分岐**:
- **ケース A: すでに <VERSION> に更新済みの場合**:
- 「Flutter SDK はすでに <VERSION> に達しています」と出力し、昇格処理をスキップ。
- **ケース B: まだ旧バージョンの場合**:
- **FVM利用時**: `.fvmrc` を `<VERSION>.0` に更新し `fvm use <VERSION>.0` を実行。
- **グローバル Flutter 利用時**: ユーザー案内後に `flutter upgrade` を実行（または FVM 提案）。
- **Gitブランチの作成**: (`feature/mono/<VERSION_KEBAB>-upgrade`)
- **Draft PR起票**: `env -u GITHUB_TOKEN -u GH_TOKEN gh pr create --draft ...` または空コミット起票による Draft PR 作成。
### 2. `environment` バージョン更新 & `flutter create .` 最新テンプレートへの追従
- **通常プロジェクトの場合**:
- `pubspec.yaml` の `environment` 指定 (sdk, flutter ともに caret 指定 `^`) の更新 (例: `sdk: "^<DART_VERSION>"`, `flutter: "^<VERSION>.0"`).
- **モノレポ (`Melos`) プロジェクトの場合**:
- ルート `pubspec.yaml` の `melos.bootstrap.environment` に以下を設定：
```yaml
melos:
bootstrap:
environment:
sdk: "^<DART_VERSION>"
flutter: "^<VERSION>.0"
```
- その後 `melos bs` (`melos bootstrap`) を実行して、各パッケージの `environment` 指定を一括自動適用・更新。
- **`flutter create .` テンプレート差分追従**:
- 一時ディレクトリにて `flutter create --org com.example temp_app` を実行。
- `analysis_options.yaml`, `android/` (Gradle Plugin, Kotlin), `ios/` (Xcode, Podfile), `web/` の最新テンプレートへのキャッチアップ。
### 3. 自動修復とパッケージ依存関係
- `flutter pub get` （Melosの場合は `melos bs` / `melos exec -- flutter pub get`）の実行
- `dart fix --apply` による機械的修正の適用
### 4. オプトイン / ベータ機能 / Migration Fix の対話選択
ユーザーへ `ask_question` または明確な対話により、以下の移行コード/機能の適用可否をヒアリングする。
[バージョン固有のオプトイン機能一覧]
- **機能/コード**: 例: `dart fix --apply --code=...`
- **メリット**: ...
- **デメリット**: ...
- **推奨度**: (推奨 / 任意 / 慎重)
### 5. 動作変化の懸念点・不安要素（注意が必要な変更点）のチェック＆報告
コンパイルエラーにならなくても動作が変わる可能性がある事項をリストアップし、必要に応じて手動修正またはユーザーへの警告・確認を実施する。
[バージョン固有の動作変化注意点一覧]
### 6. 静的解析 & テスト検証
- `dart analyze` (または `melos run analyze`) を実行し、警告・エラーが0件であることを確認。
- `flutter test` を実行し、既存テストがパスすることを確認。
### 7. コミット & PR本文の更新
- `git-commit-formatter` を活用して Conventional Commits に従ったコミットを作成。
- 参考リンク、`environment` (sdk, flutter の caret 指定、Melos時の `melos.bootstrap.environment` 指定) のアップデート内容、テンプレート追従内容、適用したオプトイン機能、手動確認が必要な動作変更懸念事項を明記した詳細な PR 本文を作成し、PRを更新。
🛠 スキル生成の完了条件
/Users/mono/Git/skills/flutter-upgrade-<major>-<minor>/SKILL.md が正常に生成されていること。- 対象バージョンの公式リファレンスURL群（What's New ブログ・Release Notes・Breaking Changes 等）が埋め込まれていること。
pubspec.yaml の environment 指定 (sdk, flutter ともに caret 指定 ^ による引き上げ) および Melos プロジェクトでの melos.bootstrap.environment 設定と melos bs 一括反映手順が含まれていること。- リリースノート・Breaking Changes・
flutter create テンプレート更新点・オプトイン機能のメリット/デメリット・動作変化注意点が網羅されていること。
