使い方ガイドへスキップ
Break UI作者 Emil Kowalski

Break UI スキル。

見栄えのよいデモデータが隠してしまうインターフェースの不具合を見つけます。Break UIは、実際のコンポーネントをありそうな極端な値でテストし、デザインを変更する前に壊れた箇所を提示する方法を、コーディングエージェントに提供します。

  • UIストレステスト
  • エッジケース用フィクスチャ
  • レビューレポート
ソースレビュー · break-uiSKILL.md
タスク デザインレビューとアクセシビリティ 成果物 • ソース、上限、任意の値を記載したフィールド一覧 • 最悪ケースのフィクスチャと、開発専用のデータセット切り替え • 優先度付きの不具合、修正案、オーナーが判断すべき事項 開始前に コンポーネントのソース、既存のデモデータ、フィールドの上限。目視確認用に、動作するアプリとブラウザ。
編集部による要約 · ソース確認日 2026-10-12 · 生成された例ではありません

01 機能

失敗を模造せず、コンポーネントそのものをテストする

このワークフローは、固定されたソースに記載されているものです。実行の記録でもベンチマークでもありません。

ソースに基づくワークフロー実行ベンチマークではありません

作業の進め方

メンバー一覧は短い名前なら問題なく動いても、メールアドレスが長いとアクションメニューが失われることがあります。Break UIは、表示される値をすべてprops、フィクスチャ、またはAPIデータまでさかのぼり、許容される上限を確認したうえで、その同じ境界でデータを置き換えます。失敗を作り出すためだけにレイアウトを変更することはありません。

比較は検証しやすい形を保ちます。デモデータと最悪ケースのデータを切り替えられ、必要に応じて空、1件、大量リストの状態も別々に用意します。レポートでは、読めない・到達できない内容、見た目の崩れ、壊れやすい前提を区別し、すでに問題なく動作した点も記録します。

想定される成果物

  • ソース、上限、任意の値を記載したフィールド一覧
  • 最悪ケースのフィクスチャと、開発専用のデータセット切り替え
  • 優先度付きの不具合、修正案、オーナーが判断すべき事項
サンプルブリーフを見る

入力から検出結果まで

  1. 01
    表示されるすべての値をマッピングする

    コンポーネント、検証ルール、APIの形状を読み取ります。テキスト入力だけでなく、件数、バッジ、画像、リストの長さを含め、上限と欠損時の挙動を記録します。

  2. 02
    現実味のあるエッジケースを作る

    長い名前、短い名前、欠損フィールド、ローカライズされたラベルを、既存データと同じ形のフィクスチャに組み合わせます。上限が分かっている場合はスキーマの上限を使い、上限のないフィールドは上限を作り出さず、その旨を記録します。

  3. 03
    実際のサイズで比較する

    切り替え機能は開発環境またはプロトタイプのルートに置きます。コンポーネントの実際のコンテナ、320px、最も広いレイアウト、拡大したテキストで確認し、製品が対応していればダークモードとRTLも含めます。

  4. 04
    直す前に報告する

    各不具合に、重大度、引き金となった値、修正案、ファイルの場所を示します。折り返しか省略かといった判断が必要な場合は、そこで止まります。修正は依頼があった場合のみ適用し、その後でデモ状態と極端な状態を再テストします。

02 使う場面

使う場面

内容が変化する既存のコンポーネントに使います。これはデータへの耐性を確認するレビューであり、見た目の再デザインではありません。

向いているケース

  • 密度の高いリストとカードメンバー行、検索結果、ファイルカードでは、名前、メタデータ、バッジ、アクションが限られたスペースを取り合います。
  • ローカライズされたインターフェース長い翻訳ラベル、ラテン文字以外の名前、対応しているRTLレイアウトは、英語のデモテキストでは見逃す前提を明らかにします。
  • 空のコレクションと大きなコレクション0件、1件、ページサイズの境界、現実的な大量リストを確認します。複数形の扱いやスクロールの挙動も含みます。

確認すべき限界

  • 好みの批評ではありませんこのスキルは、新しいビジュアルの方向性を選んだり、コンポーネントを再デザインしたりしません。検出結果は、現実的なデータと既存のデザインに関するものです。
  • 製品に関する判断は自動では行いませんフィールドを折り返すか、省略するか、非表示にするかは、オーナーの判断が必要な場合があります。標準のワークフローでは、まず報告し、修正を適用する前に止まります。
  • 視覚的な証拠にはブラウザが必要ですソースのみのレビューではリスクは特定できますが、ユーザーに実際に何が見えるかは証明できません。ソースでは、推測による指摘と、目視で確認した不具合を区別することが求められています。

用意する入力

  • 実際のコンポーネントコンポーネントまたは画面、通常使われるコンテナ、動作するローカルルートを用意してください。スクリーンショットだけでは、データの境界や検証上の上限は分かりません。
  • データの形状と上限デモ用フィクスチャ、props、またはAPIの型、検証ルール、任意フィールドを含めてください。合成レコードで十分です。実際の顧客データは渡さないでください。
  • 対応する状態と環境リストの最大件数、対応言語、ダークモードとRTLの要件を示してください。依頼がレポートのみか、承認済みの修正を含むかも明記します。

