debug について
debugは、現在のOMCまたはClaude-Codeセッションの問題を診断するスキルです。ローカルの証拠を優先し、可能な場合は限定的に再現して、症状と根本原因を切り分け、次の小さな対応を示します。
主な機能
- 01トレース・状態・関連テストの確認
- 02可能な範囲で問題を限定して再現
- 03症状と根本原因の切り分け
- 04対象を絞った修正または検証の提案
- 05秘密情報のマスキングと一時デバッグ出力の識別
活用シーン
- 01セッションのワークフロー停止の調査
- 02フックやエージェント連携の問題診断
- 03障害がランタイムの不具合かどうかの判定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/debugを入力して読み込まれたか確認します。
詳細
デバッグ
ユーザーが現在の OMC/Claude-Code セッションの問題、ワークフローの破損、または実行時の不可解な動作の診断を求めている場合に、このスキルを使用します。
目標
実際の失敗を示すシグナルをすばやく見つけ、次に取るべき是正措置を説明します。
ワークフロー
- ユーザーの問題の説明を注意深く読みます。
- まず、最も関連性の高いローカルの証拠を調べます。
- トレースツール
- 状態ツール
- 必要に応じて、メモ帳／プロジェクトのメモリ
- 失敗しているテストやコマンド
- 可能であれば、問題を限定した形で再現します。
- 症状と根本原因を区別します。
- 最小限の次の修正または検証手順を提案します。
ルール
- 推測よりも実際の証拠を優先します。
- オーケストレーション、フック、またはエージェントのフローが関係する問題では、トレース／状態の情報を使用します。
- 問題がアプリのコードではなく、実際には製品／ランタイムのバグである場合は、そのようにはっきり伝えます。
- 失敗の原因を特定する前に、大規模な書き換えを指示しないでください。
- 一時的なデバッグ出力には
[DEBUG-<4hex>]のタグを付けます。これにより、後で grep を 1 回実行するだけで削除できます。 - ログやトレースをセッション外に持ち出す前に、秘密情報をマスクします。
- 失敗の原因が欠けている、または誤っている接合点にある場合は、それを調査結果として伝え、
refitまたはarchitecture-surveyを案内します。環境に関する教訓は修正後も活用できます。
出力
- 観測された失敗
- 根本原因の仮説
- 仮説を裏付ける証拠
- 最小限の次のアクション
コメント
Markdown 対応