슈퍼파워즈(Superpowers)슈퍼파워즈디버깅

슈퍼파워즈로 버그를 추측 없이 고치기

설치된 스킬 파일과 공식 README를 읽고 정리했습니다.

무엇에 쓰나요

프로그램이 안 되거나 시험이 실패할 때, AI가 짐작으로 여기저기 고치지 않게 하려고 씁니다.

따라 하기

  1. 슈퍼파워즈를 설치한 Claude Code에서, 증상을 있는 그대로 적습니다. 예: "저장 버튼을 눌러도 아무 반응이 없어요. 오류 문구는 이렇습니다."
  2. 오류 문구가 있으면 그대로 붙여 넣습니다.
  3. AI가 아래 네 단계를 따르는지 지켜봅니다. 스킬 파일의 내용입니다.
    • 1단계, 원인 조사. 오류를 끝까지 읽고, 같은 증상을 다시 만들어 보고, 최근에 바뀐 것을 살핍니다.
    • 2단계, 비교. 잘 되는 비슷한 코드와 어디가 다른지 찾습니다.
    • 3단계, 가설 시험. "원인은 이것이다, 이유는 이렇다"를 하나만 세우고, 가장 작은 변경으로 시험합니다.
    • 4단계, 고치기. 실패하는 시험을 먼저 만들고 원인 하나만 고친 뒤 결과를 확인합니다.
  4. 고쳐도 계속 안 되면 AI가 멈추고 상의하자고 하는지 봅니다. 스킬 파일은 세 번 실패하면 네 번째 수정 전에 구조부터 의심하라고 합니다.

기대할 모습

AI가 고치기 전에 읽고, 재현하고, 가설을 말합니다. 끝난 뒤에는 "통과했다"고만 하지 않고 실행한 명령과 결과를 보여 주는 것이 규칙입니다. 이 규칙은 verification-before-completion 스킬에 있습니다.

근거

  • 단계의 내용은 설치된 7.0.2 스킬 파일을 읽고 옮긴 것입니다. DataCamp 튜토리얼도 같은 네 단계와 세 번 실패 규칙을 소개합니다.

주의

  • AI가 고쳤다고 해도 증상이 사라졌는지 직접 눌러 보세요.
  • 급할수록 단계를 건너뛰고 싶어집니다. 스킬 파일은 급할 때 더 지키라고 적어 두었습니다.
  • 원인을 못 찾으면 AI가 모른다고 말하는 것이 정상입니다. 그럴 때는 더 조사하거나 추가 정보를 주세요.

원문 링크 모음