03 重要な判断

重要な判断

  1. フィクスチャは実際の境界から入れる

    propやモックレスポンスを変更すれば、コンポーネントの挙動をテストできます。無理に壊すためにマークアップやCSSを編集すると、別のコンポーネントをテストすることになります。

  2. 短い値や欠損値も対象です

    1文字の名前、アバターなし、件数1といったケースは、長い文字列では決して現れないイニシャル、フォールバック、複数形の不具合を明らかにします。

  3. 最悪ケースは回帰テスト用フィクスチャになる

    承認された修正の後も、フィクスチャを残して今後の確認に使い、通常のデータと比較します。切り替え機能は開発専用のままにし、本番にリリースしてはいけません。

04 焦点を絞ったブリーフを試す

焦点を絞ったブリーフを試す

以下のサンプルブリーフは未テストです。使用前に、スキルのセットアップを確認してください。

セットアップを確認する

Emil Kowalskiの公開スキルリポジトリからインストールし、エージェントにこのスキルを選択します。

範囲指定のインストールコマンド
npx skills@latest add emilkowalski/skills --skill break-ui

READMEには、npx skills@latest add emilkowalski/skillsでのリポジトリのインストール方法が記載されています。以下の範囲指定コマンドは、このエントリーを選択します。npxにはNode.js/npmが必要ですが、ソースでは最低バージョンは指定されていません。実行前に上流の手順を確認してください。

データ駆動のコンポーネント1つから始める

このサンプルブリーフは独自に作成した未テストのものです。コンポーネントや環境の詳細は、実際のプロジェクトに合わせて置き換えてください。

サンプルブリーフ
既存のプロトタイプルートにあるMemberListコンポーネントでbreak-uiを使ってください。まずpropの型と検証上の上限を確認します。合成のデモ用フィクスチャと現実的な最悪ケースのフィクスチャを作成し、長い名前と1文字の名前、長いexample.comのメールアドレス、アバターとロールの欠損、対応しているラテン文字以外のテキストを含めてください。空の状態と1人だけの状態に加え、コードから分かる現実的なリスト上限も追加します。データセット切り替えは開発専用とし、テスト中はコンポーネントのマークアップとスタイルを保持してください。実際のサイドバー幅、320px、対応する最も広いレイアウト、200%ズームで確認します。不具合は、ファイルの場所、修正案、必要な判断とともに報告してください。ブラウザで確認した結果とコードに基づくリスクを分け、問題なかった点も記録し、まだ修正は適用しないでください。

修正前に根拠を確認する

レポートをコードと実際のブラウザでの挙動に照らして確認してください。未検証の観察と、再現した不具合は分けて扱います。

  • テストする各フィールドには、実在するソースと、文書化された上限または明示的な不明の記載がある。
  • データの切り替えは同じコンポーネント境界に届き、切り替え用コントロールは開発環境またはプロトタイプに限定されている。
  • 検出結果には、失敗した値、場所、根拠が含まれ、通常データと合格したケースも省かれていない。

OpenDesignは、コーディングエージェント向けのローカルなデザインワークスペースを提供します。この掲載は、スキルが同梱されていること、または外部ツール、認証情報、ソフトウェア依存関係が含まれていることを意味するものではありません。

05 ソースとライセンス

ソースとライセンス

このページは、下記にリンクされた固定ソースのリビジョンについて説明しています。上流の挙動や要件は変更される可能性があります。

ソースの所有者
Emil Kowalski
リポジトリ
emilkowalski/skills
スキルファイル
skills/break-ui/SKILL.md
ライセンス
MIT
確認したスナップショット
2026-10-12 · 2d228630ba14
編集部によるソース要約
現実的な極端データと開発専用の比較トグルで既存UIをストレステストし、修正の前に失敗を報告します。これは固定ソースの編集部による要約であり、実行レポートではありません。

リンク先のソースに基づく、OpenDesignによる独自の要約です。リポジトリのスター数は日付付きの人気の指標であり、スキルの利用状況や品質スコアではありません。

06 始める前の質問

始める前の質問

Break UIはコンポーネントを自動で修正しますか?

標準では修正しません。不具合と修正案を報告し、その後は待機します。ソースでは、明示的に修正を依頼することにも対応していますが、正解が複数ある判断事項は、やはり解決が必要です。

長いテキストだけをテストするのですか?

いいえ。カタログは、欠損値、数値、コレクション、時間、メディア、状態、環境を扱います。空のリストや1件のリストは別々のケースであり、長いテキストのフィクスチャで代用するものではありません。

プロジェクトなしで実行できますか?

ソースでは、単体のコンポーネントと、自己完結したHTMLによる比較が認められています。ブラウザにアクセスできない場合、検出結果は目視で確認したものではなく、推測としてマークする必要があります。

Break UI

デモが想定しなかったデータを試す

1つのコンポーネントと、現実的な合成レコードから始めます。失敗した点を確認し、修正を選び、次の変更に備えてフィクスチャを残します。

範囲指定のインストールコマンド
npx skills@latest add emilkowalski/skills --skill break-ui