flutter-audit について
Flutter UI Auditは、変更を提案する前にFlutter UIの問題を診断する読み取り専用スキルです。実装と描画状態を調べ、影響度順に指摘を整理し、観察事実と視覚的評価を区別します。
主な機能
- 01画面・状態・ナビゲーション・テストの確認
- 02アクセシビリティとレスポンシブレイアウトの評価
- 03読み込みやエラーなど各状態の確認
- 04影響度に基づく指摘の優先順位付け
- 05根拠の提示と改善案
活用シーン
- 01再設計前のFlutter画面監査
- 02アクセシビリティと適応動作の評価
- 03UI状態や復旧手順の不足の特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ musabekisakov-imj/ flutter-design-engineer --skill flutter-auditインストール後、Claude Code で/flutter-auditを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/anti-slop.mdconnected-product-workflows.mdlayout-and-density.mdvisual-qa.md詳細
Flutter UI 監査
改善策を提案する前に、まず問題を診断します。ユーザーから変更を求められない限り、監査作業は読み取り専用で行います。
調査
- 画面、関連する状態、ナビゲーション、テーマ、共有ウィジェット、テストを確認します。
- 利用できる場合は、アプリを実行するかスクリーンショットを確認します。観察ごとに、ビューポート、テーマ、ロケール、状態を記録します。
- 次の項目を評価します。
- プロダクトの目標と主要なアクション
- 情報の優先順位、グループ化、視線の流れ、情報密度、タイポグラフィ、色、サーフェスの使い方
- ナビゲーション、フォーム、フィードバック、破壊的な操作、復旧手段
- 読み込み中、空、一部表示、エラー、オフライン、成功の各状態
- コンパクトおよび拡張レイアウト
- セマンティクス、フォーカス、テキストの拡大縮小、コントラスト、タッチターゲット、RTL、モーションの低減
- ウィジェットの境界、ハードコードされた寸法、再ビルドの範囲、テーマの一貫性
- 該当する確認項目について、
references/anti-slop.md、references/layout-and-density.md、references/visual-qa.mdを読みます。 複数の領域にまたがる画面の場合は、references/connected-product-workflows.mdも読み、単にカードが隣接しているだけではないことを確認します。
優先順位付け
指摘事項を分類します。
- P0:主要なタスクを妨げる、データ損失やセキュリティ上のリスクを生む、またはインターフェースを使用不能にする問題。
- P1:理解しやすさ、アクセシビリティ、タスクの完了、または適応動作を大きく損なう問題。
- P2:タスクを妨げることなく、一貫性、仕上がり、または保守性を損なう問題。
- P3:ユーザーへの影響が限定的な任意の改善。
対応可能な指摘事項ごとに、該当する画面や状態、および関連ファイルやレンダリング結果の根拠を示します。ユーザーへの影響と、実効性のある最小限の改善策を説明します。事実と視覚的な評価を区別します。
提示内容
長いチェックリストではなく、影響が最も大きい傾向から説明します。維持すべき長所、優先順位を付けた指摘事項、不足している証拠、推奨する対応順を含めます。レンダリングまたは確認していない状態を、検証済みであるかのように示さないでください。
コメント
Markdown 対応