debug-tools

Iterative debugging workflow with confidence scoring and strategic log injection. Five phases (investigate, inject logs, propose fix, verify, cleanup). Use when debugging unexpected behavior, silent errors, intermittent failures, or issues requiring runtime data. Also use when the user says something isn't working, behavior is inconsistent, tests pass but app fails, works in dev but not in prod, or wants to trace execution flow. Triggers on "debug", "fix bug", "investigate", "trace issue", "add debug logs", "cleanup debug logs", "why is this broken", "not working".

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o debug-tools.zip https://jpskill.com/download/9615.zip && unzip -o debug-tools.zip && rm debug-tools.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/9615.zip -OutFile "$d\debug-tools.zip"; Expand-Archive "$d\debug-tools.zip" -DestinationPath $d -Force; ri "$d\debug-tools.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して debug-tools.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → debug-tools フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新

2026-05-18

取得日時

2026-05-18

同梱ファイル

📖 Claude が読む原文 SKILL.md(中身を展開)

この本文は AI(Claude)が読むための原文(英語または中国語)です。日本語訳は順次追加中。

Debug Tools

Iterative debugging workflow with targeted log injection and cleanup.

Workflow

investigate --> inject logs --> propose fix --> verify --> cleanup
     ^_________________________________________|

The workflow loops back to investigation if the fix doesn't work.

Context Loading Strategy

Load only the reference matching the current trigger. Multiple references may be loaded during a full debugging session (investigation often leads to log injection).

Triggers

Trigger Pattern	Reference
Debug issue, investigate bug, fix bug	investigation.md
Add debug logs, inject logs, trace with logs	log-injection.md
Remove debug logs, cleanup logs	log-cleanup.md
Debug patterns, log format, common bugs	debugging-patterns.md

Cross-References

investigation.md <---> log-injection.md (investigation may request logs)
investigation.md <---> log-cleanup.md (after fix verified)
log-injection.md ----> log-cleanup.md (cleanup removes injected logs)

Guidelines

DO:

Use confidence scoring: >= 70 report as probable cause, 50-69 suggest logs
Always use [DEBUG] prefix for injected logs (enables cleanup)
Apply minimal fix: smallest change that resolves the issue
Clean up debug logs automatically after fix is verified
Use whatever debugging tools are available in the environment

DON'T:

Report findings with confidence < 50
Log sensitive data (passwords, tokens, PII)
Apply large refactors as part of a bug fix
Leave debug logs in production code

Error Handling

No bug description provided: ask user to describe the issue
Cannot reproduce: suggest adding debug logs
Fix doesn't work: return to investigation phase
Logs left behind: user can request cleanup anytime