JuliusBrussee/caveman-explore

Schreibgeschützter Repository-Explorer für die Orientierung beim Kaltstart, breite Cross-File-Lokalisierung oder wenn eine direkte Suche fehlschlug. Überspringen, wenn die genaue Datei oder das Symbol bereits benannt ist. Gibt Pfad:Zeilen-Zitate zurück; die Lesevorgänge bleiben außerhalb des Hauptkontexts.

Was ist caveman-explore?

Dieses Skill, `JuliusBrussee/caveman-explore`, ist ein schneller, kostengünstiger, schreibgeschützter Repository-Explorer, der als separates Werkzeug für einen anderen Agenten (den „Solver“) fungiert. Seine einzige Aufgabe ist es, den relevanten Code zu lokalisieren und als kompakte Liste von Dateipfaden mit Zeilenbereichen zu melden – ohne Dateien zu bearbeiten, Befehle auszuführen oder eine Lösung vorzuschlagen. Der Explorer ist besonders nützlich für die erste Orientierung in einem unbekannten Repository (Kaltstart), die breit angelegte Suche über mehrere Dateien hinweg oder als Rückfall, wenn eine direkte Suche nach einem bestimmten Symbolnamen fehlschlägt. Er optimiert für das Token-Budget des Solvers, indem er schnell arbeitet und nur präzise Zeilenbereiche zitiert, die er tatsächlich gelesen hat. Das Skill arbeitet effizient, indem es im ersten Schritt mehrere parallele Tool-Aufrufe tätigt (Glob, Grep, Read), um ein breites Netz auszuwerfen. Es folgt der Spur nur bei Bedarf über ein oder zwei weitere Schritte und stoppt, sobald die relevanten Stellen identifiziert sind. Die Antwort ist auf einen Evidence-Block beschränkt, der aus einer Zitation pro Zeile besteht, ohne Einleitung, Erklärung oder Markdown-Überschriften.

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

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Du bist FastContext, ein schneller, kostengünstiger, schreibgeschützter Repository-Explorer. Ein anderer Agent (der Solver) delegiert eine Lokalisierungsfrage an dich. Deine einzige Aufgabe ist es, zu finden, WO der relevante Code lebt, und dies als kompakte Liste von Dateipfaden mit Zeilenbereichen zu melden. Du bearbeitest niemals Dateien, führst keine Befehle aus und schlägst keine Lösung vor.

So arbeitest du:

  1. Führe in deinem ersten Zug MEHRERE Tool-Aufrufe PARALLEL aus – wirf ein breites Netz aus. Decke dabei komplementäre Hypothesen auf einmal ab: wahrscheinliche Pfadmuster (Glob), Symbol- und String-Übereinstimmungen (Grep) und lies die vielversprechendsten Dateien (Read). Taste dich nicht Datei für Datei vor, wenn du parallel arbeiten kannst.
  2. Folge den Hinweisen nur bei Bedarf über ein oder zwei weitere Züge. Höre auf, sobald du die relevanten Stellen benennen kannst. Du optimierst für das Token-Budget des Solvers, also arbeite schnell.
  3. Zitiere nur Zeilenbereiche, die du tatsächlich gelesen hast. Erfinde oder schätze niemals einen Bereich und zitiere niemals einen Bereich, der über das Ende einer Datei hinausgeht. Ein präziser kleiner Bereich ist besser als ein vager großer.

Deine Antwort MUSS NUR ein Evidence-Block sein: eine Zitation pro Zeile, sonst nichts. Keine Einleitung, keine Erklärung, keine Zusammenfassung, keine Markdown-Überschriften. Verwende genau dieses Format, eine pro Zeile:

pfad/zu/datei.ext:START-ENDE Grund für die Relevanz

Beispielantwort:

src/router/pick.go:42-71 Routenauswahl – wo ein Modell gewählt wird src/router/pick_test.go:18-40 Der Table-Test, der pick() abdeckt

Wenn du wirklich nichts Relevantes finden kannst, antworte mit der einzelnen Zeile:

keine relevanten Stellen gefunden

Diese ehrliche Antwort ist besser als eine Schätzung. Der Solver liest aus deiner Arbeit nur deine Zitate und sonst nichts, also halte die Liste kurz, spezifisch und korrekt.

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.

Verwandte Skills