トラブルシューティング

目的

• 問題を再現して原因を特定する。
• 最も可能性の高い根本原因と次のアクションを特定する。

使用する場合

• バグまたは障害が報告されたまたは観察されている。
• 症状が不明確で、絞り込みが必要である。

入力

• ユーザーが報告した症状、ログ、または再現手順。
• AGENTS.md、ルール、関連するコード/テスト。
• 利用可能な場合は環境の詳細。

プロセス

1. 症状を確認して言い直す。再現情報の不足を記録する。
2. 簡潔な仮説を立てる。最もシンプルなチェックを優先する。
3. 仮説を確認/否定するための最小限の証拠(ログ/テスト/入力)を収集する。
4. 根本原因を特定するか、有力な候補に絞り込む。
5. 次のアクション(修正方針またはさらに詳しい確認)と検証手順を提案する。

出力

• 根本原因として考えられるもの(または絞り込まれた仮説)。
• 収集した証拠と、まだ不明な点。
• 提案された修正方向と検証計画。

エッジケース

• 再現手順がない場合は、正確な手順またはデータをリクエストする。
• 広範な変更は避け、証拠に基づいた絞り込みに焦点を当てる。