デバッグワークフロー

問題の特定から解決、記録までのデバッグプロセス全体を支援するスキルです。

When to Use

• •バグやエラーが発生したとき
• •パフォーマンス問題を調査するとき
• •過去の類似問題を検索したいとき
• •デバッグセッションを記録したいとき
• •緊急時の対応フローを確認したいとき

Instructions

1. 過去事例の確認

まず references/DEBUG_TEMPLATE.md を読み込み、過去の問題解決記録を確認してください。

2. デバッグプロセス

Step 1: 問題の特定・記録

以下の情報を整理してください:

• •発生日時
• •環境（開発/ステージング/本番）
• •影響範囲
• •緊急度（高/中/低）
• •エラーメッセージ
• •再現手順
• •期待動作 vs 実際の動作

Step 2: 調査・分析

• •過去の類似事例を scripts/search-sessions.sh で検索
• •ログ・スタックトレースの分析
• •関連コンポーネントの影響調査

Step 3: 解決策の実装

• •原因の仮説を複数立てる
• •最小限の変更で検証する
• •影響範囲を考慮したテストを実施する

Step 4: 記録・共有

• •デバッグセッションを記録
• •根本原因と解決策を文書化
• •再発防止策を検討

3. セッション管理

デバッグセッションの作成:

bash .cursor/skills/debug-workflow/scripts/create-session.sh "問題の概要"

過去セッションの検索:

bash .cursor/skills/debug-workflow/scripts/search-sessions.sh "キーワード"

4. 緊急時対応

• •1時間以内に解決できない: チームに相談を推奨
• •システム全体に影響: 即座にエスカレーション
• •データ損失の可能性: 最優先で対応

5. コマンドとの連携

デバッグセッションの開始には /start-debug コマンドの利用を案内してください。 解決後の改善記録には /log-improvement コマンドを案内してください。