---
id: gh-genshijin-compress
name: "genshijin-compress"
url: https://skills.yangsir.net/skill/gh-genshijin-compress
author: interfacex-co-jp
domain: ai-llm-engineering
tags: ["compression", "token-optimization", "context-management", "llm", "file-processing"]
install_count: 12000
rating: 4.50 (120 reviews)
github: https://github.com/interfacex-co-jp/genshijin/tree/main/skills/genshijin-compress
---

# genshijin-compress

> 此技能可将自然语言文件（如 CLAUDE.md、todos、设置文件）自动压缩为精炼的“原始人模式”，大幅降低输入 token 数量。压缩版覆盖原文件，同时保留人类可读的 .original.md 备份。适用于管理 LLM 上下文窗口、降低 API 调用成本，以及优化长文档处理流程。

**Stats**: 12,000 installs · 4.5/5 (120 reviews)

## Before / After 对比

### 大文件压缩前后 Token 用量对比

**Before**:

没有此技能时，开发者面对动辄数万 token 的记忆文件，经常因上下文超限而报错，只能手动开启编辑器逐行删减，过程冗长且容易误删关键设定，导致模型行为偏差。

**After**:

使用此技能后，一条命令即可将文件压缩为精炼表达，token 占用降低 80% 以上，关键信息完整保留，无需人工干预，开发迭代速度明显加快。

| Metric | Before | After | Change |
|---|---|---|---|
| Token 数 | 30000tokens | 5000tokens | -83% |

## Readme

# genshijin-compress

## 目的

自然言語ファイル（CLAUDE.md, todos, 設定）を原始人モード化して入力トークン削減。圧縮版が原ファイル上書き、人間可読版は `<filename>.original.md` で保存。

## トリガー

`/genshijin-compress <filepath>` または「メモリファイル圧縮」等の依頼。

## 処理フロー

1. この SKILL.md と同ディレクトリの `scripts/` を検出

2. 実行:
   ```
   cd <SKILL.md を含むディレクトリ> && python3 -m scripts <絶対ファイルパス>
   ```

3. CLI 処理内容:
   - ファイル種別検出（トークン消費なし）
   - Claude API/CLI で圧縮
   - 出力検証（トークン消費なし）
   - エラー時: Claude で該当箇所のみピンポイント修正（再圧縮せず）
   - 最大2回リトライ
   - 失敗時: ユーザーにエラー報告、原ファイルは無変更

4. 結果をユーザーに返却

## 圧縮ルール

### 削除

- 敬語・丁寧語（です/ます/ございます）
- クッション言葉（えーと/まあ/ちなみに/一応/とりあえず/基本的に/ざっくり言うと）
- 前置き（ご質問ありがとうございます/お力になれれば幸いです）
- ぼかし（〜かもしれません/〜と思われます/おそらく）
- 冗長表現（〜することができる→〜できる、〜というものは→〜は）
- 冗長接続（〜ということになりますので→だから、〜させていただく→する）
- 自明な助詞（が/の/を/に/で/は/と/も）
- 形容動詞活用語尾（な/に/で/だ）→ 語幹止め
- 形式名詞（こと/もの/ため）→ 名詞化 or 省略
- 補助動詞（ている/ておく/てしまう）→ 状態表現

### 完全保持（絶対変更しない）

- コードブロック（fenced ``` and indented）
- インラインコード（`backtick`）
- URL・リンク（完全URL、Markdownリンク）
- ファイルパス（`/src/components/...`, `./config.yaml`）
- コマンド（`npm install`, `git commit`, `docker build`）
- 技術用語（ライブラリ名、API名、プロトコル、アルゴリズム）
- 固有名詞（プロジェクト名、人名、企業名）
- 日付、バージョン番号、数値
- 環境変数（`$HOME`, `NODE_ENV`）
- エラーメッセージ原文

### 構造保持

- Markdown見出し全て（見出しテキストは完全保持、下の本文のみ圧縮）
- 箇条書き階層（ネストレベル維持）
- 番号付きリスト（番号維持）
- テーブル（構造維持、セル内テキストのみ圧縮）
- Frontmatter/YAMLヘッダ

### 圧縮

- 体言止め・用言止め
- 漢字連結で助詞吸収（「高負荷時に高速」→「高負荷時高速」）
- 和語→漢語化（「速く動作」→「高速動作」）
- 断片OK: 「コミット前テスト実行」不可「コミット前に必ずテストを実行してください」
- 「〜してください」「〜することを忘れずに」削除 → 動作のみ記述
- 重複箇条書きを統合
- 同パターン複数例は1例のみ残す

重要ルール:
``` ... ``` 内は **完全コピー**。
禁止:
- コメント削除
- スペース削除
- 行順変更
- コマンド短縮
- 簡略化一切

インラインコード（`...`）は完全保持。バッククォート内は一切変更しない。

コードブロック含むファイル:
- コードブロックは読取専用領域として扱う
- 外側のテキストのみ圧縮
- コード周辺セクションの結合禁止

## パターン例

### 例1

原文:
> main ブランチにプッシュする前には必ずテストスイートを実行するようにしてください。これはバグを早期に発見し、壊れたビルドが本番環境にデプロイされるのを防ぐために重要です。

圧縮:
> main push前テスト実行。バグ早期発見、壊れビルド本番デプロイ防止。

### 例2

原文:
> このアプリケーションは以下のコンポーネントを持つマイクロサービスアーキテクチャを採用しています。APIゲートウェイが全ての受信リクエストを処理し、適切なサービスにルーティングします。認証サービスはユーザーセッションとJWTトークンの管理を担当します。

圧縮:
> マイクロサービスアーキテクチャ。APIゲートウェイ 全受信リクエストをサービスにルーティング。認証サービス ユーザーセッション + JWTトークン管理。

## 境界

- 自然言語ファイルのみ圧縮（.md, .txt, 拡張子なし）
- 絶対変更しない: .py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh
- 混在ファイル（散文 + コード）は散文部分のみ圧縮
- コードか散文か判断つかない場合は変更しない
- 原ファイルは FILE.original.md にバックアップしてから上書き
- FILE.original.md は絶対圧縮しない（スキップ）
- 機密ファイル（.env, credentials, id_rsa 等）は絶対に送信しない → 拒否

## セキュリティ

圧縮は Anthropic API に生データ送信。以下は拒否:

- `.env`, `.netrc`
- `credentials.*`, `secrets.*`, `passwords.*`
- SSH鍵（`id_rsa`, `id_ed25519` 等）
- 証明書（`.pem`, `.key`, `.p12`, `.crt` 等）
- ディレクトリ `.ssh`, `.aws`, `.gnupg`, `.kube`, `.docker` 配下
- ファイル名に `secret`/`credential`/`password`/`apikey`/`token`/`privatekey` 含むもの

ヒューリスティック誤検知時は、ファイル名変更で回避可能。


---
*Source: https://skills.yangsir.net/skill/gh-genshijin-compress*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-genshijin-compress/markdown*