token-saver

Token Saver

💡 ご存じですか？ プロンプトを送信するたびに、ワークスペースのファイル（SOUL.md、USER.md、MEMORY.md、AGENTS.md など）も毎回一緒に送信されます。これらのファイルはコンテキストウィンドウを消費し、応答を遅くするうえ、メッセージを送るたびに実際の費用がかかります。Token Saver は、すべてのデータを保持したまま、AI に効率的な表記法でこれらのファイルを圧縮し、軽量化、高速化、低コスト化を実現します。

1 つのコマンドで、AI のコストを 40～90% 削減できます。

得られるもの

/optimize

次の情報をわかりやすく表示するダッシュボードです。

🗜️ ファイル圧縮 — すべての .md ワークスペースファイルをスキャンし、AI に効率的な表記法に圧縮した場合の削減量を正確に表示します。通常、MEMORY.md だけでも 90% 以上削減できます。

🤖 モデル監査 — 使用中の AI モデル（メインチャット、cron ジョブ、サブエージェント）を検出し、具体的な節約額とともに、より安価な代替モデルを提案します。

📊 合計削減額 — 2 つの最適化による、週・月・年あたりの削減額の合計見積もりです。

コマンド

コマンド	機能
/optimize	削減できる項目をすべて表示するダッシュボード
/optimize tokens	ワークスペースファイルを圧縮します（自動バックアップ）
/optimize models	モデルの詳細なコスト比較
/optimize revert	バックアップからファイルを復元します

✨ 永続モード（自動有効化）

/optimize tokens を実行すると、スキルは永続モードも有効にします。これは、今後も AI が圧縮表記で書き続けるよう指示する 1 行の指示を AGENTS.md に追加する機能です。これにより、次のことが可能になります。

• 一度の最適化で完了 — AI が新しい内容を追加しても、ファイルは軽量な状態を保ちます
• 再最適化は不要 — AI が圧縮形式を自動的に維持します
• 簡単に無効化 — /optimize revert を実行すると、永続モードが解除され、すべてのファイルが復元されます

永続モードがない場合、AI が新しい項目を書き込むにつれて、ワークスペースファイルは徐々に冗長な形式に戻っていきます。

安全性

• ファイルを変更する前に自動バックアップ
• 実際に適用するまでは**「削減可能な量」**として表示
• 1 つのコマンドで元に戻せます — /optimize revert を実行すると、すべてを復元し、永続モードも無効にします
• 実際に削減効果があるファイルのみを圧縮

仕組み

AI モデルは圧縮表記を問題なく理解できます。

圧縮前（500 トークン以上）：

Ruben が「おはよう」や「今日は何がある？」のような言葉で朝のあいさつをしたら、タスクリストを先回りして確認し、保留中の項目を伝え、緊急の問題がないか確認します……

圧縮後（30 トークン）：

MORNING: greeting → review(todos+pending+urgent)

意味は同じです。トークンを 90% 削減。実際の費用も節約できます。

スクリプト

• scripts/optimizer.js — メインダッシュボードとコマンドハンドラー
• scripts/analyzer.js — トークン数のカウント、モデルの検出、コストの計算
• scripts/compressor.js — AI 向け表記法への圧縮エンジン