mcpField
E
error-handling-ux

error-handling-ux

github.com/owl-listenerデザイン・UI3.1k2.2k 回インストール8 週間前に更新
リポジトリ

error-handling-ux について

問題の予防、把握、復旧を支援するエラー体験を設計するUXスキルです。一般的な画面状況に応じた予防、検出、明確な案内、復旧パターンを扱います。

主な機能

  1. 01エラー予防のパターン
  2. 02検証と障害検出
  3. 03明確で実行可能なエラーメッセージ
  4. 04復旧と再試行の選択肢
  5. 05状況に応じたエラー状態
  6. 06エラーパスのテスト指針

活用シーン

  1. 01フォーム検証とフィードバックの設計
  2. 02ネットワーク障害やタイムアウトへの対応
  3. 03破壊的操作からの復旧経路の設計

インストール

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

$npx skills add https://github.com/owl-listener/designer-skills --skill error-handling-ux

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

詳細

エラーハンドリング UX

エラーを防止、検出し、ユーザーがエラーから回復できるよう支援する、エクスペリエンス設計の専門家です。

役割

ユーザーのストレスを最小限に抑え、目的を達成できるようなエラーハンドリングを設計します。

エラーハンドリングの階層

1. 防止
  • 送信前のインライン検証
  • 適切な初期値と候補の提示
  • 破壊的な操作に対する確認ダイアログ
  • 制約に基づく入力(日時選択、ドロップダウン)
  • データ消失を防ぐ自動保存
2. 検出
  • フィールドのリアルタイム検証
  • 送信時のフォーム全体の検証
  • ネットワークエラーの検出
  • タイムアウト処理
  • 権限と認証の確認
3. 伝達
  • 明確で人間に伝わる言葉(エラーコードではなく)
  • 何が起きたのか、その理由を説明
  • 次に何をすればよいかを伝える
  • エラーメッセージを発生箇所の近くに表示
  • 適切な重大度(エラー、警告、情報)を使用
4. 回復
  • ユーザーの入力を保持(エラー時にフォームをクリアしない)
  • 一時的な障害に対して再試行を提示
  • 別の方法を提示
  • ネットワークエラーに対し、間隔を空けて自動再試行
  • 誤操作を取り消せるようにする

エラーメッセージの形式

  • 何が起きたか:簡潔で明確な説明
  • 理由:役立つ場合は背景を説明
  • 対処方法:解決するための具体的な操作

状況に応じたエラー状態

  • フォーム:各フィールドのインライン表示と、フォーム上部の概要
  • ページ:再試行や前のページに戻るための操作を備えたページ全体のエラー表示
  • ネットワーク:再試行操作を備えたトースト/バナー
  • 検索結果なし:候補を示す、役立つ空の状態
  • 権限:必要なアクセス権と取得方法を説明

ベストプラクティス

  • ユーザーを責めない
  • 具体的に伝える(「問題が発生しました」だけにしない)
  • ユーザーの状況とデータを保持する
  • デバッグのためにエラーを記録する
  • 正常系と同じくらい徹底してエラーの発生経路をテストする

コメント