1仕組みと動作原理

これは純粋な表示用インストラクションカードです。SKILL.md 本文は静的なクイックリファレンス表（6 つのモード + 4 つのスキル + 無効化方法 + 言語ルール + デフォルトモード設定）そのものであり、スクリプト、ツール呼び出し、ファイル書き込み指示は一切含まれていません。

skills/caveman-help/SKILL.md

Display this reference card when invoked. One-shot — do NOT change mode, write flag files, or persist anything. Output in caveman style.

ここで行われていること：スキルの実行セマンティクスを「本ファイルの内容を caveman スタイルで出力する」ことだけに絞り込んでいます。それ以外はすべて人間向けの表（Modes / Skills / Deactivate / Language / Configure Default Mode）であり、エージェントにコマンド実行、ファイル読み取り、状態変更を求める箇所は一切ありません。

「単発実行・副作用なし」が 2 箇所に明記されています。SKILL.md 本文の記述、およびリポジトリ同梱のスキル動作対照表（出力規約／副作用の 2 列）です。

docs/technical/skills-hooks-and-plugins.md

| `caveman-help` | One-shot command card | Does not change active mode |

同じ表の比較対象である caveman-stats（ローカルセッションログの読み取り + 状態サフィックスの書き込み）や caveman-compress（選択したローカルファイルの読み書き）に対し、caveman-help の「副作用」列は表内で最もクリーンであり、モードを変更しないことのみを宣言しています。

カードが解説する「デフォルトモード」設定は、ドキュメント上のスローガンではなく実在する仕組みです。ホスト側のフックコードには 4 段階の解決チェーンが存在し、環境変数が最優先で、最終フォールバックは 'full' です。

src/hooks/caveman-config.js

// Resolution order for default mode: // 1. CAVEMAN_DEFAULT_MODE environment variable // 2. Repo-local config (checked-in, per-project default):

カードでは最初の 2 段階である「env > ユーザー設定ファイル > full」しか触れていませんが、実際のコードは env > リポジトリ内の .caveman/config.json または .caveman.json（cwd から上方へ順次検索）> ユーザー設定（$XDG_CONFIG_HOME、~/.config、または %APPDATA%）> 'full' です。差異の詳細は verification.second_pass を参照してください。

モードのセマンティクスは同一リポジトリの caveman メインスキルによって実現され、本カードはそのインデックスに過ぎません。モードはユーザーが変更するかセッションが終了するまで「持続」します。

skills/caveman-help/SKILL.md

Mode stick until changed or session end.

skills/caveman/SKILL.md の Persistence セクション（'Default style for this whole session, every response, until user say "stop caveman" or "normal mode"'）と一致しています。カードは利用可能な段階（lite/full/ultra + 3 つの wenyan バリアント）をユーザーに伝える役割を担い、メインスキルが実際の実行を担当します。

カードは意図的にユーザーの言語を保持します。圧縮されるのはスタイルのみで言語ではありません。専門用語、コード、コマンド、エラー文字列は原文のまま保持されます。

skills/caveman-help/SKILL.md

Keep user's language by default. User write Portuguese → reply Portuguese caveman. Compress the style, not the language. Technical terms, code, commands, commit types, and exact error strings stay verbatim unless user ask for translation.

メインスキルと一致しています（メインスキルではさらに「caveman らしく見せるため」の余計な語句追加も禁止されています）。このルールは多言語チームにおける実用性の鍵となります。用語が翻訳されないため、出力結果をツールや同僚がそのまま直接利用できます。

トリガー面は、ユーザーによる明示的な呼び出し（/caveman-help）と 1 つの自然言語エイリアスで構成され、エイリアスは SKILL.md の description と人間向けの README の両方に記載されています。

skills/caveman-help/README.md

Also triggers on "caveman help", "what caveman commands", "how do I use caveman".

SKILL.md の frontmatter には 'Trigger: /caveman-help or "caveman help"' とのみ記載され、README では 3 つの口語的な聞き方に拡張されています。

配信パス：本スキルは Claude Code プラグインミラーには含まれず（plugins/caveman/skills/ 下には caveman / cavecrew / caveman-stats / caveman-compress のみ配置）、独立した hook+skill インストールパス、`npx skills add`、および CLI による hermes/opencode 向けスキルディレクトリーマニフェストを経由して各ホストに配信されます。

bin/install.js

const HERMES_SKILL_DIRS = ['caveman', 'caveman-commit', 'caveman-review', 'caveman-help', 'caveman-stats', 'caveman-compress', 'cavecrew'];

CLAUDE.md にこの役割分担が明記されています（'Skills not in this table (`caveman-commit`, `caveman-review`, `caveman-help`, `caveman-stats`) are not mirrored into the Claude Code plugin distribution by CI.'）。skills/registry.json の preserved_skill_ids にも caveman-help が含まれています。

2コア機能

011 画面クイックリファレンス：6 つのモード段階とトリガーワード（lite / full / ultra / wenyan-lite / wenyan / wenyan-ultra）

02関連スキルとその出力規約のクイック確認（caveman-commit / caveman-review / caveman-compress / caveman-help 自身）

03解除および復帰コマンドの提示により、ユーザーが「持続」モードから抜け出せなくなるのを防止

04デフォルトモードの 2 つの設定方法（環境変数 CAVEMAN_DEFAULT_MODE、ユーザー設定ファイルの defaultMode フィールド）

