flutter-visual-qa について
flutter-visual-qaは、Flutter製品向けのビジュアル品質確認スキルです。ソースの確認だけでなく実際の描画結果を根拠とし、代表的なマトリクス、優先度別の基準、ゴールデンテストで検証を進めます。
主な機能
- 01レイアウト・テーマ・状態別の確認マトリクス
- 02ビューポート・ピクセル比・テストデータの記録
- 03影響度に基づく描画不具合の優先付け
- 04決定的なデータを用いたゴールデンテスト
- 05修正後の再撮影と結果の報告
活用シーン
- 01異なる制約やテーマでの画面確認
- 02読み込み・空・エラー状態のレビュー
- 03ローカライズ製品のRTLと拡大文字の確認
- 04安定したコンポーネントの視覚的回帰検出
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ musabekisakov-imj/ flutter-design-engineer --skill flutter-visual-qaインストール後、Claude Code で/flutter-visual-qaを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/connected-product-workflows.mdvisual-qa.md詳細
Flutter のビジュアル QA
描画結果が証拠です。ソースを確認するだけでは、視覚的な品質を判断できません。
マトリックスを作成する
次の項目を網羅する、最小限の代表的なマトリックスを選択します。
- コンパクトな制約と拡張された制約;
- 対応している場合は、ライトテーマとダークテーマ;
- 該当する場合は、通常、読み込み中、空、エラー、破壊的な状態;
- デフォルトのテキストサイズと拡大したテキストサイズ;
- ローカライズされた製品では、LTR と RTL。
ビューポート、デバイスピクセル比、テーマ、ロケール、フィクスチャの状態を正確に記録します。references/visual-qa.md をお読みください。
接続型または複数ドメインの製品では、references/connected-product-workflows.md もお読みになり、部分的なソース障害をマトリックスに含めてください。
確認する
まず階層と視線の流れを確認し、次にレイアウト、文字、間隔のリズム、色の役割、コントロール、コンテンツの現実性、端の挙動、ピクセルレベルの不具合を確認します。関連する状態を並べて比較します。実装上の不具合と主観的な好みを区別します。
優先順位:
- タスクを妨げるクリッピング、重なり、非表示、または到達不能なコントロール;
- 階層、コントラスト、状態の伝達、または適応的な構成の破綻;
- 一貫性のなさや仕上げの不備;
- 任意の美的な改善。
ゴールデンテスト
安定したコンポーネントと決定論的なフィクスチャには、ゴールデンテストを使用します。フォント、アニメーション、時刻、ネットワークコンテンツ、ピクセル比を制御してください。差分を確認せずに、広範囲なゴールデンテストの更新を承認しないでください。
最後まで確認する
重大な指摘については、少なくとも1回の改善サイクルを行い、影響を受ける状態を再キャプチャするよう求めます。確認したマトリックス、実施した修正、未検証の組み合わせ、成果物のパスを報告します。