← ClaudeAtlas

debuglisted

Investigate a failure whose cause is not evident from the error itself - flaky or intermittent failures, failures that only happen in CI or one environment, or errors with several plausible causes across files - by reproducing, isolating, fixing and verifying. Skip it when the message already shows the fix (a missing variable, a typo, a wrong import); just fix that directly.
This-HW/hiway-kit · ★ 3 · Code & Development · score 76
Install: claude install-skill This-HW/hiway-kit
# 디버깅 실행 > 4-Phase Debugging > Reproduce → Isolate → Fix → Verify 호출되면 바로 파이프라인을 시작한다. 단계가 바뀔 때 한 줄로 진행을 알린다. 에러 정보: $ARGUMENTS 원인이 여러 개인 실패는 `references/hypothesis-evidence.md`를 읽고 가설별 구분 실험을 기록한다. 코드 구조/정의/참조가 필요하면 사용 가능한 호스트 도구 또는 `code-intel`을 선택한다. --- ## 파이프라인 구조 ``` Phase 1 Reproduce → Phase 2 Isolate → Phase 3 Fix → (수정 반영) → Phase 4 Verify └─ fix-bugs (진단 전용) ─┘ fix-bugs (격리) verify-code ``` --- ## 위임 수단이 없는 하네스 — 강등 경로 아래 `subagent_type:` 블록은 운송 수단일 뿐이고, 불변식은 블록의 `prompt:` 계약(검사 항목·출력 형식·완료 선언)이다. 쓸 수 있는 수단을 호스트에 확인하고 위에서부터 한 칸씩 내려간다: **① 네이티브 서브에이전트**(블록 그대로) → **② 호스트의 다른 격리 위임 수단**(에이전트 정의 본문 `<플러그인 루트>/agents/<이름>.md` 를 **요약 없이** 넘기고 뒤에 `prompt:` 를 붙인다 — 플러그인 루트 탐색은 `skills/plan-task/references/task-tools-fallback.md` §A. 회신 요약이 아니라 계약 산출물로 판정한다) → **③ 이 세션에서 같은 계약을 직접 수행.** 수단이 없다고 단계를 건너뛰거나 하지 않은 위임을 했다고 보고하지 않는다. ③은 격리가 없다 — 판정을 서술이 아니라 재현 명령의 실제 출력으로 하고, 기각한 대안 원인을 최소 1개 적는다. ## Phase 1-2: 재현 및 격리 (Reproduce + Isolate) > **진단 전용 호출은 격리 이득이 없다.** 읽기·재현 명령만 하고 파일을 고치지 않으므로 > (`rules/parallel-worktree.md` — 읽기 전용 작업자에 격리를 걸지 않는다) 프롬프트에 "수정 금지"를 > 명시한다. `fix-bugs` 정의에 격리가 걸려 있어 호출 단위로 끌 수 없는 호스트면 그것은 감수한다 — > 이 단계에서 생긴 수정이 있으면 반영하지 않고 버린다. ``` Task tool 사용: subagent_type: fix-bugs model: opus prompt: | (진단 전용 — 이 단���에서는 수정하지 말고 원인·재현 명령·근거만 보고) 다음 에러를 진단해주세요: $ARGUMENTS ### Phase 1: Reproduce (재현) - 에러를 재현하는 최소 단계 식별 - 재현 조건 및 환경 확인 - 에러 발생 빈도 (항상/간헐적) ### Phase 2: Isolate (격리) - 에러 유형 (문법/타입/런타임/빌드/외부AP