菜单
Flutter SDKバージョンアップグレード対応。新バージョンのリリースノート・Breaking Changes調査、コードベース影響分析、mise/CI/Shorebird含むプロジェクト全体の対応タスクリスト作成と実行。「Flutterアップグレード」「Flutter X.Y.Zがリリースされた」「Flutter最新化」「Flutter更新」と言われたとき、またはFlutterの新バージョンについて言及されたときに使用する。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | flutter-upgrade |
| description | Flutter SDKバージョンアップグレード対応。新バージョンのリリースノート・Breaking Changes調査、コードベース影響分析、mise/CI/Shorebird含むプロジェクト全体の対応タスクリスト作成と実行。「Flutterアップグレード」「Flutter X.Y.Zがリリースされた」「Flutter最新化」「Flutter更新」と言われたとき、またはFlutterの新バージョンについて言及されたときに使用する。 |
Flutter SDKの新バージョンへのアップグレードを体系的に進めるスキル。 リリースノート調査からコード修正・検証まで一貫して対応する。
WebSearch / WebFetch で以下を調査する:
https://github.com/flutter/flutter/issues で [stable] [hotfix] Flutter Release Version X.Y.Z を検索https://docs.flutter.dev/release/release-notes/release-notes-X.Y.0https://docs.flutter.dev/release/breaking-changeshttps://blog.flutter.dev の What's new 記事https://github.com/flutter/flutter/blob/master/CHANGELOG.mdhotfix リリース (X.Y.1〜) の場合、メジャーリリース (X.Y.0) の Breaking Changes も含めて調査する。
# 現在のFlutterバージョン
flutter --version
# mise管理のバージョン
cat .mise.toml
# Dart SDK制約
grep -A1 'environment:' apps/mobile/pubspec.yaml
リリースノートで見つかった Breaking Changes / 非推奨API それぞれについて、
Grep でコードベース内の使用箇所を検索する。
Grep pattern="<deprecated_api>" path="apps/mobile" glob="*.dart"
該当なし → 対応不要と明記。該当あり → ファイルと箇所数を記録。
このプロジェクトには以下の固有構成があり、それぞれ確認が必要:
.mise.toml の flutter バージョンを更新する必要があるmise use --global).mise.toml から Flutter バージョンを読み取る仕組み
(grep 'flutter' .mise.toml → flutter-action の flutter-version).mise.toml を更新すれば全ワークフローに自動反映されるGrep で確認し、変更が正しく伝播するか確認するgrep -r "mise.toml" .github/workflows/
shorebird doctor で互換性を確認するpubspec.yaml の dependency_overrides セクションを確認flutter pub outdated で非互換パッケージがないか確認pubspec.yaml の environment.sdk が新バージョン同梱の Dart と互換か確認調査結果を以下の形式でまとめる:
## Flutter X.Y.Z アップグレード対応リスト
### 必須（アップグレードに必要）
1. `.mise.toml` の Flutter バージョン更新
2. `mise install flutter@X.Y.Z && mise use --global flutter@X.Y.Z`
3. `flutter pub get` → `dart analyze` → `flutter test`
4. [Breaking Changes で必要な修正があればここに]
### 推奨（非推奨API解消）
- [非推奨APIの移行タスク]
### 確認（視覚的・動作確認）
- [テーマ色の変化、フォント描画の変化など]
### 棚卸し（dependency_overrides等）
- [削除可能なオーバーライド]
- [更新可能なパッケージ]
影響がないものも「該当なし」と明記し、調査漏れがないことを示す。
ユーザーの確認を得てから実行に移る。
# .mise.toml 編集（Edit ツールで）
# flutter = "旧バージョン" → "新バージョン"
# インストール & グローバル反映
mise install flutter@X.Y.Z
mise use --global flutter@X.Y.Z
# 確認
flutter --version
cd apps/mobile && flutter pub get
dart analyze apps/mobile
cd apps/mobile && flutter test
Breaking Changes や非推奨API の修正を実施。
変更内容に応じて /test-flutter や /mobile-automation を実行。
アプリのリリース（バージョンbump + CHANGELOG + タグ → GH Actions で自動ビルド・配布）。iOS / Android / macOS / Linux / Windows の任意の組み合わせでリリースできる。「リリース」「バージョン上げて」「リリースして」と言われたときに使う。
ccpocket の X 向けリリース告知カード画像を作成・更新する。最新の iOS/Android/macOS リリースタグ、App Store release_notes、既存の scripts/release-card/generate.mjs を使って英語・日本語の告知PNGを生成し、画像を目視確認して不備があれば生成スクリプトを修正する。「リリースカード」「X告知画像」「リリース報告用画像」「release-card」と言われたときに使用する。
ストア情報の更新自動化 — スクリーンショット撮影（シミュレーター × モック画面 × Marionette MCP）とメタデータテキスト更新。ストア更新、スクショ更新、App Store / Google Play のメタデータ更新、リリースノート作成の際に使用すること。
Codex の使い方、CLI/app/IDE、rules・hooks・AGENTS.md・skills・subagents・config などを案内する。Codex や OpenAI 製品の仕様を答える前に必ず公式ドキュメントを確認し、rules/approval は `codex execpolicy check` で実検証すること。
MCP (dart-mcp + Marionette) を使ったFlutterアプリのE2E自動化・UI検証ガイド。シミュレーターでのUI動作確認、モックプレビュー検証、Bridge経由のE2Eテスト、スクリーンショット撮影など、アプリの動作検証が必要なときに使う。「動作確認して」「UIを検証して」「E2Eテスト」「シミュレーターで確認」「モックで確認」と言われたときや、UI変更後の検証フェーズで使用すること。
GitHub Issue・PRのトリアージ。番号を渡すと、要望の要約・実現難易度・既存機能との重複チェック・対応判断を調査してレポートする。Issue/PRの番号が出てきたとき、トリアージ、優先度判断、対応判断と言われたときに使用する。