/debug

不慣れなプレースホルダーを見かけた場合や、どのツールが接続されているかを確認する必要がある場合は、CONNECTORS.md を参照してください。

構造化されたデバッグセッションを実行して、問題を体系的に検出・修正します。

使用方法

/debug $ARGUMENTS

仕組み

┌─────────────────────────────────────────────────────────────────┐
│                       DEBUG                                        │
├─────────────────────────────────────────────────────────────────┤
│  ステップ 1: REPRODUCE（再現）                                      │
│  ✓ 期待される動作と実際の動作を理解する                                │
│  ✓ 正確な再現手順を特定する                                         │
│  ✓ スコープを判断する（いつから？誰が影響を受けた？）                    │
│                                                                    │
│  ステップ 2: ISOLATE（分離）                                        │
│  ✓ コンポーネント、サービス、またはコードパスを絞り込む                   │
│  ✓ 最近の変更（デプロイ、設定変更、依存関係）を確認する                   │
│  ✓ ログとエラーメッセージを確認する                                    │
│                                                                    │
│  ステップ 3: DIAGNOSE（診断）                                       │
│  ✓ 仮説を立てそれをテストする                                        │
│  ✓ コードパスをトレースする                                          │
│  ✓ 根本原因を特定する（症状だけでなく）                                │
│                                                                    │
│  ステップ 4: FIX（修正）                                            │
│  ✓ 説明付きの修正案を提案する                                        │
│  ✓ 副作用とエッジケースを検討する                                     │
│  ✓ 回帰を防ぐためのテストを提案する                                    │
└─────────────────────────────────────────────────────────────────┘

必要な情報

問題について説明してください。以下のいずれかが役に立ちます：

• エラーメッセージまたはスタックトレース
• 再現手順
• 最近の変更内容
• ログやスクリーンショット
• 期待される動作と実際の動作

出力

## デバッグレポート: [問題の要約]

### 再現
- **期待される動作**: [起こるべきこと]
- **実際の動作**: [代わりに起こること]
- **手順**: [再現方法]

### 根本原因
[バグが発生する理由の説明]

### 修正
[必要なコード変更または設定修正]

### 予防
- [追加するテスト]
- [導入するガード]

コネクタが利用可能な場合

~~monitoring が接続されている場合：

• 問題発生時周辺のログ、エラー率、メトリクスを取得する
• 相関がある可能性のある最近のデプロイと設定変更を表示する

~~source control が接続されている場合：

• 影響を受けるコードパスに触れた最近のコミットとPRを特定する
• 問題が特定の変更と相関しているかを確認する

~~project tracker が接続されている場合：

• 関連するバグレポートまたは既知の問題を検索する
• 根本原因が特定されたら修正用のチケットを作成する

ヒント

1. エラーメッセージを正確に共有してください — 言い換えないでください。正確なテキストが重要です。
2. 変更内容を伝えてください — 最近のデプロイ、依存関係の更新、設定変更は主要な容疑者です。
3. コンテキストを含めてください — 「これはステージングでは動作するが本番環境では動作しない」または「大きなペイロードだけに影響する」といった情報は問題を素早く絞り込むのに役立ちます。