byinterfacex-co-jp· 1 MCP server
genshijin 原始人 🗿| Claude Code / Codex等AIエージェント 向け超圧縮コミュニケーションスキル。caveman の日本語版をベースに、日本語特有の冗長表現に最適化。
$git clone https://github.com/interfacex-co-jp/genshijinInstalls into the current project.
Install genshijin by running `git clone https://github.com/interfacex-co-jp/genshijin`, then use it for the current task and follow its documentation at https://github.com/interfacex-co-jp/genshijin.
| 1 | # genshijin 原始人 🗿 |
| 2 | |
| 3 | > なぜ多くトークン使う?少なくて済む🗿 |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="https://github.com/InterfaceX-co-jp/genshijin/stargazers"><img src="https://img.shields.io/github/stars/InterfaceX-co-jp/genshijin?style=flat&color=yellow" alt="Stars"></a> |
| 7 | <a href="https://github.com/InterfaceX-co-jp/genshijin/commits/main"><img src="https://img.shields.io/github/last-commit/InterfaceX-co-jp/genshijin?style=flat" alt="Last Commit"></a> |
| 8 | <a href="LICENSE"><img src="https://img.shields.io/github/license/InterfaceX-co-jp/genshijin?style=flat" alt="License"></a> |
| 9 | </p> |
| 10 | |
| 11 | Claude Code 公式プラグインディレクトリに公開済み。`/plugin install genshijin` でワンライナーインストール。 |
| 12 | |
| 13 | Claude Code / Codex 向けの超圧縮コミュニケーションスキル。[caveman](https://github.com/JuliusBrussee/caveman) の日本語版をベースに、日本語特有の冗長表現に最適化。 |
| 14 | |
| 15 | トークン使用量を **約75%削減** しつつ、技術的正確性は100%維持。 |
| 16 | コミット生成・PRレビュー・メモリ圧縮の用途別サブスキルも同梱。 |
| 17 | |
| 18 | ## 日本語への最適化ポイント |
| 19 | |
| 20 | 英語版 caveman は冠詞(a/an/the)やフィラーの削除が中心だが、日本語版は以下に対応: |
| 21 | |
| 22 | | 英語版の削減対象 | 日本語版の削減対象 | |
| 23 | |-----------------|-------------------| |
| 24 | | 冠詞 (a/an/the) | 敬語・丁寧語 (です/ます/ございます) | |
| 25 | | フィラー (just/really/basically) | クッション言葉 (えーと/まあ/基本的に/一応) | |
| 26 | | 前置き (Sure! I'd be happy to...) | 前置き表現 (ご質問ありがとうございます...) | |
| 27 | | ぼかし (might/perhaps/likely) | ぼかし (〜かもしれません/おそらく/〜と思われます) | |
| 28 | | 冗長表現 | 冗長な助詞連続・敬語の二重化 | |
| 29 | |
| 30 | ## インストール |
| 31 | |
| 32 | ### 方法1: Claude Code 公式プラグインディレクトリ(推奨) |
| 33 | |
| 34 | Claude Code 内で以下を実行: |
| 35 | |
| 36 | ``` |
| 37 | /plugin install genshijin |
| 38 | ``` |
| 39 | |
| 40 | Anthropic 公式 [プラグインディレクトリ](https://claude.ai/settings/plugins) に公開済み。marketplace add 不要。 |
| 41 | |
| 42 | ### 方法1b: GitHub 直接インストール(開発版) |
| 43 | |
| 44 | ``` |
| 45 | claude plugin marketplace add InterfaceX-co-jp/genshijin |
| 46 | /plugin install genshijin@InterfaceX-co-jp/genshijin |
| 47 | ``` |
| 48 | |
| 49 | main ブランチ最新を取得したい場合。 |
| 50 | |
| 51 | ### 方法2: npx skills(サードパーティ) |
| 52 | |
| 53 | ```bash |
| 54 | npx skills add InterfaceX-co-jp/genshijin |
| 55 | ``` |
| 56 | |
| 57 | ### 方法3: 手動インストール |
| 58 | |
| 59 | **プロジェクト単位**(このリポジトリだけに適用): |
| 60 | |
| 61 | ```bash |
| 62 | # リポジトリのルートで実行 |
| 63 | mkdir -p .claude/skills/genshijin |
| 64 | curl -o .claude/skills/genshijin/SKILL.md \ |
| 65 | https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/skills/genshijin/SKILL.md |
| 66 | ``` |
| 67 | |
| 68 | **グローバル**(すべてのプロジェクトに適用): |
| 69 | |
| 70 | ```bash |
| 71 | mkdir -p ~/.claude/skills/genshijin |
| 72 | curl -o ~/.claude/skills/genshijin/SKILL.md \ |
| 73 | https://raw.githubusercontent.com/InterfaceX-co-jp/genshijin/main/skills/genshijin/SKILL.md |
| 74 | ``` |
| 75 | |
| 76 | ### 方法4: 一時的に使う |
| 77 | |
| 78 | ```bash |
| 79 | claude --plugin-dir ./path/to/genshijin |
| 80 | ``` |
| 81 | |
| 82 | ## 使い方 |
| 83 | |
| 84 | ``` |
| 85 | /genshijin # 通常モード(デフォルト)で起動 |
| 86 | /genshijin 丁寧 # ビジネス向け簡潔体 |
| 87 | /genshijin 極限 # 最大圧縮 |
| 88 | ``` |
| 89 | |
| 90 | 会話中に `原始人やめて` または `通常モード` で解除。 |
| 91 | |
| 92 | ## 3段階の強度 |
| 93 | |
| 94 | ### 丁寧モード |
| 95 | クッション言葉・ぼかし表現を削除。敬語は維持。ビジネスメール向き。 |
| 96 | |
| 97 | **Before:** |
| 98 | > ご質問ありがとうございます。お調べしたところ、こちらの問題につきましては、認証ミドルウェアにおけるトークンの有効期限チェックの部分に原因がある可能性が考えられます。 |
| 99 | |
| 100 | **After:** |
| 101 | > コンポーネントが再レンダリングされるのは、レンダリングごとに新しいオブジェクト参照が生成されるためです。`useMemo`で解決できます。 |
| 102 | |
| 103 | ### 通常モード(デフォルト) |
| 104 | 敬語を落とし体言止め。助詞も最小限。原始人の基本形。 |
| 105 | |
| 106 | **Before:** |
| 107 | > こちらの問題は、レンダリングが行われるたびに新しいオブジェクトの参照が生成されてしまうことが原因となっております。 |
| 108 | |
| 109 | **After:** |
| 110 | > レンダリング毎に新オブジェクト参照が生成。インラインオブジェクトprop = 新しい参照 = 再レンダリング。`useMemo`で包む。 |
| 111 | |
| 112 | ### 極限モード |
| 113 | 略語・矢印記法・一語回答。電報のような圧縮。 |
| 114 | |
| 115 | **Before:** |
| 116 | > データベースのコネクションプーリングというのは、リクエストが来るたびに新しい接続を確立するのではなく、あらかじめ作成しておいた接続を再利用する仕組みのことです。 |
| 117 | |
| 118 | **After:** |
| 119 | > プール = DB接続再利用。ハンドシェイク省略 → 高負荷時に高速。 |
| 120 | |
| 121 | ## サブスキル |
| 122 | |
| 123 | 本体 `/genshijin` に加え、用途別サブスキル6個同梱。 |
| 124 | |
| 125 | | スキル | トリガー | 内容 | |
| 126 | |--------|---------|------| |
| 127 | | **genshijin-commit** | `/genshijin-commit` | Conventional Commits 形式の簡潔コミットメッセージ。件名≤50文字、「なぜ」重視 | |
| 128 | | **genshijin-review** | `/genshijin-review` | 1行PRコメント `L42: 🔴 バグ: user null。ガード追加。` | |
| 129 | | **genshijin-compress** | `/genshijin-compress <file>` | `CLAUDE.md` 等のメモリファイルを原始人モード化し入力トークン永続削減 | |
| 130 | | **genshijin-stats** (v1.4.0〜) | `/genshijin-stats [--share / --all / --since 7d]` | 現セッションのリアルトークン使用量+推定削減量+USD換算をフックが即時表示 | |
| 131 | | **genshijin-crew** (v1.4.0〜) | (auto) | 3 subagent preset (`investigator`/`builder`/`reviewer`)。tool-result 原始人圧縮で主コンテキスト約60%減 | |
| 132 | | **genshijin-help** | `/genshijin-help` | 全モード・サブスキル・設定方法のリファレンスカード | |
| 133 | |
| 134 | ### genshijin-compress について |
| 135 | |
| 136 | `CLAUDE.md` はセッション開始毎に読込 → 圧縮で **毎回** の入力トークン削減。 |
| 137 | |
| 138 | #### 使い始め(3ステップ) |
| 139 | |
| 140 | **1. 前提準備** |
| 141 | |
| 142 | Python 3.10+ に加え、以下いずれか: |
| 143 | |
| 144 | ```bash |
| 145 | # オプションA: API key 直接利用 |
| 146 | pip install anthropic |
| 147 | export ANTHROPIC_API_KEY=sk-ant-... |
| 148 | |
| 149 | # オプションB: claude CLI ログイン済みなら 追加設定不要(CLI fallback) |
| 150 | claude --version |
| 151 | ``` |
| 152 | |
| 153 | **2. 対象ファイル選定** |
| 154 | |
| 155 | 典型的な圧縮対象: |
| 156 | - `~/.claude/CLAUDE.md` — ユーザー全体メモリ(全セッションで毎回読込) |
| 157 | - `./CLAUDE.md` — プロジェクト単位メモリ |
| 158 | - `~/.claude/projects/<project>/memory/MEMORY.md` — auto memory インデックス |
| 159 | |
| 160 | **3. 圧縮実行** |
| 161 | |
| 162 | ``` |
| 163 | /genshijin-compress ~/.claude/CLAUDE.md |
| 164 | ``` |
| 165 | |
| 166 | 結果: |
| 167 | - 圧縮版が原ファイルを上書き |
| 168 | - 人間可読版は `CLAUDE.original.md` にバックアップ(復元可能) |
| 169 | - 失敗時は原ファイル無変更 |
| 170 | |
| 171 | #### 保持・拒否ルール |
| 172 | |
| 173 | - **完全保持**: コードブロック / URL / ファイルパス / 数値 / 見出し / 技術用語 |
| 174 | - **自動拒否**: `.env` / `credentials.*` / `id_rsa` / `.ssh/` 配下 等 |
| 175 | |
| 176 | 誤検知時はファイル名変更で回避可能。 |
| 177 | |
| 178 | ## 自動化機能(v1.2.0〜) |
| 179 | |
| 180 | プラグイン導入後、Claude Code のフック機構で以下が自動で動く。 |
| 181 | |
| 182 | ### SessionStart フック — 原始人ルール注入 |
| 183 | セッション開始毎に `SKILL.md` を読み、現アクティブレベルの該当行のみフィルタして hidden context に注入。多ターン経過後の敬語回帰・フィラー漂流を防ぐ anchor。 |
| 184 | |
| 185 | ### UserPromptSubmit フック — モード追跡 + 毎ターン補強 |
| 186 | - `/genshijin 丁寧|通常|極限` や自然言語(「原始人モード」「原始人やめて」等)でモード切替を検出 |
| 187 | - アクティブ中は毎ユーザー発話で短い補強リマインダを注入 → 他プラグインが競合するスタイル指示を毎ターン注入する環境でもドリフト防止 |
| 188 | |
| 189 | ### Statusline バッジ |
| 190 | 現モードを `[原始人]` / `[原始人:丁寧]` / `[原始人:極限]` / `[原始人:コミット]` 等で可視化。初回セッションで未設定を検知したら Claude がセットアップを提案する。 |
| 191 | |
| 192 | ### 既定モードの設定(任意) |
| 193 | |
| 194 | 優先度: 環境変数 > 設定ファイル > `normal`(デフォルト)。 |
| 195 | |
| 196 | ```bash |
| 197 | # 環境変数(最 |