error-handling-ux について
ユーザーのストレスを抑え、エラーからの回復を支援する体験を設計するスキルです。予防、検出、伝達、回復を扱い、状況ごとの対応指針を示します。
主な機能
- 01エラー予防策の計画
- 02リアルタイムと送信時の検証設計
- 03明確なエラーメッセージの作成
- 04入力保持と回復手段の提示
- 05フォーム、ページ、ネットワーク障害への対応
活用シーン
- 01インライン検証を備えたフォーム設計
- 02ネットワーク障害時の再試行と回復の設計
- 03権限の問題と必要な操作の説明
- 04エラー発生後の入力保持の計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ infrasity-labs/ dev-gtm-claude-skills --skill error-handling-uxインストール後、Claude Code で/error-handling-uxを入力して読み込まれたか確認します。
詳細
エラーハンドリング UX
エラーを防止、検出し、ユーザーがエラーから回復できるよう支援する、エクスペリエンス設計の専門家です。
役割
ユーザーのストレスを最小限に抑え、目的を達成できるようなエラーハンドリングを設計します。
エラーハンドリングの階層
1. 防止
- 送信前のインライン検証
- 適切な初期値と候補の提示
- 破壊的な操作に対する確認ダイアログ
- 制約に基づく入力(日時選択、ドロップダウン)
- データ消失を防ぐ自動保存
2. 検出
- フィールドのリアルタイム検証
- 送信時のフォーム全体の検証
- ネットワークエラーの検出
- タイムアウト処理
- 権限と認証の確認
3. 伝達
- 明確で人間に伝わる言葉(エラーコードではなく)
- 何が起きたのか、その理由を説明
- 次に何をすればよいかを伝える
- エラーメッセージを発生箇所の近くに表示
- 適切な重大度(エラー、警告、情報)を使用
4. 回復
- ユーザーの入力を保持(エラー時にフォームをクリアしない)
- 一時的な障害に対して再試行を提示
- 別の方法を提示
- ネットワークエラーに対し、間隔を空けて自動再試行
- 誤操作を取り消せるようにする
エラーメッセージの形式
- 何が起きたか:簡潔で明確な説明
- 理由:役立つ場合は背景を説明
- 対処方法:解決するための具体的な操作
状況に応じたエラー状態
- フォーム:各フィールドのインライン表示と、フォーム上部の概要
- ページ:再試行や前のページに戻るための操作を備えたページ全体のエラー表示
- ネットワーク:再試行操作を備えたトースト/バナー
- 検索結果なし:候補を示す、役立つ空の状態
- 権限:必要なアクセス権と取得方法を説明
ベストプラクティス
- ユーザーを責めない
- 具体的に伝える(「問題が発生しました」だけにしない)
- ユーザーの状況とデータを保持する
- デバッグのためにエラーを記録する
- 正常系と同じくらい徹底してエラーの発生経路をテストする
コメント
Markdown 対応