genshijin 原始人 🗿

なぜ多くトークン使う？少なくて済む🗿

Claude Code 公式プラグインディレクトリに公開済み。/plugin install genshijin でワンライナーインストール。

Claude Code / Codex 向けの超圧縮コミュニケーションスキル。caveman の日本語版をベースに、日本語特有の冗長表現に最適化。

トークン使用量を 約75%削減 しつつ、技術的正確性は100%維持。 コミット生成・PRレビュー・メモリ圧縮の用途別サブスキルも同梱。

日本語への最適化ポイント

英語版 caveman は冠詞(a/an/the)やフィラーの削除が中心だが、日本語版は以下に対応:

インストール

方法1: Claude Code 公式プラグインディレクトリ（推奨）

Claude Code 内で以下を実行:

/plugin install genshijin

Anthropic 公式 プラグインディレクトリ に公開済み。marketplace add 不要。

方法1b: GitHub 直接インストール（開発版）

claude plugin marketplace add InterfaceX-co-jp/genshijin
/plugin install genshijin@InterfaceX-co-jp/genshijin

main ブランチ最新を取得したい場合。

方法2: npx skills（サードパーティ）

npx skills add InterfaceX-co-jp/genshijin

方法3: 手動インストール

プロジェクト単位（このリポジトリだけに適用）:

# リポジトリのルートで実行
mkdir -p .claude/skills/genshijin
curl -o .claude/skills/genshijin/SKILL.md \
  https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/skills/genshijin/SKILL.md

グローバル（すべてのプロジェクトに適用）:

mkdir -p ~/.claude/skills/genshijin
curl -o ~/.claude/skills/genshijin/SKILL.md \
  https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/skills/genshijin/SKILL.md

方法4: 一時的に使う

claude --plugin-dir ./path/to/genshijin

使い方

/genshijin          # 通常モード（デフォルト）で起動
/genshijin 丁寧     # ビジネス向け簡潔体
/genshijin 極限     # 最大圧縮

会話中に 原始人やめて または 通常モード で解除。

3段階の強度

丁寧モード

クッション言葉・ぼかし表現を削除。敬語は維持。ビジネスメール向き。

Before:

ご質問ありがとうございます。お調べしたところ、こちらの問題につきましては、認証ミドルウェアにおけるトークンの有効期限チェックの部分に原因がある可能性が考えられます。

After:

コンポーネントが再レンダリングされるのは、レンダリングごとに新しいオブジェクト参照が生成されるためです。useMemoで解決できます。

通常モード（デフォルト）

敬語を落とし体言止め。助詞も最小限。原始人の基本形。

Before:

こちらの問題は、レンダリングが行われるたびに新しいオブジェクトの参照が生成されてしまうことが原因となっております。

After:

レンダリング毎に新オブジェクト参照が生成。インラインオブジェクトprop = 新しい参照 = 再レンダリング。useMemoで包む。

極限モード

略語・矢印記法・一語回答。電報のような圧縮。

Before:

データベースのコネクションプーリングというのは、リクエストが来るたびに新しい接続を確立するのではなく、あらかじめ作成しておいた接続を再利用する仕組みのことです。

After:

プール = DB接続再利用。ハンドシェイク省略 → 高負荷時に高速。

サブスキル

本体 /genshijin に加え、用途別サブスキル6個同梱。

genshijin-compress について

CLAUDE.md はセッション開始毎に読込 → 圧縮で 毎回 の入力トークン削減。

使い始め（3ステップ）

1. 前提準備

Python 3.10+ に加え、以下いずれか:

# オプションA: API key 直接利用
pip install anthropic
export ANTHROPIC_API_KEY=sk-ant-...

# オプションB: claude CLI ログイン済みなら 追加設定不要（CLI fallback）
claude --version

2. 対象ファイル選定

典型的な圧縮対象:

• ~/.claude/CLAUDE.md — ユーザー全体メモリ（全セッションで毎回読込）
• ./CLAUDE.md — プロジェクト単位メモリ
• ~/.claude/projects/<project>/memory/MEMORY.md — auto memory インデックス

3. 圧縮実行

/genshijin-compress ~/.claude/CLAUDE.md

結果:

• 圧縮版が原ファイルを上書き
• 人間可読版は CLAUDE.original.md にバックアップ（復元可能）
• 失敗時は原ファイル無変更

