Agent skill · software engineering · aiskillstore
debugger
버그 원인을 시스템 로그 기반으로 특정하고 수정·검증·정리까지 완료하는 디버깅 워크플로우 스킬. 트리거: '디버깅해줘', '버그 원인 찾아줘', '어디서 오류나는지', '로그 삽입해줘', 에러 메시지/스택 트레이스 붙여넣기, '--pw'/'--pw --headless'/'--pw --record' 플래그. 지원 언어: JS/TS, Python, Java, Kotlin. 안티-트리거: 단순 코드 리뷰, 신규 기능 구현, 원인이 이미 특정된 경우(수정만 진행), 성능 최적화, 기능 동작 검증/시나리오 PASS-FAIL 판정.
Why this skill is useful
Adds a comprehensive debugging workflow with executable steps and specific commands for various programming languages that the AI wouldn't generate on its own.
What it needs
Requires playwright installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
DEBUGGER 워크플로우 $ARGUMENTS 를 파싱하여 모드와 플래그를 결정한다. 플래그 파싱 플래그 모드 --- --- (없음) 기본 모드 — 4단계 --pw Playwright MCP 모드 — 5단계 --pw --headless Playwright MCP headless 선호 --pw --record Playwright MCP trace/video 기록 선호 --pw 모드는 이 플러그인에 동봉된 Playwright MCP 서버(.mcp.json)를 사용한다. --- 안티-트리거 확인 아래 조건에 해당하면 스킬을 실행하지 않고 즉시 중단한다: 단순 코드 리뷰 요청 ("이 코드 어때?") 신규 기능 구현 요청 (버그가 아닌 경우) 원인이 이미 특정된 상태에서 수정만 요청 → 수정만 진행, 로그 삽입 스킵 성능 최적화 요청 --- 기본 모드 (4단계) [1/4] 분석 1. 관련 코드 파일 읽기 — 버그 현상·에러 메시지·재현 조건 파악 2. sequentialthinking 툴로 가설 도출 (필수) 각 Thought에서 하나의 가설을 검토하고 근거/반례를 기술 가설이 기각되면 isRevision: true로 수정하거나 다음 가설로 이동 nextThoughtNeeded: false가 되면 상위 가설 최대 5개 확정 3. 의심 지점을 최대 5개까지 목록화 (우선순위 상위 5개만) 4. 출력 형식: [2/4] 로그 삽입 의심 지점 각각에 디버그 로그를 파일에 직접 삽입한다. 로그 삽입 규칙 (§로그 규칙 참조)를 엄격히 준수. 삽입 완료 후: 사용자에게 실행 명령과 결과 붙여넣기 요청을 명시 대기 — 사용자가 로그를 붙여넣기 전까지 [3/4]로 절대 진행하지 않음 도중에 사용자가 다른 질문을 하면 → 해당 질문에 답한 뒤 로그 결과 대기 상태임을 재고지 [3/4] 원인 특정 사용자가 붙여넣은 로그를 읽고 의심 지점 중 실제 원인을 특정한다. 출력 형식: 로그로 특정 불가 시: 추가 로그를 삽입하고 [2/4]로 복귀 (최대 2회) 2회 초과 시 → 사용자에게 추가 정보(재현 조건·환경 등) 요청 후 중단 [4/4] 수정 + 정리 1. 범위 판정 게이트 (§범위 판정 게이트) → 수정 범위 확정 2. 확정 범위에 버그 수정 적용 — 기본은 원인 파일. 범위 판정에서 ⚠️ 변경필요로 나온 인접 경계는 같은 원인의 다른 발현이므로 함께 수정. stub→제대로 권고가 있으면 반영 3. 사용자에게 재실행 요청 → 결과 확인 4. 회귀 게이트 → 프로젝트 검증 스크립트(verify.sh, npm test, npm run build, pytest 등)가 있으면 실행. 재현 증상은 사라졌어도 수정이 다른 곳(tsc/lint/단위테스트)을 깨뜨리지 않았는지 확인. FAIL → 회귀 수정 후 재검증 5. 해결됨(증상 해소 + 검증 스크립트 PASS) → §정리 단계 실행 후 수정 요약 출력 + 종료 6. 미해결 → [3/4]로 복귀 (최대 2회 반복). 2회 초과 시 상황 보고 후 중단 --- --pw 모드 (5단계) 사전 조건 체크 (필수) 1. Playwright MCP 서버 연결 여부 확인 (이 플러그인에 동봉됨) 미연결 → 연결 안내 제안. 사용자 거부 시 기본 모드(4단계) 폴백 여부 질문 2. 대상 프로젝트가 웹 UI 프로젝트인지 확인 (package.json, index.html, 사용자 명시) 3. 재현 URL과 재현 시나리오 확인 — 없으면 사용자에게 1회 질문 4. 백엔드 의존성이 있는 프로젝트라면, 재현/수정 사이클이 운영 데이터에 영향을 주지 않도록 로컬·테스트 환경(테스트 DB·개발 서버)을 사용하도록 사용자에게 안내한다 [1/5] 분석 기본 모드 [1/4]와 동일. (sequentialthinking 툴 필수 실행 포함) [2/5] 로그 삽입 기본 모드 [2/4]와 동일. 단 클라이언트 코드는 console.log 사용 (브라우저 콘솔 가시성 확보). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/debugger