caveman-learn
Caveman の CLI が手元の会話履歴から出した「トークンの行き先」の報告を読み、重い CLAUDE.md の削減や繰り返し貼る文の記憶への移し替えを、1 件ずつ承認を取って当てさせる。当てたあとは測り直し、減らなければ元に戻させる
npx skills add juliusbrussee/caveman/caveman-learn入れる前にこのスキルがすること・注意点・SKILL.md の原文を確かめてください。解析は安全性の判定ではありません。
- インストール
- 113,113
- 実用度
- 17
- GitHub star
- 117,973
- 最終更新
- 2026/11/6
頼み方の例
そのままコピーして使えますcaveman-learnを使って、caveman learn の報告を読み、トークンの行き先を大きい順に見せてください。直すのは私が選んだものだけにして、1 件ごとに差分を見せて、私が「はい」と言うまでファイルは書き換えないでください。
対象のファイルや状況は、ご自身の作業に合わせて置き換えてください。
このスキルがすること
SKILL.md の記述から機械的に抽出- 実行可能なスクリプトが 2 件同梱されています（JavaScript）
これは安全性の判定ではありません。 SKILL.md にそう書かれているという事実だけを並べています。実際に問題があるかは使い方と文脈で決まるため、当サイトでは断定しません。導入前に SKILL.md の原文を確認してください。
SKILL.md の規模
いつ使うか
Claude Code や Codex の「毎回読み込まれる設定」が重くなってきて、どこを削れば効くのか知りたいときのスキルです。測るのは Caveman の CLI の caveman learn で、このスキルはその報告を受けて実際に直す側を受け持ちます。
公開元はこの分担をはっきり分けています。CLI の分析は読むだけで、ファイルを書き換えるのはこのスキルだけ、しかも利用者が「はい」と言ったあとだけです。
- 行き先の扱いの分け方
- 5 種
- 承認を取る単位
- 1 件ずつ
- SKILL.md（2026-10-23 時点）
- 11,515 バイト
流れ
- 報告を読む
caveman learn report --jsonを流し、スコアの内訳と行き先の一覧を大きい順に見せる - 選んでもらう直す行き先は利用者が選ぶ。選ばれなかったものには触らない
- 案を出す種類ごとの手順で差分を作り、前と後のトークン数を並べて「はい／いいえ」を聞く
- 当てて測り直す承認されたら自分の道具で書き換え、数え直す。減っていなければ戻す
- 記録する測り直しを通ったものだけ
caveman learn appliedで台帳に残す
案を出す前に caveman learn simulate で過去の履歴に当てはめた規模を見せてもよい、と書かれています。ただし過去の合計であって、この先の予測ではないと断ったうえで見せる決まりです。
行き先の種類で手順が変わる
| 種類 | 例 | このスキルの扱い |
|---|---|---|
| 削れるもの | 重い CLAUDE.md、一度も呼ばれないスキル | 差分を出し、承認後に当て、数え直して減らなければ戻す |
| 繰り返し貼る文 | 会話のたびに貼り直している長い塊 | Caveman の記憶（cavemem）へ移し、短い案内だけ残す |
| 手順の繰り返し | 何度も同じ道具の手順をなぞっている | スキルに書き起こす案を出し、オンとオフの比較を始める |
| 記憶と規則の点検 | 重複した規則、索引に無いメモ、壊れた読み込み | 1 件ごとに承認を取って直す |
| 要るもの | 動作に欠かせない設定 | 決して触らない。スコアを正直に出すためだけに載っている |
このほか、習慣の観察（行動の傾向）もあります。数字は事実として見せ、提案は控えめに言い、命令の形にしない決まりです。
繰り返し貼る文を記憶へ移す手順
いちばん手数が多いのがここです。報告には塊の本文は入っておらず、どこにあるかの手がかりとハッシュ（SHA-256）だけが入っています。エージェントは会話の記録から塊を自分で読み直し、ハッシュが一致しなければ「スキャンのあとで変わった」として中止します。
一致したら、塊を一時ファイルに書いて caveman mem remember --stdin で記憶に入れます。コマンドラインに塊を直接置くと、シェルがバッククォートや変数を展開してしまうので、標準入力から渡す決まりです。
移したあと、元の CLAUDE.md や AGENTS.md から塊を消し、caveman mem recall で呼び戻せることを示す案内文を置きます。呼び戻しが空振りする、または案内文を置けていないなら、記憶を消して元の文を戻します。
記憶と規則の点検で見るもの
CLAUDE.md・CLAUDE.local.md・.claude/rules・AGENTS.md・GEMINI.md と、Claude Code の自動の記憶（MEMORY.md と、そこから張ったメモ）が相手です。重複した規則、索引から張られていないメモ、MEMORY.md が長すぎて末尾が読まれない状態、存在しない先を指す読み込み、消えたファイルへの参照、埋もれた強い規則、の 6 種を扱います。
MEMORY.md が長すぎるときは、消すより先に索引を詰めること（1 項目 1 行、古い項目をまとめる、詳細はメモへ移す）を勧めています。記憶の中身は、利用者の「はい」が無ければ消さない決まりです。
使わないほうがいいとき
Caveman の CLI を入れていないとき
手順の最初が caveman learn report --json で、報告が無ければ何も始まりません。このスキルだけを入れても、トークンの行き先は測れません。
公開元の文書では、CLI の caveman learn implement がこのスキルを入れたうえでエージェントを開く入口になっています。CLI を使うなら、そちらから入るほうが順番がそろいます。
まとめて一気に直したいとき
本文は、個々の差分を隠す「全部当てる」を認めていません。件数が多くても、1 件ずつ見て承認する前提です。
口調を短くしたいだけのとき
これは設定と記憶の重さを削る道具で、応答の文体には触りません。応答を短くしたいなら caveman、CLAUDE.md の文そのものを縮めたいなら caveman-compress が向いています。
注意点
設定と記憶のファイルを書き換える
SKILL.md には、シェル実行（caveman の各コマンド）とファイル書き換えの記述があります。外部通信の記述はありません。書き換えるのは CLAUDE.md・AGENTS.md・規則のファイル・MEMORY.md とそのメモ、それに一時ファイルと Caveman の記憶の保管先です。
どれも 1 件ごとの承認のあとに限られ、何を変えたかを正確に報告せよ、と書かれています。記憶へ移したものは caveman mem forget と元の文の復元で戻せる、という戻し方も本文にあります。
「節約できた」の言い方に縛りがある
節約の台帳は、測り方ごとに分けて見せます。編集したファイルを数え直したもの、前後の会話を比べたもの、まだ何とも言えないもの、の 3 段です。段をまたいで足し合わせない、1 つの数字にまとめない、成果として見せる行には付いている但し書き（交絡の要因）を必ず読み上げる、と書かれています。
費用の数字は、スキャンした期間にかかった額としてだけ出し、月や年に引き延ばしません。定額の契約なら追加の支払いは 0 で、数字は API に換算した値にすぎない、と添えるよう指示されています。
手順の書き起こしは、効くかどうか分からない
手順をスキルに書き起こすと、そのスキルの説明が毎回読み込まれ、効くのはその手順を踏む回だけです。本文はこれを、削減の判定とは別の扱いにし、効き目は未確認だとはっきり言わせます。
比べ方は、スキルを入れた期間と外した期間を交互に作る形で、それぞれ 5 回以上の会話が要ります。結果が「悪化」ならスキルを消すよう、遠回しにせず言う決まりです。
同梱ファイル
SKILL.md のほかに 5 件あります（2026-10-23 時点）。説明の README.md と CLAUDE.md、package.json、テストが 2 件です。テストは、承認を 1 件ずつ取ること・元に戻せること・数字を確かめ済みと言わないこと、などが本文に書かれているかを確かめるものです。
インストール数の推移
日次で記録10月14日 〜 11月7日（24日分）
インストール数と 1 日あたりの増加は Skillselion が に集計した値です。上流の更新は数日おきなので、前日比ではありません。GitHub star と最終更新は に GitHub から取得しました。
併用すると強いスキル
よくある質問
手元の会話履歴はどこかへ送られますか
このスキルの SKILL.md には外部へ送る手順がありません。測る側の caveman learn について、公開元の文書は手元の設定ファイルと会話履歴を読み、どこにも送らないと説明しています。結果は手元の Caveman の保管先に報告のファイルとして書かれます。
本文の Cave Score と、Caveman Cloud のスコアは同じものですか
公開元の文書では、手元の caveman learn のスコア（画面では Setup Score、JSON では cave_score）は、この機械の設定の軽さを表すもので、Caveman Cloud の組織向けのスコアとは尺度が違い、一致しないと説明されています。お金の額でもありません。
承認したのに、変更が取り消されました
削る変更は、当てたあとに数え直して毎回の読み込みが減っていなければ戻す決まりなので、それに当たった可能性があります。記憶へ移す変更なら、呼び戻しが空振りした、案内文と呼び戻しの費用が元より重かった、塊のハッシュが合わなかった、のいずれかで取り消されます。どれも、エージェントが必要な文脈を失わないようにするための判定です。
Codex でも使えますか
使えます。同梱の README と CLAUDE.md は、Claude Code ならリポジトリの .claude/skills、Codex なら Codex のスキルの置き場所に入れる手順を書いています。本文の点検の対象にも AGENTS.md が入っています。