debuglisted
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