mcpField
D
debug

debug

github.com/anthropics開発33.6k5.9k 回インストール1 日前に更新
リポジトリ

debug について

開発者が問題を再現し、影響範囲を絞り、原因を調べるための構造化デバッグスキルです。接続済みの監視、ソース管理、プロジェクト追跡ツールから情報を集め、後続チケットにもつなげられます。

主な機能

  1. 01再現手順と影響範囲の分析
  2. 02期待動作と実際の動作の比較
  3. 03接続済みログとメトリクスによる調査
  4. 04最近のコード変更の確認
  5. 05関連課題の検索とチケット作成

活用シーン

  1. 01エラー報告から再現手順を整理
  2. 02最近のデプロイと障害の関連を確認
  3. 03根本原因を記録して後続チケットを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/anthropics/knowledge-work-plugins --skill debug

インストール後、Claude Code で/debugを入力して読み込まれたか確認します。

詳細

/debug

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

問題を体系的に特定して修正するための、構造化されたデバッグセッションを実行します。

使い方

/debug $ARGUMENTS

仕組み

┌─────────────────────────────────────────────────────────────────┐
│                       DEBUG                                        │
├─────────────────────────────────────────────────────────────────┤
│  Step 1: REPRODUCE                                                │
│  ✓ Understand the expected vs. actual behavior                   │
│  ✓ Identify exact reproduction steps                             │
│  ✓ Determine scope (when did it start? who is affected?)        │
│                                                                    │
│  Step 2: ISOLATE                                                   │
│  ✓ Narrow down the component, service, or code path             │
│  ✓ Check recent changes (deploys, config changes, dependencies) │
│  ✓ Review logs and error messages                                │
│                                                                    │
│  Step 3: DIAGNOSE                                                  │
│  ✓ Form hypotheses and test them                                 │
│  ✓ Trace the code path                                           │
│  ✓ Identify root cause (not just symptoms)                      │
│                                                                    │
│  Step 4: FIX                                                       │
│  ✓ Propose a fix with explanation                                │
│  ✓ Consider side effects and edge cases                          │
│  ✓ Suggest tests to prevent regression                           │
└─────────────────────────────────────────────────────────────────┘

お知らせいただきたい情報

問題について教えてください。以下の情報があると役立ちます。

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

出力

## Debug Report: [Issue Summary]

### Reproduction
- **Expected**: [What should happen]
- **Actual**: [What happens instead]
- **Steps**: [How to reproduce]

### Root Cause
[Explanation of why the bug occurs]

### Fix
[Code changes or configuration fixes needed]

### Prevention
- [Test to add]
- [Guard to put in place]

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

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

  • 問題が発生した時間帯のログ、エラー率、メトリクスを取得します
  • 関連している可能性のある最近のデプロイや設定変更を表示します

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

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

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

  • 関連するバグ報告や既知の問題を検索します
  • 修正箇所の特定後、チケットを作成します

ヒント

  1. エラーメッセージは正確に共有してください — 言い換えないでください。正確な文面が重要です。
  2. 変更した内容をお知らせください — 最近のデプロイ、依存関係の更新、設定変更が主な原因候補です。
  3. 状況を含めてください — 「ステージングでは動作するが、本番環境では動作しない」や「大きなペイロードに限って発生する」といった情報があると、原因をすばやく絞り込めます。

コメント

Markdown 対応