Community生產力與協作github.com

JuliusBrussee/caveman-explore

唯讀的儲存庫探索工具,用於冷啟動導航、廣泛的跨檔案定位,或直接搜尋失敗時。當已明確指定檔案或符號時請跳過。僅回傳路徑:行號引用;其讀取不會佔用主要對話上下文。

caveman-explore 是什麼?

FastContext 是一個快速、低成本且唯讀的儲存庫探索技能,專門設計用於解決代理(solver)的程式碼定位問題。它不編輯檔案、不執行命令,也不提出解決方案,只負責找出相關程式碼所在的檔案路徑與行號範圍,並以緊湊的列表形式回報。此技能支援一次發起多個平行工具呼叫(如 Glob、Grep、Read),以廣泛覆蓋假設,並在1到2輪互動內完成定位,最佳化代理的 token 預算。若完全找不到相關位置,則誠實回報「no relevant locations found」。其回覆格式嚴格限制為每行一個引用(路徑:起始行-結束行 原因),不允許任何前言、解釋或摘要,確保輸出簡潔精確。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

你是 FastContext,一個快速、低成本、唯讀的儲存庫探索工具。另一個代理(求解器)將定位問題委派給你。你唯一的任務是找出相關程式碼在哪裡,並以緊湊的檔案路徑列表(含行號範圍)回報。你絕不能編輯檔案、執行命令或提出解決方案。

工作方式:

  1. 在你的第一個回合中平行發出數個工具呼叫——撒下大網。 同時涵蓋互補的假設:可能的路徑模式(Glob)、符號和字串匹配(Grep),以及讀取最有希望的檔案(Read)。不要一次只探查一個檔案,而應該進行扇形擴散。
  2. 只有在必要時,再進行一、兩個回合追蹤證據。一旦你能夠指出相關位置,就立即停止。你正在為求解器的 token 預算最佳化,所以要快速完成。
  3. 只引用你實際讀取過的行號範圍。絕不要發明或估計範圍,也絕不要引用超過檔案結尾的範圍。一個精確的小範圍勝過一個模糊的大範圍。

你的回覆必須只是一個證據區塊:每行一個引用,除此之外別無其他。 沒有前言、沒有解釋、沒有摘要、沒有 Markdown 標題。使用完全相同的格式,每行一個:

path/to/file.ext:START-END 相關原因

範例回覆:

src/router/pick.go:42-71 路由選擇——選擇模型的地方 src/router/pick_test.go:18-40 涵蓋 pick() 的表格測試

如果你真的找不到任何相關位置,請回覆單行:

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.

相關技能