systematic-debugging

이 스킬은 superpowers의 원작자가 만든 것으로, 테스트 실패, 운영 환경 장애, 빌드 실패 또는 기타 이상 현상이 발생할 때 트리거됩니다. 핵심 규칙은 "근본 원인 조사를 하지 않으면 수정 사항을 제안할 수 없다"는 것입니다. 1단계에서는 전체 오류 메시지를 읽고, 안정적으로 재현하며, 최근 변경 사항을 확인하고, 다중 컴포넌트 시스템의 경우 각 경계에 로그를 추가하여 어느 계층에서 문제가 발생하는지 파악합니다. 2단계에서는 정상 작동하는 유사한 코드를 찾아 항목별로 비교합니다. 3단계에서는 한 번에 하나의 가설만 검증합니다. 마지막으로 수정을 수행합니다. 시간이 촉박할수록, "한 줄만 고치면 되겠지"라고 생각할수록 이 절차를 반드시 완수해야 합니다.

이 스킬은 superpowers의 원작자가 만든 것으로, 테스트 실패, 운영 환경 장애, 빌드 실패 또는 기타 이상 현상이 발생할 때 트리거됩니다. 핵심 규칙은 "근본 원인 조사를 하지 않으면 수정 사항을 제안할 수 없다"는 것입니다. 1단계에서는 전체 오류 메시지를 읽고, 안정적으로 재현하며, 최근 변경 사항을 확인하고, 다중 컴포넌트 시스템의 경우 각 경계에 로그를 추가하여 어느 계층에서 문제가 발생하는지 파악합니다. 2단계에서는 정상 작동하는 유사한 코드를 찾아 항목별로 비교합니다. 3단계에서는 한 번에 하나의 가설만 검증합니다. 마지막으로 수정을 수행합니다. 시간이 촉박할수록, "한 줄만 고치면 되겠지"라고 생각할수록 이 절차를 반드시 완수해야 합니다.

중요성 에이전트가 버그를 수정할 때 흔히 나타나는 문제는 증상만 보고 바로 수정하거나, 수정이 실패하면 또 다른 레이어를 추가하는 것입니다. 이 스킬은 조사, 비교, 가설 검증, 수정을 반드시 순서대로 진행해야 하는 4단계로 구분합니다.

skills.sh 설치 횟수 333427 (+1239 / 24h)

보안 감사: 위험 경고 있음

  • 에이전트가 셸/스크립트 명령어를 실행하도록 허용
  • 감사 범위: GitHub obra/superpowers/skills/systematic-debugging/SKILL.md (SKILL.md 텍스트만 스캔)

이유

  • skills.sh는 24시간 동안 1239회 설치되었으며, 누적 설치 횟수는 333427입니다(관심도만을 나타냄). MIT 라이선스 적용
  • 감사 경고에서 언급된 명령어 실행은 조사 단계에서 사용되는 git diff 및 로그 추가 디버깅으로, 용도와 일치합니다. 이는 obra의 원본 저장소이며 복제 계정이 아닙니다.

사용법

  • 설치 후 에이전트는 오류나 테스트 실패를 만나면 자동으로 4단계 절차에 따라 문제를 조사합니다. 또한 "먼저 수정하지 말고 이 문제의 근본 원인을 찾아라"라고 직접 지시할 수도 있습니다.

위험 요소

  • 디버깅 과정에서 코드에 임시 진단 로그를 추가하고 명령어를 실행하므로, 작업 종료 후 이러한 변경 사항이 정리되었는지 반드시 확인해야 합니다.

열기 · 저장소

Best Skills 每日数据(LinklyAI / @BlueeonY,CC BY 4.0)

최신 AI 소식 보기