honey-compress について
honey-compressは、複数のセッションで繰り返し読み込む文章ファイルを短くするエージェントスキルです。ファイルをバックアップし、短縮後の文章を採用する前に内容の保持を検証します。
主な機能
- 01編集前に元ファイルをバックアップ
- 02指示を保ちながら冗長な文章を削除
- 03書き換えの忠実性とサイズ縮小を検証
- 04検証の問題を直せない場合はバックアップを復元
- 05バイト数とバックアップ先を報告
活用シーン
- 01繰り返し読み込むコンテキストファイルの圧縮
- 02個別の指示を変えずに文章を短縮
- 03復元可能な原本を残してファイルを書き換え
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ green-pt/ honey-for-devs --skill honey-compressインストール後、Claude Code で/honey-compressを入力して読み込まれたか確認します。
詳細
Honey Compress
エージェントが毎回のセッションで読み直すファイルに Lever 2 を適用します。最も安価なトークンは再送しなくて済むトークンです。一度書き換えれば、以後の読み込みすべてで節約できます。
実行すること
- 最初にバックアップします。
FILEをFILE.original.mdにコピーします。バックアップがすでに存在する場合は、停止して確認してください。復元ポイントを上書きしてはいけません。バックアップを書き込めない場合は、処理を拒否してください。 - 文章を簡潔に書き換えます — 前置き、曖昧な表現、説明的な語り、重複を削り、段落より断片的な表現を使い、繰り返されるガイダンスをまとめます。
- 個別の指示はすべて保持します — 言葉は簡潔にしても、ルールは同一に保ちます。ある行が動作を変えるかどうか判断できない場合は、原文のまま残してください。
- 検証してから、維持するか元に戻します。
node "${CLAUDE_PLUGIN_ROOT}/bin/check.js" fidelity FILE.original.md FILEを実行します。 数値、コードスパン、URL、否定表現、安全に関する語句が失われた場合、または ファイルが小さくなっていない場合、検証は失敗します。失敗したら、指摘された損失を修正するか、 修正による節約効果が見込めない場合はバックアップを復元します(cp FILE.original.md FILE)。 失敗した書き換えを完了したと報告してはいけません。 (CLAUDE_PLUGIN_ROOTが展開されていない場合、bin/check.jsはこのファイルの2階層上にあるプラグインのルートにあります。npm からインストールした場合はhoney-checkです。) - 報告します — 元のバイト数と新しいバイト数(チェックで表示されます)、およびバックアップのパスを報告します。
原文どおりに保持 — 決して圧縮しない
- コードブロック、コマンド、パス、識別子、バージョン。
- 動作を左右する指示 — MUST/NEVER のルール、および認証情報、シークレット、金銭、マイグレーション、削除に関わるもの。動作を変える指示を圧縮すると、コストはなくなるのではなく移るだけです。
してはいけないこと
- コード、設定、データファイルには手を加えないでください。文章のコンテキストのみが対象です。
- 効果が異なる2つのルールを1つにまとめないでください。
- バックアップできないファイルを圧縮しないでください。
境界
設計上、元に戻せます。FILE.original.md が復元用のファイルです。忠実性チェックは最低ラインであり、上限ではありません。失われた事実は検出できますが、言い換えによってルールの意味が変わっても検出できないため、差分を必ず確認してください。
コメント
Markdown 対応