디버깅 (Debugging)
가설 기반 루프와 런타임별 레퍼런스로 크래시·무응답·간헐적 실패까지 실제 실행 증거로 잡아내는 디버깅 스킬.
개발·코딩고급★ 67,531⑂ 5,507AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
코드를 읽고 '아마 이게 문제일 것 같다'고 추측하는 대신, 실제 런타임 상태를 관찰해서 원인을 확정하도록 Claude의 디버깅 절차를 강제합니다.
- 최소 3개의 서로 다른 축의 가설을 세우고 병렬로 검증
- 2라운드 연속 실패 시 서로 다른 관점의 'Oracle' 3개를 띄워 교차 분석
- 원인 확정 → 실패하는 테스트로 고정(TDD) → 최소 수정 → 실제로 시스템을 사용해 QA
- 디버깅 중 만든 로그·브레이크포인트·임시 파일은
.debug-journal.md에 기록했다가 전부 원복
Python(pdb/debugpy/pytest), Node·tsx·Bun·Deno, Rust, Go(dlv), 스트립된 네이티브 바이너리, 그리고 Bun SEA·PyInstaller·Electron 같은 번들 바이너리별 전용 레퍼런스를 갖추고 있으며, Playwright·pwndbg·pwntools·Ghidra 사용 시점도 명시합니다.
이런 분께 추천
- 원인 모를 버그에 몇 시간씩 태우는 백엔드/풀스택 개발자
- CI에서만 깨지는 플래키 테스트에 시달리는 팀
- 소스가 없는 서드파티 바이너리를 분석해야 하는 리버스 엔지니어·보안 엔지니어
- AI에게 '대충 고쳐놓고 됐다고 하는' 습관을 없애고 싶은 사람
활용 예시
- HTTP 200인데 응답 본문이 빈 경우 — "왜 200인데 body가 비어 있지? 디버깅해줘"라고 하면 런타임 값 관찰 → 원인 확정 → 재현 테스트 추가까지 진행합니다.
- CI에서만 터지는 테스트 — "로컬에선 통과하는데 CI에서만 실패해" → 플래키 트리아지 레퍼런스를 먼저 읽고 실패 시그니처로 탐색 범위를 좁힙니다.
- 정체불명 바이너리 분석 — "이 실행 파일 리버스 엔지니어링해줘" → 번들 바이너리인지 네이티브인지 30초 판별 후 알맞은 도구(Ghidra/pwndbg/번들 추출기)로 진입합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 code-yeongyu/oh-my-openagent 의 packages/shared-skills/skills/debugging 폴더를 내 ~/.claude/skills/debugging/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent && mkdir -p ~/.claude/skills && cp -r /tmp/oh-my-openagent/packages/shared-skills/skills/debugging ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - references/ 폴더까지 통째로 복사합니다:
cp -r /tmp/oh-my-openagent/packages/shared-skills/skills/debugging ~/.claude/skills/ - 복사 확인:
ls ~/.claude/skills/debugging/references - Claude Code를 재시작한 뒤 "이 버그 디버깅해줘"처럼 요청하면 스킬이 자동으로 호출됩니다.
- (선택) 네이티브·브라우저 디버깅을 쓰려면
pwndbg,Ghidra,npx playwright install등을 미리 설치해 두세요.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION