Community코딩 & 개발github.com

먼저 조사하기

모호한 실패를 진단하여 편집 전에 증거 기반 가설을 수립합니다. 알 수 없는 원인, 간헐적 동작, 성능 저하 또는 증거 기반 가설이 필요한 조사에 사용합니다.

먼저 조사하기란 무엇인가요?

이 스킬은 개발자가 코드를 변경하기 전에 먼저 증거를 수집하고 분석하도록 유도합니다. 관찰된 증상과 추론된 원인을 분리하고, 입력, 상태 전환, 소유권 경계 및 실패 출력을 추적합니다. 가설을 증거와 저렴한 반증 가치에 따라 순위를 매기며, 하나의 신뢰할 수 있는 메커니즘이 모든 증거를 설명할 때까지 코드를 편집하지 않습니다. 원인의 이름을 밝히거나 정확한 차단 요소를 식별할 수 있을 만큼 증거가 충분해지면 탐색을 중단합니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있어, 디버깅 및 조사 작업의 체계성과 신뢰성을 높여줍니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuliusBrussee/caveman/tree/main/skills/investigate-first

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

먼저 조사하기은(는) 무엇을 하나요?

제품 코드를 변경하기 전에 증거를 수집하세요.

  • 관찰된 증상과 추론된 원인을 분리하세요.
  • 입력, 상태 전환, 소유권 경계 및 실패 출력을 추적하세요.
  • 가설을 증거와 저렴한 반증 가치에 따라 순위를 매기세요.
  • 하나의 신뢰할 수 있는 메커니즘이 모든 증거를 설명할 때까지 편집하지 마세요.
  • 원인의 이름을 밝히거나 정확한 차단 요소를 식별할 수 있을 만큼 증거가 충분해지면 탐색을 중단하세요.

원인과 증거를 보고하세요. 작업이 구현을 승인하지 않는 한 수정하지 마세요.

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

JuliusBrussee/caveman-discover

Find and label every LLM workflow in the repository so Caveman Cloud groups spend by workflow instead of one bucket. Use for "discover workflows" or breaking LLM spend down by workflow.

JuliusBrussee/caveman-evidence-review

Read-only review of Caveman Cloud evidence: cost, Cave Score, workflows, traces, latency, errors, routing, savings. Use when asked what Caveman found or where LLM spend goes.

JuliusBrussee/caveman-explore

Read-only repository explorer for cold-start orientation, broad cross-file localization, or when a direct search failed. Skip it when the exact file or symbol is already named. Returns path:line citations only; its reads stay out of main context.

JuliusBrussee/caveman-learn

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

JuliusBrussee/caveman-manage

Inspect Caveman Cloud's experiment lifecycle and block unsafe execution. Use when asked to start, approve, cancel, promote or roll back a Caveman experiment.

JuliusBrussee/caveman-optimize

Turn a Caveman optimization observation into an operator-chosen candidate with a paired baseline evaluation. Use when asked to inspect or evaluate a Caveman optimization report. Needs explicit approval.

JuliusBrussee/caveman-setup

Wire a repository through the Caveman Cloud gateway so every LLM request is measured, with no behavior change. Use for "set up caveman" or adding LLM spend observability.

JuliusBrussee/lean-build

Build feature work with high overbuilding risk. Use for new behavior, product slices, or integrations where repository reuse, strict scope, and an explicit stop condition matter.

JuliusBrussee/migration

Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.

JuliusBrussee/safe-refactor

Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits.

JuliusBrussee/surgical-patch

Fix bugs and small behavior changes at the narrowest responsible layer. Use when regression proof, preserved surrounding behavior, and task-relevant tests matter.

JuliusBrussee/verify-and-stop

Prove existing work meets acceptance conditions without expanding scope. Use for validation-only tasks, completion checks, focused gate runs, and last-mile proof.

관련 스킬