返回 Skill 列表
extension
分类: 开发与工程无需 API Key

dev-debug

当用户要求‘调试’、‘修复错误’、‘调查错误’、‘为什么它坏了’、‘追踪根本原因’、‘找到错误’,或者需要通过带有新鲜上下文的子代理迭代和进度门控升级来进行系统性调试时,应使用此技能。

person作者: jakexiaohubgithub

Dev debugging

!bun ${CLAUDE_SKILL_DIR}/../../scripts/load-constraints.ts dev-debug

Use debugging to investigate a named failure, not to re-authorize implementation. When invoked during /dev, resolve the receipt-selected {planFile, planHash} and create/reconcile TaskList investigation and repair items. Do not create HYPOTHESES.md, LEARNINGS.md, HANDOFF.md, STATE.md, a fixed plan, or any visible planning ledger.

Fresh investigation loop

  1. Capture the symptom, reproduction command, current plan identity, and scope in one TaskList investigation item.
  2. Dispatch one fresh investigator at a time. The investigator reproduces the failure, tests one hypothesis, and returns evidence, changed files, a specific regression-test result, and the next hypothesis. Keep investigation conclusions in the TaskList item and returned result.
  3. A confirmed fix requires a new failing regression test (RED), minimal repair, GREEN, and a fresh full relevant suite. The doer never self-verifies.
  4. Convert an actionable confirmed repair into a current-plan TaskList work item and route it through dev-implement; then independently verify it. If the diagnosis changes requirements or approved architecture, stop and return to native clarification/planning for a new receipt.
  5. Stop and escalate on repeated non-progress, missing reproduction, or a blocker requiring user input.

Return contract

Dev debug result
- Plan: {planFile, planHash}
- Investigation: TaskList ID
- Reproduction and hypotheses: [{hypothesis, result, evidence}]
- Repair: TaskList ID | none
- Regression evidence: {red, green, suite}
- Status: FIXED | BLOCKED | ESCALATE

A returned FIXED is only an implementation report until the independent verifier records PASS.