| name | debug |
| description | Debug a bug from an entrypoint or symptom, prove root cause, propose a minimal patch |
| argument-hint | [entrypoint] [expected] [actual] [repro] [mode quick|strict] |
Use for root-cause debugging from file, symptom, or error.
Input:
- Preferred: entrypoint, expected, actual, repro, optional error/logs/stack.
- Minimum: entrypoint or one concrete symptom.
- If input is incomplete: start with what exists; list missing context; ask only for the highest-value next detail.
- Modes:
quick default; strict proves end to end.
Rules:
- all shell commands: use
rtk <cmd> via the bash tool, never raw command; git status = bad, rtk git status = good.
- Assume bug exists.
- Every claim needs code evidence.
- No broad refactors. No unrelated cleanup.
- Do not test, commit, or open PRs.
Workflow:
- Start from entrypoint or symptom source.
- Trace execution path step by step.
- If not found, follow call chain one layer at a time.
- In
quick, give best evidence-backed hypothesis plus next verification step when proof is incomplete.
- In
strict, continue until root cause is proven end to end.
Output:
- Root cause or best current hypothesis: file + line + explanation
- Proof status:
- proven evidence, or
- strongest evidence so far + next verification step
- Minimal fix: exact patch or snippet, when justified
- Risk: low | medium | high
- Then print exactly:
Type "continue" to apply this minimal patch. Anything else cancels.
Apply:
Apply only if next reply is exactly continue:
- apply only described minimal fix
- modify only referenced files
- do not refactor, test, commit, open PR, trigger CI, or invoke other skills
- stop immediately after applying
git status --short
git diff --stat