Flutter Upgrade Creator

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'.

mono0926 d84be6a 11.1 KB Updated Sep 17, 2026

Coding & Dev Tools

Install

Press C to copy

$ npx skillmds@latest add mono0926/flutter-upgrade-creator

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

Download SKILL.md

＋ Add to collection

README badge

[![SkillMD](https://skillmd.com/badge/mono0926/flutter-upgrade-creator.svg)](https://skillmd.com/skills/mono0926/flutter-upgrade-creator)

Trust & safety

Audits pending

Not yet audited · commit d84be6a

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

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 テンプレート更新点・オプトイン機能のメリット/デメリット・動作変化注意点が網羅されていること。

---name: flutter-upgrade-creatordescription: 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` で読み込み・解析します。1. **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を確認。2. **Dart Release Blog**: - `https://dart.dev/blog` - Flutterの該当バージョンに同梱されている Dart（例: Dart 3.13 / 3.7 / 3.8 など）の更新情報・ブログ記事を確認。3. **Breaking Changes**: - `https://docs.flutter.dev/release/breaking-changes` - 指定バージョンで追加された破壊的変更（非互換なAPI変更、減衰/非推奨 API、削除された機能など）を抽出。4. **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つのカテゴリに整理します。1. **一次情報・公式リファレンスURL一覧**: - What's New ブログ、Release Notes、Breaking Changes、Dart ブログなどの固定直リンクを収集。2. **`environment` (sdk, flutter) caret指定バージョン下限更新方針**: - 通常プロジェクト: `pubspec.yaml` の `environment` 指定 (例: `sdk: "^3.13.0"`, `flutter: "^3.47.0"`) の更新。 - Melos モノレポ: ルート `pubspec.yaml` の `melos.bootstrap.environment` 指定の更新。 - その後 `melos bs` で配下全パッケージの指定を一括適用・更新する手順。3. **`flutter create .` テンプレート差分・標準構成**: - 当該バージョンで推奨される設定ファイル記述 (`analysis_options.yaml`, Android Gradle Plugin / Kotlin / Gradle バージョン, iOS Xcode / Podfile 設定, Web構成など)。4. **自動修正コマンド & オプトイン/ベータ機能 (Migration code)**: - 例: `dart fix --apply --code=migrate_design_widgets` - 各オプトイン/ベータ機能について以下を整理： - **概要・何が変わるか** - **メリット** - **デメリット・リスク** - **推奨度**（「推奨 (Recommended)」「任意 (Optional)」「慎重・確認推奨 (Caution)」）5. **動作変化の懸念点・不安要素（ランタイム影響の警告）**: - **コンパイルエラーにならないが挙動が変わる変更点**（UIのデフォルトスタイル変更、イベント伝播の変更、レンダリング/アニメーション仕様変更、廃止予定フラグの変更など）。 - コンパイルエラーになる明確な Breaking Changes と手動修復パターン。6. **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` の標準構造```markdown---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を更新。```---## 🛠 スキル生成の完了条件1. `/Users/mono/Git/skills/flutter-upgrade-<major>-<minor>/SKILL.md` が正常に生成されていること。2. 対象バージョンの公式リファレンスURL群（What's New ブログ・Release Notes・Breaking Changes 等）が埋め込まれていること。3. `pubspec.yaml` の `environment` 指定 (sdk, flutter ともに caret 指定 `^` による引き上げ) および Melos プロジェクトでの `melos.bootstrap.environment` 設定と `melos bs` 一括反映手順が含まれていること。4. リリースノート・Breaking Changes・`flutter create` テンプレート更新点・オプトイン機能のメリット/デメリット・動作変化注意点が網羅されていること。

mono0926/skills/tree/main/flutter-upgrade-creator commit d84be6a4f0

Frequently asked questions

npx skillmds@latest add mono0926/flutter-upgrade-creator