🗿

genshijin 原始人

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

Claude Code 向け超圧縮コミュニケーションスキル。日本語に最適化されたトークン削減プラグイン。

~80%
トークン削減
100%
技術的正確性
3段階
強度レベル
Install
claude plugin marketplace add InterfaceX-co-jp/genshijin

実際の圧縮結果

同じプロンプト・同じモデル(Claude Sonnet)で生成。内容は同じ、トークンだけ違う。

CORSエラーが出る。原因と解決策を教えて
Node.jsのイベントループの仕組みを説明して
認証ミドルウェアのトークン有効期限チェックにバグがある。修正して

3段階の強度

/genshijin 丁寧
クッション言葉・ぼかし表現を削除。敬語は維持。ビジネス向き。
/genshijin
敬語を落とし体言止め。助詞も最小限。原始人の基本形。
/genshijin 極限
略語・矢印記法・一語回答。電報のような最大圧縮。

サブスキル

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

/genshijin-commit
Conventional Commits 形式の簡潔コミットメッセージ。件名≤50文字、「なぜ」重視。
/genshijin-review
1行PRコメント。L42: 🔴 バグ: user null。ガード追加。 の形式。
/genshijin-compress
CLAUDE.md 等のメモリファイルを原始人モード化。入力トークンを永続削減。コード・URL・見出しは完全保持、機密ファイルは自動拒否。
/genshijin-stats v1.4.0〜
現セッションのリアルトークン使用量+推定削減量+USD換算をフックが即時表示。--share で1行サマリ、--all / --since 7d でライフタイム集計。
genshijin-crew v1.4.0〜
3 subagent (investigator/builder/reviewer) preset。tool-result が原始人圧縮 → 主コンテキスト消費約60%減で長セッション持続。
/genshijin-help
全モード・サブスキル・設定方法のリファレンスカード表示。

自動化機能 v1.2.0〜

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

SessionStart フック
SKILL.md を読みアクティブレベル行のみフィルタして hidden context に注入。多ターン経過後の敬語回帰・フィラー漂流を防ぐ anchor。
UserPromptSubmit フック
/genshijin 系コマンドや自然言語でモード切替を検出。毎ターン短い補強リマインダを注入して他プラグインとの競合ドリフトを防止。
Statusline バッジ
現モードを [原始人] / [原始人:極限] 等で可視化。未設定時は Claude がセットアップを提案。
既定モードの設定
優先度: 環境変数 > 設定ファイル > normal
# 環境変数(最優先)
export GENSHIJIN_DEFAULT_MODE=extreme

# 設定ファイル
mkdir -p ~/.config/genshijin
echo '{"defaultMode":"extreme"}' \
  > ~/.config/genshijin/config.json
off 指定でルール注入スキップ(一時停止)。
セキュリティ
フラグファイルは symlink 拒否・64バイト上限・モードホワイトリスト検証。秘密ファイルへの symlink 差替えで secret バイトが statusline やモデルコンテキストに流れ込む攻撃を塞ぐ。

v1.4.0 拡張機能 2026-05-07

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

📊 セッションStats可視化
/genshijin-stats でフックが decision: "block" で stats を即時返却。モデルは数値計算に介在しない。
原始人 Stats
─────────────────
Turns:    24
Output tokens:         18,432
推定削減トークン:       34,231 (~65%)
推定削減USD:           ~$0.51
─────────────────
メモリ圧縮済:           2 件, ~3,200 tokens セッション開始毎削減
claude-opus-4 / sonnet-4 / haiku-4 系の per-million pricing で USD 自動換算。--share ツイート用、--all / --since 7d ライフタイム集計対応。
🤖 3 subagent preset (genshijin-crew)
主スレッド消費トークンを約60%削減。長セッション持続用。
  • genshijin-investigator — read-only locator (haiku model)、file:line 表で返却
  • genshijin-builder — 1-2ファイル surgical edit、3+ファイルは too-big. で拒否
  • genshijin-reviewer — severity-tagged finding (🔴bug/🟡risk/🔵nit/❓question)
出力契約は skills/genshijin-crew/SKILL.md に厳密定義 → 主スレッドは path:\d+ でgrepできる。
🪨 genshijin-shrink (MCP middleware)
任意の MCP server を wrap → tools/listdescription field を圧縮。コード/URL/パス/識別子は byte-for-byte 保護。
"mcpServers": {
  "fs-shrunk": {
    "command": "npx",
    "args": ["genshijin-shrink",
             "npx", "@modelcontextprotocol/server-filesystem",
             "/path"]
  }
}
英語+日本語散文両対応。tools/call レスポンスは無変更で pass-through(downstream 破壊リスク回避)。
⚙️ Smart multi-agent installer
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
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
🛡 ultra-mode code-symbol guard
極限モードでも useEffect/SIGTERM 等のコードシンボル/関数名/API名/エラー文字列の略称化を明示禁止。Auto-Clarity 条件も拡張(多段手順誤読リスク・LaTeX/SQL 境界・ユーザー混乱表明時)。

genshijin-compress の使い始め

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

1. 前提準備
Python 3.10+ に加え、以下いずれか。
# オプションA: API key 直接利用
pip install anthropic
export ANTHROPIC_API_KEY=sk-ant-...

# オプションB: claude CLI ログイン済みなら追加設定不要
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/ 配下 等
誤検知時はファイル名変更で回避可能。

日本語への最適化

英語版 caveman をベースに、日本語特有の冗長表現に最適化。

敬語・丁寧語の圧縮
です/ます/ございます を削除し体言止めに変換
クッション言葉の除去
えーと/まあ/基本的に/一応 を排除
前置き表現の削除
「ご質問ありがとうございます…」を省略
安全モード
セキュリティ警告時は自動的に丁寧な日本語に復帰

ベンチマーク(30タスク平均)

ベンチマーク生データ (JSON)

30タスク × 3回試行の全結果。モデル: claude-sonnet-4-20250514

Loading...

パッチノート

直近のリリース履歴。全履歴は CHANGELOG.md 参照。

パッチノートを読み込み中...

Star History

Star History Chart