Caveman Compress

Purpose

自然言語ファイル (CLAUDE.md、todos、preferences) を caveman-speak に圧縮して入力トークンを削減します。圧縮版が元のファイルを上書きします。人間が読める形のバックアップは <filename>.original.md として保存されます。

Trigger

/caveman-compress <filepath> またはユーザーがメモリファイルを圧縮するよう要求したとき。

Process

1. 圧縮スクリプトは scripts/ に存在します (このSKILL.mdの隣)。パスがすぐに利用できない場合は、このSKILL.mdの隣から scripts/__main__.py を探してください。

2. このSKILL.mdを含むディレクトリから実行します：

python3 -m scripts <absolute_filepath>

3. CLIは以下を実行します：

• ファイルタイプを検出 (トークン不要)
• Claudeに圧縮を呼び出し
• 出力を検証 (トークン不要)
• エラーの場合：Claudeで修正を選別 (対象限定修正のみ、全体圧縮なし)
• 最大2回まで再試行
• 2回の再試行後も失敗する場合：ユーザーにエラーを報告し、元のファイルは変更しない

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

Compression Rules

削除

• 冠詞：a, an, the
• つなぎ言葉：just, really, basically, actually, simply, essentially, generally
• 丁寧な表現：sure, certainly, of course, happy to, I'd recommend
• 曖昧な表現：it might be worth, you could consider, it would be good to
• 冗長な表現：in order to → to、make sure to → ensure、the reason is because → because
• 接続詞的な無駄：however, furthermore, additionally, in addition

厳密に保持 (修正禁止)

• コードブロック (``` で囲まれた部分とインデント)
• インラインコード (バッククォート内)
• URL とリンク (完全なURL、Markdownリンク)
• ファイルパス (/src/components/...、./config.yaml)
• コマンド (npm install、git commit、docker build)
• 技術用語 (ライブラリ名、API名、プロトコル、アルゴリズム)
• 固有名詞 (プロジェクト名、人名、企業名)
• 日付、バージョン番号、数値
• 環境変数 ($HOME、NODE_ENV)

構造を保持

• すべてのMarkdown見出し (見出しテキストは変更しない、下のボディを圧縮)
• 箇条書きの階層 (ネストレベルを維持)
• 番号付きリスト (番号を維持)
• テーブル (セルテキストを圧縮、構造を維持)
• Markdown ファイルの frontmatter/YAML ヘッダ

圧縮

• 短い同義語を使用：extensive ではなく big、implement a solution for ではなく fix、utilize ではなく use
• フラグメント OK：You should always run tests before committing ではなく Run tests before commit
• you should、make sure to、remember to は削除 — アクション文のままにする
• 同じことを別の言い方で言っている冗長な項目をマージ
• 同じパターンを示す複数の例がある場合は1つの例を保持

CRITICAL RULE: ... 内のすべてのコンテンツは厳密にコピーする必要があります。 以下は避けてください：

• コメントの削除
• スペーシングの削除
• 行の並べ替え
• コマンドの短縮
• 何かを簡略化

インラインコード (...) は厳密に保持する必要があります。 バッククォート内のすべてを修正しないでください。

ファイルにコードブロックが含まれている場合：

• コードブロックを読み取り専用領域として扱う
• コードブロック外のテキストのみを圧縮
• コードブロック周辺のセクションをマージしない

Pattern

Original:

You should always make sure to run the test suite before pushing any changes to the main branch. This is important because it helps catch bugs early and prevents broken builds from being deployed to production.

Compressed:

Run tests before push to main. Catch bugs early, prevent broken prod deploys.

Original:

The application uses a microservices architecture with the following components. The API gateway handles all incoming requests and routes them to the appropriate service. The authentication service is responsible for managing user sessions and JWT tokens.

Compressed:

Microservices architecture. API gateway route all requests to services. Auth service manage user sessions + JWT tokens.

Boundaries

• 自然言語ファイルのみ圧縮 (.md, .txt, .typ, .typst, .tex、拡張子なし)
• 修正禁止：.py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh
• ファイルが混合コンテンツ (散文 + コード) の場合、散文セクションのみを圧縮
• コードか散文かが不明な場合は変更しない
• 元のファイルは上書き前に FILE.original.md としてバックアップされます
• FILE.original.md は圧縮しない (スキップ)