mcpField
F
flutter-performance

flutter-performance

github.com/thienqo開発946 回インストール1 日前に更新
リポジトリ

flutter-performance について

flutter-performanceは、Flutter開発者向けのパフォーマンス調査スキルです。再現可能な測定、症状別の診断、変更前後の検証を案内します。

主な機能

  1. 01Profileモードでの再現可能な測定
  2. 02症状に応じた性能診断
  3. 03フレーム、CPU、メモリの分析
  4. 04起動時間とアプリサイズの調査
  5. 05変更前後の検証

活用シーン

  1. 01フレームのカクつきや過剰な再ビルドの調査
  2. 02起動の遅さやメモリ増加の追跡
  3. 03リリース版アプリサイズの比較
  4. 04性能変更の検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-performance

インストール後、Claude Code で/flutter-performanceを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
cases.json
references/
memory-startup-and-size.md
profile-and-frame-analysis.md

詳細

Flutter のパフォーマンス

コードを変更する前に、再現可能な操作手順を測定してください。デバッグモードでの計測結果は、リリース時のパフォーマンスを示す根拠にはなりません。

根拠を確立する

対象デバイス、Flutter のバージョン、ビルドモード、操作手順、データセット、指標を記録してください。ユーザーに影響する問題の場合は、代表的なハードウェアでプロファイルモードを使って再現してください。

症状から診断する

  • フレームのカクつき:UI/ラスタリングの処理時間、コストの高いビルド/レイアウト/ペイント、シェーダーや画像の処理を調べます。
  • 過剰な再ビルド:機械的に const を追加する前に、状態のサブスクリプション範囲とウィジェットの同一性を調べます。
  • 起動の遅さ:初期化をトレースし、最初の有用なフレームに不要な処理を後回しにします。
  • メモリの増加:同じ操作を繰り返したときのスナップショットを比較し、解放されずに保持されている所有オブジェクト、リスナー、コントローラー、キャッシュを特定します。
  • バイナリサイズの増大:Flutter のアプリサイズ分析を使用し、条件を揃えたリリース成果物を比較します。
  • Dart の CPU 負荷の高い処理:タイムライン/CPU プロファイリングを使用し、処理箇所を特定してからアイソレートの使用を検討します。

すべてをキャッシュするより、処理を削除または別の箇所に移すことを優先してください。キャッシュのサイズに上限を設け、正確性を維持してください。

フレーム、CPU、画像、再ビルド、ウェブレンダリングの調査では、プロファイルとフレーム分析を読み込んでください。オブジェクトの保持、最初の有用なフレーム、成果物のサイズに関する作業では、メモリ、起動、サイズを読み込んでください。

検証

変更後に同じシナリオを繰り返し、ばらつきも含めて変更前後の根拠を報告してください。パフォーマンスの変更はライフサイクルやキャッシュの動作に影響することが多いため、正確性のテストも実行してください。

参考資料

コメント