mcpField
C
cavecrew

cavecrew

github.com/juliusbrusseeテスト・品質115.8k361.9k 回インストール3 日前に更新
リポジトリ

cavecrew について

cavecrew は、ultracave 風の文体でツール結果を返す 3 つのサブエージェントプリセットで、メインコンテキストの消費を抑えます。範囲が明確な調査、小規模な編集、レビューに向いており、大規模な機能開発には向きません。

主な機能

  1. 01investigator が path:line 形式で定義箇所を返す
  2. 02builder が範囲の明確な小規模編集を担当
  3. 03reviewer が問題点のみを出力し設計コメントは含まない
  4. 04圧縮された出力でメインコンテキストの消費を削減

活用シーン

  1. 01シンボルの定義、呼び出し元、使用箇所の検索
  2. 02既知のファイルへの小規模な修正とその差分のレビュー
  3. 03定義、呼び出し、テストの観点からの並行調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/juliusbrussee/caveman --skill cavecrew

インストール後、Claude Code で/cavecrewを入力して読み込まれたか確認します。

同梱ファイルREADME.md

詳細

Cavecrew は、ウルトラケイブ調で回答する 3 つのサブエージェントプリセットです（ツール実行時は、開始時と終了時にステータスを 1 行ずつ出力し、通常の呼び出しの間には何も出力しません）。役割は Anthropic のデフォルト（Explore、編集スタイルのエージェント、レビュアー）と同じです。違いは、返すツール結果が圧縮されているため、委任ごとにメインコンテキストの消費量を抑えられる点です。

cavecrew と代替手段の使い分け

タスク使用するもの
「X はどこで定義されているか／Y を呼び出しているものは何か／Z の使用箇所を一覧表示」cavecrew-investigator
同じ内容で、提案やアーキテクチャに関するコメントも必要Explore（標準）
範囲が明確な、対象を絞った編集（2 ファイル以下）cavecrew-builder
新機能／3 ファイル以上／横断的なリファクタリングメインスレッド、またはインストールされている場合は feature-dev:code-architect
差分、ブランチ、またはファイルのバグをレビューcavecrew-reviewer
根拠と代替案を含む詳細なコードレビューインストールされている場合は Code Reviewer（標準）、それ以外はメインスレッド
答えがすでにわかっている一行の質問メインスレッド。サブエージェントは使わない

目安：サブエージェントの出力を 1/3 のトークン数で得たいなら cavecrew を選びます。文章での回答が必要なら標準を選びます。

これが存在する理由（本当の利点）

サブエージェントのツール結果は、そのままメインコンテキストに挿入されます。標準の Explore が 2k トークンの文章を返すと、そのたびにメインコンテキストの予算を 2k トークン消費します。同じ調査結果でも、cavecrew-investigator なら圧縮された path:line テーブルとして返されます。1 回のセッションで 20 回委任する場合、コンテキストの枯渇を招くか、タスクを完了できるかの違いになります。

出力契約

各エージェントからメインスレッドが受け取れる内容：

cavecrew-investigator

<Header>:
- path:line — `symbol` — short note
totals: <counts>.

または No match.。常にファイルパスを先頭に置き、行番号を付け、シンボルをバッククォートで囲みます。path:\d+ で安全に grep できます。

cavecrew-builder

<path:line-range> — <change ≤10 words>.
verified: <re-read OK | mismatch @ path:line>.

または次のいずれか：too-big. ／ needs-confirm. ／ ambiguous. ／ regressed.（先頭のトークンが終端状態を示します）。

cavecrew-reviewer

path:line: <emoji> <severity>: <problem>. <fix>.
totals: N🔴 N🟡 N🔵 N❓

または No issues.。指摘はファイル、次に行番号の昇順で並びます。

連携パターン

場所を特定 → 修正 → 検証（最も一般的）：

  1. cavecrew-investigator が該当箇所の一覧を返します。
  2. メインスレッドが 1～2 か所を選び、そのパスを cavecrew-builder に渡します。
  3. cavecrew-reviewer が差分を監査します。

並列調査（調査範囲が広い場合）： 1 つのメッセージで cavecrew-investigator を 2～3 回呼び出します（定義、呼び出し元、テストなど、異なる観点で調査）。結果はメインスレッドでまとめます。

単発編集（該当箇所がすでにわかっている場合）： investigator は使わず、正確な path:line を cavecrew-builder に直接渡します。

してはいけないこと

  • ファイルがまだわからない状態で cavecrew-builder を使わないでください。先に investigator を呼び出してください。そうしないと、メインスレッドでコンテキストを渡すためにトークンを消費します。
  • 5 ファイルにわたるリファクタリングで cavecrew-investigator → cavecrew-builder と連携させないでください。builder は too-big. を返すため、1 ターン無駄になります。
  • cavecrew-reviewer に「一般的なフィードバック」を求めないでください。返すのは指摘のみで、アーキテクチャに関する意見は含みません。インストールされている場合は、その用途には Code Reviewer を使ってください。
  • 文章での回答を期待しないでください。Cavecrew の出力は構造化されており、簡潔すぎてわかりにくいこともあります。人が直接読む場合は、言い換えてください。

自動で平易な表現に切り替える機能（継承）

サブエージェントは、セキュリティ警告、取り消しできない操作の確認、および断片的な表現が誤解を招く可能性のある出力について、原始的な話し方から通常の英語に切り替えます。その後は原始的な話し方に戻ります。

コメント

Markdown 対応