Cavemanエビデンスレビュー

Caveman Cloudの証拠(コスト、Cave Score、ワークフロー、トレース、レイテンシ、エラー、ルーティング、節約額)を読み取り専用でレビューします。Cavemanが発見した内容やLLMの費用の使途を尋ねられたときに使用します。

Cavemanエビデンスレビュー とは?

このスキルは、Caveman Cloudの可視化データを読み取り専用でレビューし、コスト、Cave Score、ワークフロー、トレース、レイテンシ、エラー、ルーティング、節約額に関する結論を導き出します。実際の計測コスト、推論された毎日のヘッドルーム、検証済み台帳節約額を明確に区別し、それらを混同することなく報告します。MCPツール(caveman_context、caveman_report、caveman_plan、caveman_trace_search、caveman_trace_get)またはCLIフォールバックを使用して、プロジェクトのコンテキストを読み込み、ベースラインを確立し、トレースを検索・検査します。空の結果は「シグナルがない」ことを示し、コストゼロやリスクゼロを意味しないと解釈します。このスキルは「読み取り専用」であり、実験の開始、承認、キャンセル、ロールバックは一切行いません。ユーザーが明示的に要求した場合を除き、プロンプト、補完、ツール、アーティファクトのペイロードは取得せず、メタデータ、スパン、タイミング、モデル、トークン数、ステータス、最適化情報に限定します。

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

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

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

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

ドキュメント

Cavemanエビデンスをレビューする

読み取り専用オペレーターとして行動します。現在のCavemanデータから結論を構築し、リポジトリの推測からは構築しません。このスキルから実験を開始、承認、キャンセル、またはロールバックしてはいけません。

ハードルール

  1. 以下のバケットは別々に保つこと:
    • 計測されたプロバイダ完全リスト価格コスト;
    • inferred 毎日のヘッドルーム;
    • verified 台帳節約額;
    • 証拠コスト。 これらを追加したりラベルを変更してはいけません。
  2. ユーザーが明示的にペイロードレビューを要求しない限り、プロンプト、補完、ツール、またはアーティファクトのペイロードを取得しないこと。メタデータ、スパン、タイミング、モデル、トークン数、ステータス、最適化情報はデフォルトのレビューに十分です。
  3. すべての読み取りは、Cavemanコンテキストによって選択されたプロジェクトにスコープを限定すること。組織IDを提供してはいけません。
  4. 空の結果は、現在のシグナルがない証拠であり、コストゼロやリスクゼロではありません。
  5. トレースIDと使用した正確な時間枠を引用すること。単一の集計から原因を主張してはいけません。

ステップ1 — コンテキストを読み込む

MCPを推奨:

caveman_context {}

CLIフォールバック:

caveman cloud whoami
caveman cloud projects list

ログインまたはプロジェクト選択がない場合は停止し、ユーザーに caveman login の実行またはプロジェクトの選択を依頼します。決して推測しないでください。

ステップ2 — ベースラインを確立する

caveman_report を以下のために使用:

  • overview
  • costs
  • score
  • workflows
  • verified_savings

次に caveman_plan を使用してランク付けされた毎日のヘッドルームを取得します。質問が狭い場合は、無関係なレポートをスキップします。質問に答えるために必要な最短のセットを読み取ります。

CLIフォールバック:

caveman cloud costs
caveman cloud score
caveman cloud plan --json

方向性を解釈する前に、レポートのウィンドウと基準を述べてください。

ステップ3 — トレースで主要な説明をテストする

caveman_trace_search を使用します。境界のあるウィンドウと閉じたフィルターを選択:ワークフロー、エージェント、モデル、プロバイダ、エラーコード、ランタイムモード、キャッシュステータス、最適化ID、ステータスクラス、トークン/コスト/レイテンシ境界、圧縮、またはモニター判定。

有用なグループ化:

  • workflow — コストや障害を引き起こしているジョブを見つける;
  • model — モデル構成を比較する;
  • session — リトライやループ動作を特定する;
  • グループ化なし — 正確なトレースを特定する。

疑わしいコホートを対照コホートまたは以前の境界ウィンドウと比較します。1つの高コストトレースから因果関係を推論しないでください。

CLIフォールバック:

caveman cloud traces search \
  --workflow <slug> \
  --from <RFC3339> \
  --to <RFC3339> \
  --sort total_cost_usd \
  --dir desc \
  --limit 25

ステップ4 — 代表的なトレースを検査する

少数の高シグナルトレースIDに対して caveman_trace_get を呼び出します。リクエストとスパンのメタデータ、レイテンシ、ステータス、トークン数、キャッシュ状態、適用されたオプティマイザー、モデルルートを検査します。ペイロードの取得はオフに保ちます。

CLIフォールバック:

caveman cloud traces show <trace-id> --spans

ステップ5 — 報告する

以下の形式を使用します:

## Cavemanエビデンスレビュー

スコープ:<プロジェクト> · <開始日時> から <終了日時>
計測コスト:<値と基準>
検証済み節約額:<台帳値、別に保持>
推論ヘッドルーム:<1日あたりの範囲、別に保持>

発見事項:
1. <発見事項> — <集計エビデンス> — トレース <ID>
2. <発見事項> — <集計エビデンス> — トレース <ID>

未証明:
- <対照群、トレース、または評価がないもっともらしい説明>

次の読み取り専用チェック:
- <1つの境界クエリ>

可能なアクション:
- <提案のみ;読み取り専用ライフサイクルレビューとセーフティゲートには caveman-manage を使用>

データがない場合は、欠落しているシグナルを名前で示し、最も強い裏付けのあるステートメントで止めてください。カタログ小計を請求書にしたり、実験結果を検証済み節約額に変換したりしないでください。

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-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/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.

関連スキル