systematic-debuggingcommit bb92a77SKILL.md · 테스트·디버깅

체계적 디버깅

근본 원인 조사, 패턴 분석, 가설 검증, 구현의 4단계로 버그를 다루며 증상이 아닌 원인을 고칩니다.

npx skills add obra/superpowers --skill systematic-debugging

핵심 규칙

근본 원인 조사를 마치기 전에는 어떤 수정도 하지 않습니다.

01단계근본 원인 조사
오류 메시지를 끝까지 읽고 재현하며 최근 변경을 확인합니다. 여러 구성 요소가 있으면 경계마다 진단 로그를 넣고 잘못된 값의 출처를 거슬러 찾습니다.
02단계패턴 분석
코드베이스에서 잘 동작하는 비슷한 코드를 찾고 참조 구현을 끝까지 읽은 뒤, 고장 난 코드와의 차이를 모두 나열합니다.
03단계가설과 검증
가설 하나를 분명히 적고 최소한의 변경으로 변수 하나씩 검증합니다. 틀리면 새 가설을 세우고 수정을 덧붙이지 않습니다.
04단계근본 원인 수정
재현하는 실패 테스트를 먼저 쓰고 수정 하나를 적용해 검증합니다. 세 번 실패하면 멈추고 아키텍처 문제를 사람과 논의합니다.

기능	필요 여부	설명
파일 쓰기	필요	진단 로그 추가, 실패 테스트 작성, 단일 수정을 할 수 있습니다.
명령 실행	필요	문제 재현, 테스트 실행, git diff와 최근 커밋 확인을 합니다.
네트워크 송신	필요 없음	절차에 네트워크 접근 단계가 없습니다.

SKILL.md 프런트매터(YAML)commit bb92a77

---
name: systematic-debugging
description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
---