mcpField
F
flutter-audit

flutter-audit

github.com/musabekisakov-imjデザイン・UI445 回インストール14 週間前に更新
リポジトリ

flutter-audit について

Flutter UI Auditは、変更を提案する前にFlutter UIの問題を診断する読み取り専用スキルです。実装と描画状態を調べ、影響度順に指摘を整理し、観察事実と視覚的評価を区別します。

主な機能

  1. 01画面・状態・ナビゲーション・テストの確認
  2. 02アクセシビリティとレスポンシブレイアウトの評価
  3. 03読み込みやエラーなど各状態の確認
  4. 04影響度に基づく指摘の優先順位付け
  5. 05根拠の提示と改善案

活用シーン

  1. 01再設計前のFlutter画面監査
  2. 02アクセシビリティと適応動作の評価
  3. 03UI状態や復旧手順の不足の特定

インストール

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

$npx skills add https://github.com/musabekisakov-imj/flutter-design-engineer --skill flutter-audit

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

同梱ファイル

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

agents/
openai.yaml
references/
anti-slop.md
connected-product-workflows.md
layout-and-density.md
visual-qa.md

詳細

Flutter UI 監査

改善策を提案する前に、まず問題を診断します。ユーザーから変更を求められない限り、監査作業は読み取り専用で行います。

調査

  1. 画面、関連する状態、ナビゲーション、テーマ、共有ウィジェット、テストを確認します。
  2. 利用できる場合は、アプリを実行するかスクリーンショットを確認します。観察ごとに、ビューポート、テーマ、ロケール、状態を記録します。
  3. 次の項目を評価します。
    • プロダクトの目標と主要なアクション
    • 情報の優先順位、グループ化、視線の流れ、情報密度、タイポグラフィ、色、サーフェスの使い方
    • ナビゲーション、フォーム、フィードバック、破壊的な操作、復旧手段
    • 読み込み中、空、一部表示、エラー、オフライン、成功の各状態
    • コンパクトおよび拡張レイアウト
    • セマンティクス、フォーカス、テキストの拡大縮小、コントラスト、タッチターゲット、RTL、モーションの低減
    • ウィジェットの境界、ハードコードされた寸法、再ビルドの範囲、テーマの一貫性
  4. 該当する確認項目について、references/anti-slop.md、references/layout-and-density.md、references/visual-qa.md を読みます。 複数の領域にまたがる画面の場合は、references/connected-product-workflows.md も読み、単にカードが隣接しているだけではないことを確認します。

優先順位付け

指摘事項を分類します。

  • P0:主要なタスクを妨げる、データ損失やセキュリティ上のリスクを生む、またはインターフェースを使用不能にする問題。
  • P1:理解しやすさ、アクセシビリティ、タスクの完了、または適応動作を大きく損なう問題。
  • P2:タスクを妨げることなく、一貫性、仕上がり、または保守性を損なう問題。
  • P3:ユーザーへの影響が限定的な任意の改善。

対応可能な指摘事項ごとに、該当する画面や状態、および関連ファイルやレンダリング結果の根拠を示します。ユーザーへの影響と、実効性のある最小限の改善策を説明します。事実と視覚的な評価を区別します。

提示内容

長いチェックリストではなく、影響が最も大きい傾向から説明します。維持すべき長所、優先順位を付けた指摘事項、不足している証拠、推奨する対応順を含めます。レンダリングまたは確認していない状態を、検証済みであるかのように示さないでください。

コメント