Codex용 Superpowers systematic debugging 스킬.
Superpowers의 systematic debugging 스킬은 Codex가 짐작으로 수정하는 것을 막습니다. 코드를 바꾸기 전에 조사하고, 근본 원인을 찾고, 실패하는 테스트를 먼저 작성해야 합니다. Jesse Vincent가 만든 Superpowers 플러그인에 들어 있습니다.
2026년 11월 12일 업데이트 · 3분 분량
한눈에 보기
| 스킬 이름 | systematic-debugging |
| 제공 | Superpowers 플러그인(Jesse Vincent 제작) |
| 설치 | codex plugin add superpowers@openai-curated 또는 Codex에서 /plugins |
| Codex가 쓰는 때 | 버그, 실패하는 테스트, 예상과 다른 동작을 만났을 때, 수정안을 내기 전 |
| 출처 | GitHub의 openai/plugins |
하는 일
이 스킬의 핵심 규칙은 "근본 원인을 조사하기 전에는 고치지 않는다"입니다. Codex는 네 단계를 차례로 거치며, 한 단계를 마쳐야 다음으로 넘어갑니다.
- 근본 원인: 오류와 스택 트레이스를 끝까지 읽고, 버그를 재현하고, 최근 변경을 확인합니다. 여러 부분으로 된 시스템에서는 각 계층에 들어가고 나오는 값을 로그로 남겨 어디서 깨지는지 봅니다.
- 패턴: 제대로 작동하는 비슷한 코드를 찾아 참고 코드를 끝까지 읽고, 차이를 모두 나열합니다.
- 가설: 원인 하나와 그 이유를 밝히고, 가능한 한 작은 변경으로 검증합니다. 실패하면 수정을 덧쌓지 않고 새 가설을 세웁니다.
- 구현: 실패하는 테스트를 작성하고, 원인이 있는 곳에서 한 번만 고친 뒤, 다른 곳이 깨지지 않았는지 확인합니다.
수정이 세 번 연속 실패하면, 네 번째를 시도하기 전에 멈추고 사용자와 함께 아키텍처를 다시 따져 보라고 Codex에 지시합니다. "X만 바꿔 보고 어떻게 되나 보자"처럼 지름길을 택하려는 신호가 되는 생각도 나열합니다.
폴더에는 호출 스택을 거슬러 버그를 추적하는 법, 여러 계층에 검증을 넣는 법, 고정 타임아웃을 조건 폴링으로 바꾸는 법에 관한 보조 가이드가 들어 있고, 원치 않는 파일을 남기는 테스트를 이분 탐색으로 찾아내는 find-polluter.sh 스크립트도 있습니다.
언제 쓰나요
Codex가 증상만 덮거나, 수정을 겹겹이 쌓거나, 버그 하나를 두고 같은 자리를 맴돈다면 설치하세요. 불안정한 테스트, 빌드 실패, 여러 컴포넌트에 걸친 버그에서 특히 유용합니다.
써 보기
systematic debugging 스킬을 사용해 주세요. 어제 머지 이후 checkout 테스트가 CI에서 실패하기 시작했는데, 로컬에서는 통과합니다. 아무것도 바꾸기 전에 근본 원인부터 찾아 주세요.
Claude Code에서도 되나요?
네. Superpowers README는 Claude Code를 지원 에이전트로 소개하며, 공식 Claude 플러그인 마켓플레이스에서 설치합니다. 이 스킬은 테스트 주도 개발과 검증을 위한 다른 Superpowers 스킬을 가리키므로, 이 폴더를 복사하기보다 그 플러그인을 쓰세요.