ccpocket: Skill for Claude Code

Flutter Upgrade

Flutter SDKの新バージョンへのアップグレードを体系的に進めるスキル。 リリースノート調査からコード修正・検証まで一貫して対応する。

フェーズ1: 情報収集

1-1. リリースノート調査

WebSearch / WebFetch で以下を調査する:

• Hotfix Issue: https://github.com/flutter/flutter/issues で [stable] [hotfix] Flutter Release Version X.Y.Z を検索
• Release Notes: https://docs.flutter.dev/release/release-notes/release-notes-X.Y.0
• Breaking Changes: https://docs.flutter.dev/release/breaking-changes
• Flutter blog: https://blog.flutter.dev の What's new 記事
• CHANGELOG: https://github.com/flutter/flutter/blob/master/CHANGELOG.md

hotfix リリース (X.Y.1〜) の場合、メジャーリリース (X.Y.0) の Breaking Changes も含めて調査する。

1-2. 現在のプロジェクト状態を確認

# 現在のFlutterバージョン
flutter --version

# mise管理のバージョン
cat .mise.toml

# Dart SDK制約
grep -A1 'environment:' apps/mobile/pubspec.yaml

フェーズ2: プロジェクト影響分析

2-1. Breaking Changes のコードベースマッチング

リリースノートで見つかった Breaking Changes / 非推奨API それぞれについて、 Grep でコードベース内の使用箇所を検索する。

Grep pattern="<deprecated_api>" path="apps/mobile" glob="*.dart"

該当なし → 対応不要と明記。該当あり → ファイルと箇所数を記録。

2-2. プロジェクト固有の影響チェック

このプロジェクトには以下の固有構成があり、それぞれ確認が必要:

mise (バージョン管理)

• .mise.toml の flutter バージョンを更新する必要がある
• グローバルにも反映する (mise use --global)

CI/CD (GitHub Actions)

• 全ワークフローが .mise.toml から Flutter バージョンを読み取る仕組み (grep 'flutter' .mise.toml → flutter-action の flutter-version)
• .mise.toml を更新すれば全ワークフローに自動反映される
• ワークフロー一覧を Grep で確認し、変更が正しく伝播するか確認する

grep -r "mise.toml" .github/workflows/

Shorebird (OTA パッチ)

• Shorebird はリリース時の Flutter バージョンでビルドを管理する
• 既存リリースへのパッチは旧バージョンで行う必要がある
• 新バージョンで新リリースを作る場合は問題ない
• shorebird doctor で互換性を確認する

dependency_overrides (一時的フォーク)

• pubspec.yaml の dependency_overrides セクションを確認
• 各オーバーライドが本家にマージ済み / pub.dev にリリース済みなら削除できるか調査
• WebSearch で最新状況を確認する

パッケージ互換性

• flutter pub outdated で非互換パッケージがないか確認
• 特に Shorebird, Firebase, google_fonts など Flutter バージョンに敏感なパッケージに注意

2-3. Dart SDK 制約

• pubspec.yaml の environment.sdk が新バージョン同梱の Dart と互換か確認
• 非互換なら SDK 制約の更新も必要