debug-tools

📁 adeonir/agent-skills 📅 1 day ago
1
总安装量
1
周安装量
#55028
全站排名
安装命令
npx skills add https://github.com/adeonir/agent-skills --skill debug-tools

Agent 安装分布

amp 1
opencode 1
kimi-cli 1
codex 1
claude-code 1

Skill 文档

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

  • Confidence scoring: >= 70 report as probable cause, 50-69 suggest logs, < 50 don’t report
  • Always use [DEBUG] prefix for injected logs (enables cleanup)
  • Never log sensitive data (passwords, tokens, PII)
  • Minimal fix: smallest change that resolves the issue
  • Cleanup is automatic after fix is verified
  • Uses whatever debugging tools are available in the environment

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