Debug Skill

Claude Code용 디버깅 스킬

이 스킬은 Claude에게 구조화된 디버깅 워크플로우를 가르쳐줍니다. AI가 중단점을 설정하고, 코드 실행을 한 단계씩 추적하며, 로컬 변수와 호출 스택을 검사하고, 실행 중에 식을 평가하는 방법을 학습합니다.

`dap` CLI 도구

`dap`은 Debug Adapter Protocol(DAP)을 래핑하는 상태less CLI입니다. 백그라운드 데몬이 세션을 유지하고, CLI는 명령어를 한 번 전달하면 현재 위치, 주변 소스, 로컬 변수, 호출 스택, 프로그램 출력 등 전체 컨텍스트를 반환합니다.

다운로드·설치 방법

Claude Code 스킬 설치: 플러그인 마켓플레이스를 통해 설치할 수 있습니다.

• `/plugin marketplace add AlmogBaku/debug-skill`
• `/plugin install debugging-code@debug-skill-marketplace`

다른 에이전트용 설치: skills.sh를 사용하거나, 스킬 폴더를 수동으로 복사할 수 있습니다.

• `npx skills add AlmogBaku/debug-skill`
• `bunx skills add AlmogBaku/debug-skill`

`dap` CLI 설치:

• Linux/macOS 원클릭 설치: `bash <(curl -fsSL https://raw.githubusercontent.com/AlmogBaku/debug-skill/master/skills/debugging-code/scripts/install-dap.sh)`
• Homebrew(macOS): `brew install AlmogBaku/tap/dap`
• 소스에서 설치(Go): `go install github.com/AlmogBaku/debug-skill/cmd/dap@latest`
• 릴리스 페이지: 프리 빌드 바이너리를 다운로드할 수 있습니다.

기본 사용법/명령어

빠른 시작 예시:

• `dap debug app.py –break app.py:42`: 스크립트를 디버깅하고 특정 줄에 중단점을 설정합니다.
• `dap eval “len(items)”`: 현재 프레임에서 식을 평가합니다.
• `dap inspect data –depth 2`: 변수를 검사하고 중첩된 객체를 펼칩니다.
• `dap step`: 코드를 한 단계 실행(기본: over)합니다.
• `dap continue`: 다음 중단점까지 실행을 재개합니다.
• `dap continue –to app.py:50`: 특정 줄까지 일시 중단점으로 실행합니다.
• `dap stop`: 세션을 종료합니다.

다국어 지원:

• Python (debugpy)
• Go (dlv/Delve)
• Node.js/TypeScript (js-debug)
• Rust/C/C++ (lldb-dap)

파일 확장자에 따라 백엔드가 자동 감지되며, `–backend ` 옵션으로 덮어쓰기할 수 있습니다.

이런 경우에 유용합니다

AI 에이전트의 디버깅 역량 강화: AI 코딩助手가 실제 디버거를 사용하여 코드 문제를 정확하고 효율적으로 진단하도록 돕습니다.

원격 디버깅: `dap debug –attach container:5678 –backend debugpy`와 같은 명령어로 컨테이너 내 디버깅 서버나 실행 중인 프로세스(`–pid`)에 연결할 수 있습니다.

다중 세션 관리: `–session ` 플래그를 사용하여 여러 에이전트가 독립적으로 디버깅 세션을 운영할 수 있습니다.

지원 환경·시스템 요구사항

이 도구는 Linux 및 macOS 환경을 지원합니다. Chocolatey 패키지가 제공되므로 Windows에서도 설치 가능할 수 있으나, 공식 설치 스크립트는 Unix 기반 시스템을 대상으로 합니다. 각 프로그래밍 언어의 해당 디버깅 백엔드가 필요합니다.

제한 사항·확인 사항

Windows 지원은 공식 설치 스크립트에 명시적으로 포함되어 있지 않습니다.