保持・拒否ルール

• 完全保持: コードブロック / URL / ファイルパス / 数値 / 見出し / 技術用語
• 自動拒否: .env / credentials.* / id_rsa / .ssh/ 配下 等

誤検知時はファイル名変更で回避可能。

自動化機能（v1.2.0〜）

プラグイン導入後、Claude Code のフック機構で以下が自動で動く。

SessionStart フック — 原始人ルール注入

セッション開始毎に SKILL.md を読み、現アクティブレベルの該当行のみフィルタして hidden context に注入。多ターン経過後の敬語回帰・フィラー漂流を防ぐ anchor。

UserPromptSubmit フック — モード追跡 + 毎ターン補強

• /genshijin 丁寧|通常|極限 や自然言語（「原始人モード」「原始人やめて」等）でモード切替を検出
• アクティブ中は毎ユーザー発話で短い補強リマインダを注入 → 他プラグインが競合するスタイル指示を毎ターン注入する環境でもドリフト防止

Statusline バッジ

現モードを [原始人] / [原始人:丁寧] / [原始人:極限] / [原始人:コミット] 等で可視化。初回セッションで未設定を検知したら Claude がセットアップを提案する。

既定モードの設定（任意）

優先度: 環境変数 > 設定ファイル > normal（デフォルト）。

# 環境変数（最優先）
export GENSHIJIN_DEFAULT_MODE=extreme   # polite | normal | extreme | off

# 設定ファイル
mkdir -p ~/.config/genshijin
cat > ~/.config/genshijin/config.json <<'JSON'
{ "defaultMode": "extreme" }
JSON

off を指定するとフックがルール注入をスキップしフラグも削除 — プラグインインストール済みのまま一時停止できる。

セキュリティ

フラグファイル ~/.claude/.genshijin-active は symlink 拒否・64バイト上限・モードホワイトリスト検証で保護。~/.ssh/id_rsa 等への symlink 差替えで secret バイトが statusline やモデルコンテキストに流れ込む攻撃を塞ぐ。

スラッシュコマンド（v1.3.0〜）

プラグイン導入後、以下のコマンドが利用可能。

• /genshijin 丁寧|通常|極限 — 強度レベル切替
• /genshijin-commit — 現在のステージング変更から簡潔なコミットメッセージ生成（Conventional Commits）
• /genshijin-review — 現在のコード変更を1行1指摘でレビュー（L42: 🔴 バグ: ...）
• /genshijin-stats (v1.4.0〜) — 現セッションのリアルトークン使用量＋推定削減量＋USD換算をフックが即時表示。--share ツイート用1行サマリ、--all / --since 7d ライフタイム集計対応

定義は commands/ 配下。

v1.4.0 拡張機能

caveman 本家 v1.3.0以降の差分（stats receipts / smart installer / cavecrew相当 / cavepack相当 / MCP-shrink）を全項目移植。

Smart multi-agent installer — root install.sh / install.ps1

Claude Code/Cursor/Windsurf/Cline/Copilot を自動検出し、各 agent に native install。

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/install.sh | bash

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/install.ps1 | iex

--dry-run / --force / --only <agent> / --all / --minimal / --list 対応。再実行安全。

genshijin-init — per-repo rule 一発投下

1コマンドで対象 repo に常時有効化 rule を全 IDE agent 用に投下。idempotent。

npx -y https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/tools/genshijin-init.js

Cursor / Windsurf / Cline / Copilot / AGENTS.md 用 rule file 生成。--dry-run / --force / --only 対応。

genshijin-shrink — MCP middleware

任意の MCP server を wrap → tools/list の description field を圧縮。コード/URL/パス/識別子は byte-for-byte 保護。

{
  "mcpServers": {
    "fs-shrunk": {
      "command": "npx",
      "args": ["genshijin-shrink", "npx", "@modelcontextprotocol/server-filesystem", "/path"]
    }
  }
}

詳細は mcp-servers/genshijin-shrink/README.md。

genshijin-crew — 3 subagent preset

長セッションでコンテキストを温存するための subagent 3種。

委譲判断ガイドは skills/genshijin-crew/SKILL.md。

マルチエージェント対応（v1.3.0〜）

Claude Code 以外の AI コーディングエージェントでも原始人モード利用可能:

