Caveman Compress

目的

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

トリガー

/caveman-compress <filepath> またはユーザーがメモリファイルの圧縮を要求した場合。

プロセス

1. 圧縮スクリプトは scripts/ に配置されています(このSKILL.mdと同じディレクトリ内)。パスがすぐに見つからない場合は、このSKILL.mdの隣にある scripts/__main__.py を探してください。

2. このSKILL.mdが配置されているディレクトリから以下を実行します:

python3 -m scripts <absolute_filepath>

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

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

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

圧縮ルール

削除対象

• 冠詞: 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、マークダウンリンク)
• ファイルパス(/src/components/...、./config.yaml)
• コマンド(npm install、git commit、docker build)
• 技術用語(ライブラリ名、API名、プロトコル、アルゴリズム)
• 固有名詞(プロジェクト名、人名、企業名)
• 日付、バージョン番号、数値
• 環境変数($HOME、NODE_ENV)

構造を保持

• すべてのマークダウン見出し(見出しテキストを完全に保持、下部のテキストを圧縮)
• 箇条書きの階層(ネストレベルを保持)
• 番号付きリスト(番号付けを保持)
• 表(セルテキストを圧縮、構造を保持)
• マークダウンファイルのフロントマター/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つの例を保持

重要なルール: ... の内部は完全にコピーしなければなりません。 以下はしないでください:

• コメントを削除
• スペースを削除
• 行の順序を変更
• コマンドを短縮
• 何かを簡略化

インラインコード(...)は完全に保持しなければなりません。 バッククォート内のものは何も修正しないでください。

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

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

パターン

元のテキスト:

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.

圧縮版:

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

元のテキスト:

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.

圧縮版:

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

境界

• ナチュラルランゲージファイルのみを圧縮(.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を圧縮しない(スキップ)