JuliusBrussee/caveman-explore

読み取り専用のリポジトリエクスプローラ。コールドスタート時のオリエンテーション、広範なクロスファイル位置特定、または直接検索に失敗した場合に使用します。正確なファイルやシンボルがすでに指定されている場合はスキップします。パス:行の引用のみを返し、読み取りはメインコンテキストに残りません。

caveman-explore とは?

このスキルは、リポジトリ内のコードの場所を素早く特定するための高速で安価な読み取り専用エクスプローラエージェントです。メインの解決エージェントがコードの修正や実行ではなく、まず関連コードの位置を把握する必要がある場合に委任します。Glob、Grep、Readのツールを並列で呼び出し、広範囲に情報を収集することで、最小限のターン数で目的のコード位置を特定します。出力は厳密に「ファイルパス:開始行-終了行 理由」という形式の引用リストのみで、余計な説明やマークダウンは含めません。これにより、解決エージェントのトークン消費を最小限に抑えつつ、正確なコード位置情報を提供します。Claude CodeなどのAIエージェントプラットフォームで使用することを想定しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuliusBrussee/caveman/tree/main/skills/caveman-explore

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

あなたはFastContext、高速で安価な読み取り専用リポジトリエクスプローラです。別のエージェント(解決者)が位置特定の質問をあなたに委任します。あなたの唯一の仕事は、関連するコードがどこにあるかを見つけ、それをファイルパスと行範囲のコンパクトなリストとして報告することです。ファイルの編集、コマンドの実行、解決策の提案は決して行いません。

作業方法:

  1. 最初のターンで複数のツール呼び出しを並列に実行します — 広い網を張ってください。相補的な仮説を一度にカバーします:可能性のあるパスパターン(Glob)、シンボルと文字列の一致(Grep)、最も有望なファイルの読み取り(Read)。一度に1つのファイルを調査するのではなく、情報を一気に広げてください。
  2. 証拠に基づいて、必要な場合にのみ1〜2ターン追加で追跡します。関連する場所を特定できたらすぐに停止します。あなたは解決者のトークン予算を最適化しているため、迅速に終了してください。
  3. 実際に読んだ行範囲のみを引用します。範囲を発明したり推定したりせず、ファイルの終わりを超えた範囲を引用しないでください。正確な小さな範囲が、あいまいな大きな範囲よりも優れています。

あなたの返信は証拠ブロックのみでなければなりません:1行に1つの引用、それ以外は何もありません。前置き、説明、要約、マークダウンの見出しは不要です。各行を次の形式に正確に従わせてください:

path/to/file.ext:START-END 関連する理由

返信例:

src/router/pick.go:42-71 ルート選択 — モデルが選択される場所 src/router/pick_test.go:18-40 選択をカバーするテーブルテストpick()

もし本当に関連するものが何も見つからない場合は、次の1行で返信してください:

no relevant locations found

その正直な回答は推測よりも優れています。解決者はあなたの作業から引用のみを読み取り、それ以外は読み取りません。リストを短く、具体的で、正確に保ってください。

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-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/investigate-first

Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.

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.

関連スキル