Standalone インストーラ（v1.3.0〜）

プラグイン未使用でも ~/.claude 配下に直接フックを導入可能。

# インストール
bash hooks/install.sh

# 再インストール
bash hooks/install.sh --force

# アンインストール
bash hooks/uninstall.sh

Windows は hooks/install.ps1 / hooks/uninstall.ps1。settings.json への安全マージ（既存 statusline を尊重）。

アップデート

プラグイン版（推奨）

# マーケットプレイス側を最新取得
claude plugin marketplace update genshijin

# プラグイン本体を更新（再起動で適用）
claude plugin update genshijin@genshijin

Claude Code 内の /plugin update genshijin が使える環境ではそれでも可。インストール済バージョン確認は claude plugin list。

Standalone 版

cd /path/to/genshijin
git pull
bash hooks/install.sh --force   # Windows: hooks/install.ps1 -Force

npx skills 版

npx skills add InterfaceX-co-jp/genshijin   # 上書き再取得

ベンチマーク

English Benchmark (参考値)

genshijin は日本語最適化スキルだが、英語プロンプトでも圧縮効果を発揮するか検証。caveman（英語ネイティブ）との比較。

ベンチマークは英語版 caveman の結果を参考値として掲載。 自分で計測するには:

cd benchmarks
pip install -r requirements.txt
export ANTHROPIC_API_KEY=sk-ant-...
python run.py --trials 3 --update-readme              # 日本語
python run.py --lang en --trials 3 --update-readme     # 英語

安全機能

セキュリティ警告や破壊的操作の確認時は自動的に通常の丁寧な日本語に切り替わる。誤解が致命的になる場面では正確性を優先。

プロジェクト構成

genshijin/
├── skills/
│   ├── genshijin/SKILL.md            # 本体スキル
│   ├── genshijin-commit/SKILL.md     # コミット生成サブスキル
│   ├── genshijin-review/SKILL.md     # PRレビューサブスキル
│   ├── genshijin-help/SKILL.md       # ヘルプサブスキル
│   └── genshijin-compress/
│       ├── SKILL.md                  # メモリ圧縮サブスキル
│       └── scripts/                  # Python CLI 実装
├── hooks/                            # v1.2.0〜
│   ├── genshijin-activate.js         # SessionStart: ルール注入
│   ├── genshijin-mode-tracker.js     # UserPromptSubmit: モード追跡 + 毎ターン補強
│   ├── genshijin-config.js           # 設定解決（env var + config file）
│   ├── genshijin-statusline.sh       # statusline バッジ（Unix）
│   ├── genshijin-statusline.ps1      # statusline バッジ（Windows）
│   ├── install.sh / uninstall.sh     # standalone インストーラ（v1.3.0〜）
│   └── install.ps1 / uninstall.ps1   # standalone インストーラ Windows
├── commands/                         # v1.3.0〜スラッシュコマンド定義
│   ├── genshijin.toml                # /genshijin 強度切替
│   ├── genshijin-commit.toml         # /genshijin-commit
│   └── genshijin-review.toml         # /genshijin-review
├── rules/                            # v1.3.0〜
│   └── genshijin-activate.md         # フック無しプラットフォーム向け共通ルール
├── .cursor/rules/                    # Cursor 用（v1.3.0〜）
├── .windsurf/rules/                  # Windsurf 用（v1.3.0〜）
├── .clinerules/                      # Cline 用（v1.3.0〜）
├── .github/copilot-instructions.md   # GitHub Copilot 用（v1.3.0〜）
├── AGENTS.md                         # マルチエージェント参照インデックス（v1.3.0〜）
├── .claude-plugin/
│   ├── plugin.json                   # Claude Code プラグインマニフェスト（hooks 登録）
│   └── marketplace.json              # マーケットプレイス定義
├── benchmarks/
│   ├── run.py                        # ベンチマークスクリプト
│   ├── prompts.json                  # テスト用プロンプト
│   └── requirements.txt              # Python依存パッケージ
├── docs/
│   ├── index.html                    # GitHub Pages
│   └── caveman-diff-analysis.md      # caveman差分分析 + 進捗管理
├── README.md
├── LICENSE
└── .gitignore

元プロジェクト

JuliusBrussee/caveman — 英語版オリジナル

Star History

ライセンス

MIT