hunt

hunt skill 개요

hunt는 무엇을 위한 skill인가

hunt는 어떤 수정도 적용하기 전에 근본 원인부터 파고들게 하는 디버깅 우선 skill입니다. 오류, 크래시, 회귀, 실패하는 테스트, 오래된 캐시 문제, 스크린샷 버그, 그리고 “예전에는 되던” 장애처럼, 빠른 패치보다 검증 가능한 가설이 필요한 상황에 가장 잘 맞습니다.

누가 설치하면 좋은가

앱 코드, 테스트, 빌드 산출물, 런타임 동작 전반을 오가며 자주 디버깅한다면 hunt skill을 설치하세요. 문제를 빠르게 좁혀 가는 반복 가능한 hunting 가이드가 필요할 때 특히 유용합니다. 증상이 복잡하게 얽혀 있거나, 같은 수정을 여러 번 해도 해결되지 않거나, 로그·UI 상태·생성된 출력이 모두 엮인 버그라면 더더욱 그렇습니다.

무엇이 다른가

hunt의 핵심 가치는 규율입니다. 특정 파일, 함수, 줄, 조건을 먼저 짚고, 근거를 모아 근본 원인을 방어 가능하게 만드는 데 있습니다. 함께 제공되는 참조 문서는 로깅, 실패 패턴, IME/Unicode 특수 사례, 렌더링 버그까지 다루므로, 이 skill은 단순히 “더 열심히 디버깅하라”가 아니라 올바른 종류의 진단으로 사용자를 이끕니다.

hunt skill 사용법

설치와 컨텍스트 설정

사용 중인 환경에 맞는 일반적인 skill 설치 흐름을 따른 다음, SKILL.md, references/failure-patterns.md, references/logging-techniques.md, references/ime-unicode.md, references/rendering-debug.md 순서로 skill 파일을 여세요. 증상과 가장 맞는 참조부터 시작하고, 문제가 여러 도메인을 가로지르는 경우가 아니라면 전부 다 읽을 필요는 없습니다.

hunt 사용을 위한 프롬프트 방법

가장 좋은 hunt 사용법은 수리보다 진단을 먼저 요청하고, 가지고 있는 가장 작은 재현 증상을 함께 주는 것입니다. 강한 입력 예시는 이런 식입니다: “이 회귀를 hunt해줘: Save를 눌러도 새로고침 후 저장이 유지되지 않아; 최신 변경은 src/hooks/user.ts를 건드렸고; 로그에는 cache hit가 보여.” 약한 입력 예시는 이렇습니다: “save가 깨졌어요, 고쳐주세요.”

skill이 기대하는 작업 흐름

hunt 가이드는 먼저 한 문장짜리 가설을 세우고, 그걸 근거로 검증한 뒤, 원인이 검증 가능해질 때만 패치하라고 전제합니다. 실제 흐름은 이렇습니다. 재현하고, 경로를 좁히고, 갈라지는 지점이 보이는 로그나 체크를 하나 수집하고, 전파 경로를 확인한 다음, 가능한 가장 작은 수정과 회귀 테스트를 작성합니다.

실전 읽기 순서

버그가 캐시, 큐, 가드, 빌드 경계 문제처럼 보이면 references/failure-patterns.md를 보세요. 계측된 증거가 필요하면 references/logging-techniques.md를 보세요. CJK 입력이나 composition 문제라면 references/ime-unicode.md가 맞습니다. PDF, 인쇄, 폰트, 레이아웃 실패에는 references/rendering-debug.md를 보세요.

hunt skill FAQ

hunt는 코드 버그에만 쓰는 건가요?

아닙니다. hunt skill은 런타임 오류, 실패하는 테스트, 깨진 생성 산출물, UI 회귀, 출력 불일치처럼 구체적인 실패 모드 전반을 디버깅하는 데 쓰입니다. 순수한 코드 리뷰나 기능 설계에는 맞지 않습니다.

정확한 근본 원인을 먼저 알아야 하나요?

아니요. 다만 반증 가능한 가설은 있어야 합니다. 이 skill은 “뭔가 잘못됐다”에서 “Y라는 근거 때문에 근본 원인이 X라고 본다”로 이동하도록 돕기 위해 만들어졌습니다.

hunt가 일반 프롬프트보다 더 나은가요?

실패가 모호하거나 반복적일 때는 보통 그렇습니다. 일반 프롬프트는 패치를 바로 내놓을 수 있지만, hunt는 먼저 추측을 줄여서 다른 경로를 망가뜨릴 가능성을 낮춥니다.

언제 hunt를 쓰지 말아야 하나요?

새 기능을 추가하는 중이거나, 버그 없이 리팩터링하는 상황이거나, 이미 검증된 최소 수정이 있고 구현 도움만 필요한 경우에는 건너뛰세요. 고수준 아키텍처 브레인스토밍에도 가장 잘 맞는 도구는 아닙니다.

hunt skill 개선 방법

처음부터 더 강한 증거를 제공하세요

증상, 최신 변경 사항, 정확한 환경, 그리고 구체적인 관찰 1~2개를 함께 주세요. 예를 들면 이런 식입니다: “cold start에서만 실패한다”, “cache clear 후에는 통과한다”, “macOS에서 CJK 입력일 때 깨진다”, “PDF는 로컬에서는 렌더링되지만 CI에서는 안 된다.” 이렇게 하면 hunt가 올바른 실패 패턴을 즉시 고르기 쉬워집니다.

흔한 실패 모드를 피하세요

가장 큰 실수는 원인이 좁혀지기 전에 먼저 수정만 요구하는 것입니다. 또 다른 흔한 실패는 관찰 가능성이 너무 모호한 경우입니다. 에러 메시지만 보여 주고, 어떤 분기인지, 어떤 순서인지, 어떤 상태 전환인지 구분할 수 없는 로그가 대표적입니다. 잡음을 더 늘리지 말고, 서로를 가를 수 있는 증거를 추가하세요.

첫 번째 시도 뒤에는 계속 좁혀 가세요

첫 진단이 불완전하다면, 전체 프롬프트를 다시 시작하기보다 새로운 관찰을 덧붙여 응답하세요. hunt skill은 가설, 확인, 반례, 더 강한 가설로 이어지는 좁혀 가기 루프에서 가장 잘 작동합니다. 그래야 hunt skill 설치에서 신뢰할 수 있는 Debugging workflow까지 도달할 수 있습니다.