Error Recovery Prompts

概要

エラー復旧プロンプトの設計と改善を専門とするスキル。 ユーザーがエラーから回復するための効果的なガイダンスを提供し、フラストレーションを最小化する。

ワークフロー

Phase 1: 復旧フロー設計

目的: エラータイプに応じた復旧フローを設計

アクション:

1. エラータイプと発生シナリオを分析
2. 自動/手動回復の可能性を判断
3. 段階的な復旧オプションを設計
4. プロンプト文言を作成

Task: agents/design-recovery-flow.md を参照

Phase 2: プロンプト実装

目的: 設計に基づき復旧プロンプトを実装

アクション:

1. テンプレートを選択
2. プロンプトコンポーネントを実装
3. アクセシビリティを確保
4. アニメーション/進捗表示を実装

Phase 3: 検証と記録

目的: 復旧フローの動作確認

アクション:

1. 各エラーシナリオをテスト
2. ユーザビリティを確認
3. scripts/log_usage.mjs で記録

Task仕様ナビ

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

復旧プロンプトの基本原則

1. 明確なアクション提示

ユーザーが次に何をすべきかを明確に示す。

悪い例: "エラーが発生しました" 良い例: "エラーが発生しました。[再試行]ボタンをクリックしてください"

2. 段階的な回復オプション

1. 再試行 (最も簡単)
2. ページを更新
3. サポートに問い合わせ (最後の手段)

3. 進捗の保持

可能な限りユーザーの入力/進捗を保持する。

ベストプラクティス

すべきこと

• 復旧オプションをボタンで明示
• 自動リトライには進捗表示を追加
• データロスを防止（自動保存）
• キーボードショートカットをサポート
• フォーカス管理（プロンプトにフォーカス）

避けるべきこと

• 復旧方法なしでエラーを表示
• 無限リトライ
• ユーザーを責める表現
• 技術的詳細の露出

リソース参照

agents/（Task仕様書）

references/（詳細知識）

scripts/（決定論的処理）

assets/（テンプレート）

変更履歴