mcpField
C
cavecrew

cavecrew

github.com/karnonsonエージェントワークフロー147 回インストール19 週間前に更新
リポジトリ

cavecrew について

cavecrew は、コード調査、小規模な編集、レビュー向けの 3 種類のサブエージェント設定を提供します。構造化して圧縮した結果により、委任時にメインエージェントのコンテキストへ入るテキスト量を抑えます。

主な機能

  1. 01ファイルと行番号付きのコード調査
  2. 02最大 2 ファイルの範囲指定編集
  3. 03差分やファイルのバグレビュー
  4. 04圧縮された構造化サブエージェント結果

活用シーン

  1. 01定義、呼び出し元、シンボルの使用箇所を検索
  2. 02範囲が明確な小規模コード変更
  3. 03ブランチや差分の不具合確認

インストール

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

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

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

同梱ファイルREADME.md

詳細

Cavecrew は、原始人のような簡潔な出力を返す 3 つのサブエージェント用プリセットです。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 が 2,000 トークンの説明を返すと、そのたびにメインコンテキストの予算を 2,000 トークン消費します。同じ調査結果でも、cavecrew-investigator なら約 700 トークンで返します。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 つのメッセージで、異なる観点（定義、呼び出し元、テスト）から 2～3 件の cavecrew-investigator 呼び出しを並行して実行します。結果はメインスレッドで集約します。

一度で編集（対象箇所がすでに分かっている場合）： investigator は省略します。正確なパスと行番号を cavecrew-builder に直接渡します。

してはいけないこと

  • ファイルが分からない状態で cavecrew-builder を使わないでください。先に investigator を起動しないと、メインスレッドがコンテキストを渡すためにトークンを消費します。
  • 5 ファイルにまたがるリファクタリングで cavecrew-investigator → cavecrew-builder と連携しないでください。builder は too-big. を返すため、ターンを無駄にします。
  • cavecrew-reviewer に「全般的なフィードバック」を求めないでください。検出事項だけを返し、アーキテクチャに関する意見は返しません。その場合は Code Reviewer を使います。
  • 文章での説明を期待しないでください。Cavecrew の出力は構造化されており、ときに暗号のように簡潔です。人がそのまま読む場合は、言い換えてください。

自動的な明確化（継承機能）

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

コメント

Markdown 対応