# 먼저 조사하기 (investigate-first)

> 원인이 불분명한 장애는 먼저 증거를 모으고 증거 순으로 가설을 정리한 뒤 제품 코드를 손댑니다.

- 카테고리: [테스트·디버깅](https://www.myskills.tools/ko/categories/testing-debugging/)
- 출처: 커뮤니티 · Julius Brussee
- 저장소: https://github.com/JuliusBrussee/caveman/tree/main/skills/investigate-first (commit 82864c8)
- SKILL.md: https://github.com/JuliusBrussee/caveman/blob/main/skills/investigate-first/SKILL.md
- 설치 명령: `npx skills add JuliusBrussee/caveman --skill investigate-first`
- 라이선스: Apache-2.0
- 호환 도구: Claude Code, Codex, Gemini CLI
- 권한: read-repo ✓, write-files ✗, shell ✗, network ✗
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.

## 핵심 규칙

하나의 믿을 만한 메커니즘이 모든 증거를 설명하기 전에는 코드를 바꾸지 않습니다.

## 실행 단계

1. **현상과 추론 구분** — 관찰한 현상과 추론한 원인을 나눠서 다룹니다.
2. **증거 추적** — 입력, 상태 전이, 소유권 경계, 실패 출력을 추적합니다.
3. **가설 순위화** — 증거 강도와 저비용 반증 가치로 가설을 정렬하고, 증거가 충분하면 탐색을 멈춥니다.
4. **원인과 근거 보고** — 원인과 근거, 또는 정확한 차단 요인을 보고하며 허가 없이 수정하지 않습니다.

## 권한 설명 (SKILL.md 기준)

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 일부 필요 | 조사 중에는 제품 코드를 바꾸지 않으며, 구현이 허가된 경우에만 수정합니다. |
| 명령 실행 | 필요 없음 | 특정 명령 실행을 요구하지 않습니다. |
| 네트워크 송신 | 필요 없음 | 네트워크 접근을 요구하지 않습니다. |

## SKILL.md 프런트매터(YAML)

```yaml
---
name: investigate-first
description: Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/investigate-first/