05"off" を指定してセッション開始時の自動アクティベーションを無効化しつつ、手動の /caveman を維持

06言語保持ルール：スタイルのみを圧縮し言語は変更せず、専門用語/コード/コマンド/エラー文字列はそのまま保持

07セッション状態を変更しない（モード切り替えなし、フラグファイル書き込みなし、ディスク書き込みなし）、完全な読み取り専用の Q&A

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

自動ロード可能

管理者向け

ソースとバージョンの記録

判定根拠（ファイルパスと抜粋）

SKILL.md: 純粋なプロンプト指示およびルールテキストのみであり、スクリプト実行や外部への影響はありません。

監査ノート： 純粋なインストラクション型であり、スクリプト、ネットワーク、認証情報、書き込みはすべてゼロです。リポジトリの動作対照表でもセッション状態を変更しないものとして個別に記録されています。唯一留意すべき点は、カードの内容がユーザーに対して環境変数や設定ファイルの設定を案内している点です（これは利用上のアドバイスであり、スキル自体の動作ではありません）。

5二重目の独立検証

[ok] 卡片属实：一次性展示、不改模式、不落盘 — SKILL.md 正文首段与 docs/technical/skills-hooks-and-plugins.md 的副作用列两处独立印证；目录内无任何可执行脚本。
[discrepancy] 默认模式配置链（卡片声称 env > config file > full） — 卡片写 'Resolution: env var > config file > `full`.'，实际代码是四级且含仓库内配置：① CAVEMAN_DEFAULT_MODE → ② 仓库内 .caveman/config.json 或 .caveman.json（从 process.cwd() 向上最多 64 级查找，拒绝符号链接）→ ③ 用户 config（$XDG_CONFIG_HOME/caveman/config.json，或 ~/.config，或 Windows %APPDATA%）→ ④ 'full'（src/hooks/caveman-config.js:15-26 与 findRepoConfigPath 注释）。卡片漏了「仓库内配置」这一层，团队若用 .caveman.json 固定项目默认档，卡片会让人误判优先级。非安全影响，属文档简化。
[ok] wenyan 档位命名一致性（卡片 vs 主 skill vs 代码） — 卡片列 wenyan-lite/wenyan/wenyan-ultra（并称 'Wenyan-Full | /caveman wenyan'）；代码 VALID_MODES 为 ['off','lite','full','ultra','wenyan-lite','wenyan','wenyan-full','wenyan-ultra',...]，卡片触发词全部落在集合内；主 skill SKILL.md 的切换串亦为 '/caveman lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off'。
[ok] 外部依赖为零 — 对两个文件扫描 URL/CLI/包/网络 token 零命中；卡片末行的 'Full docs: https://github.com/JuliusBrussee/caveman' 是给人点的文档链接，不是运行时调用点。
[ok] 无脚本执行 / 无凭证读取 / 无文件写入 — skills/caveman-help 下仅两个 markdown；仓库级 shell/node 代码（bin/install.js、src/hooks/*）属于 caveman CLI 本体，不由本 skill 触发，除 SKILL.md 文字外无任何指向它们的调用指令。
[ok] 声明 'Saves ~46% input tokens'（指向 caveman-compress）是否有出处 — skills/caveman-compress/README.md 基准表平均值为 46%（Average 898 → 481，46%），卡片引用与邻居 skill 自述一致。
[ok] pin commit 与上游状态 — 本地 HEAD == origin/main == 15581d14007fd01fb3f132016741962f34936ca2（2026-09-07T08:19:43+00:00, 'chore: sync SKILL.md copies [skip ci]'）。gh 显示仓库 pushed_at 晚于该时间，故本报告结论仅对该 pin commit 有效，不跨版本推广。

6結論

コストゼロ・リスクゼロの発見性エントリーポイント：1 枚の markdown カードにより、スクリプト、ネットワーク、書き込みを一切行わず、ユーザーが 3 秒ですべてのモードとコマンドを確認可能。

実行層との疎結合：カードはインデックスのみを担当し、実際のモード動作は同リポジトリの caveman メインスキルにあるため、カードを変更しても動作は変わらず影響リスクが極めて低い。

多言語対応：明確に「スタイルのみ圧縮し言語は不変」、用語/コード/エラー文字列を原文保持するため、多言語チームでも圧縮による技術的精度の低下が発生しない。

副作用の範囲が個別に記録・検証可能：リポジトリ独自の動作対照表に「アクティブモードを変更しない」と明記されており、ユーザーは副作用の有無に応じてツールを選択可能。

最適な用途： caveman シリーズ（出力トークンを圧縮するモード）を使用しているすべてのチームおよび個人に最適：スラッシュコマンドを忘れた際のクイックリファレンス、新メンバーへのモード段階や関連コマンドの説明、デフォルトモードの固定方法や自動アクティベーションの無効化手順の案内に適しています。また、スキル作成者が「アセット不要スキル」のサンプルとして参照するのにも有用です。

不向きな用途： 「モードの切り替え」を期待するユースケースには不適（切り替えスイッチではなく単なる表示カードであり、SKILL.md にも 'Does not change mode' と明記されています）。設定解決チェーンの詳細な把握が必要な人には不適（カードではリポジトリ内設定層が省略されているため、src/hooks/caveman-config.js を直接確認すべきです）。caveman メインスキルがインストールされていない環境には不適（カードに記載された各段階の動作を実行できません）。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload caveman-help.tar.gz

sha256: 742f9e1fe5d8d598…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 15581d1400.