genshijin
InterfaceX-co-jp · InterfaceX-co-jp/genshijin
Allows your agent to communicate in highly compressed Japanese, reducing token usage by about 75% while maintaining technical accuracy.
genshijin 原始人 🗿| Claude Code / Codex等AIエージェント 向け超圧縮コミュニケーションスキル。caveman の日本語版をベースに、日本語特有の冗長表現に最適化。
Preview
What you can do with it
- Reduce token costs when using Claude Code or Codex for Japanese language tasks.
- Get concise Japanese summaries for commit messages or Pull Request reviews from an agent.
- Optimize agent communication for technical accuracy while minimizing verbosity in Japanese.
Safety check
Usable, but read the notes first.
- ●Reads credential files (SSH keys, cloud or npm tokens).
skills/genshijin-compress/SKILL.md - ●Installer downloads a remote script and pipes it to the shell.
README.md
Automated scan of the repo files. Always review code you run.
From the README
genshijin 原始人 🗿
なぜ多くトークン使う?少なくて済む🗿
Claude Code 公式プラグインディレクトリに公開済み。/plugin install genshijin でワンライナーインストール。
Claude Code / Codex 向けの超圧縮コミュニケーションスキル。caveman の日本語版をベースに、日本語特有の冗長表現に最適化。
トークン使用量を 約75%削減 しつつ、技術的正確性は100%維持。 コミット生成・PRレビュー・メモリ圧縮の用途別サブスキルも同梱。
日本語への最適化ポイント
英語版 caveman は冠詞(a/an/the)やフィラーの削除が中心だが、日本語版は以下に対応:
| 英語版の削減対象 | 日本語版の削減対象 |
|---|---|
| 冠詞 (a/an/the) | 敬語・丁寧語 (です/ます/ございます) |
| フィラー (just/really/basically) | クッション言葉 (えーと/まあ/基本的に/一応) |
| 前置き (Sure! I'd be happy to...) | 前置き表現 (ご質問ありがとうございます...) |
| ぼかし (might/perhaps/likely) | ぼかし (〜かもしれません/おそらく/〜と思われます) |
| 冗長表現 | 冗長な助詞連続・敬語の二重化 |
インストール
方法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-commit | /genshijin-commit | Conventional Commits 形式の簡潔コミットメッセージ。件名≤50文字、「なぜ」重視 |
| genshijin-review | /genshijin-review | 1行PRコメント L42: 🔴 バグ: user null。ガード追加。 |
| genshijin-compress | /genshijin-compress <file> | CLAUDE.md 等のメモリファイルを原始人モード化し入力トークン永続削減 |
| genshijin-stats (v1.4.0〜) | /genshijin-stats [--share / --all / --since 7d] | 現セッションのリアルトークン使用量+推定削減量+USD換算をフックが即時表示 |
| genshijin-crew (v1.4.0〜) | (auto) | 3 subagent preset (investigator/builder/reviewer)。tool-result 原始人圧縮で主コンテキスト約60%減 |
| genshijin-help | /genshijin-help | 全モード・サブスキル・設定方法のリファレンスカード |
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//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 / --all / --minimal / --list 対応。再実行安全。
genshijin-init — per-repo rule 一発投下
1コマンドで対象 repo に常時有効化 rule を全 IDE agent 用に投下。idempotent。
npx -y https://