shioki デバッグワークフロー
問題の特定から解決、記録までのデバッグプロセス全体を支援するスキルです。
When to Use
- バグやエラーが発生したとき
- パフォーマンス問題を調査するとき
- 過去の類似問題を検索したいとき
- デバッグセッションを記録したいとき
- 緊急時の対応フローを確認したいとき
Instructions
1. 過去事例の確認
まず references/DEBUG_TEMPLATE.md を読み込み、過去の問題解決記録を確認してください。
2. デバッグプロセス
Step 1: 問題の特定・記録
以下の情報を整理してください:
- 発生日時
- 環境（開発/ステージング/本番）
- 影響範囲
- 緊急度（高/中/低）
- エラーメッセージ
- 再現手順
- 期待動作 vs 実際の動作
Step 2: 調査・分析
- 過去の類似事例を
scripts/search-sessions.shで検索 - ログ・スタックトレースの分析
- 関連コンポーネントの影響調査
Step 3: 解決策の実装
- 原因の仮説を複数立てる
- 最小限の変更で検証する
- 影響範囲を考慮したテストを実施する
Step 4: 記録・共有
- デバッグセッションを記録
- 根本原因と解決策を文書化
- 再発防止策を検討
3. セッション管理
デバッグセッションの作成（保存先: .agents/debug-sessions/ / .claude/debug-sessions/ / .cursor/debug-sessions/ のいずれか検出されたもの）:
bash .agents/skills/debug-workflow/scripts/create-session.sh "問題の概要"
# （.claude/skills / .cursor/skills も検出対象）
過去セッションの検索:
bash .agents/skills/debug-workflow/scripts/search-sessions.sh "キーワード"
# （.claude/skills / .cursor/skills も検出対象）
4. 緊急時対応
- 1時間以内に解決できない: チームに相談を推奨
- システム全体に影響: 即座にエスカレーション
- データ損失の可能性: 最優先で対応
5. アクションスキルとの連携
デバッグセッションの開始には /start-debug の利用を案内してください。
解決後の改善記録には /log-improvement を案内してください。