mcpField
S
save-token

save-token

github.com/yesilsin-netizenエージェントワークフロー148 回インストール33 週間前に更新
リポジトリ

save-token について

save-token は、要約、参照、重複排除、出力圧縮によってコンテキストの重複を減らすエージェント向けガイダンススキルです。適用時を見極める手助けをしますが、実行時のコンテキスト自体は変更しません。

主な機能

  1. 01以前の会話コンテキストを要約
  2. 02既読の内容を参照
  3. 03重複したテキストブロックを排除
  4. 04長いツール出力やファイル出力を圧縮
  5. 05トークン節約策を使う場面を特定

活用シーン

  1. 01長い会話のコンテキストを簡潔化
  2. 02確認済みファイルの再読を回避
  3. 03繰り返すエラーをパターンとして提示
  4. 04長いログから要点を抽出

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yesilsin-netizen/save-token --skill save-token

インストール後、Claude Code で/save-tokenを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
package.json
.gitignore
README.md
save-token/
README.md

詳細

💰 トークン節約 | トークン節約ツール

重複するコンテキストを避けてトークンを節約する方法をエージェントに教えるガイダンススキルです。

エージェントが重複するコンテキストを避けてトークンを節約する方法を案内するスキルです。

⚠️ 重要な説明

説明内容
これはガイダンススキルですスキル自体がエージェントの実行時コンテキストを変更することはできません
エージェントが操作を実行しますエージェントはガイダンスに従ってコンテキストを最適化します
これはガイダンススキルですスキル自体がエージェントの実行時コンテキストを変更することはできません
エージェントが操作を実行しますエージェントはガイダンスに従ってコンテキストを最適化します

🎯 使用するタイミング

エージェントが自動的に起動する条件(いずれかを満たした場合に呼び出します):

  • ユーザーが「トークン」/「コスト」/「節約」/「料金」に言及した
  • 会話が10往復を超えた
  • 同じファイルが2回以上読み込まれた
  • タスク開始前のコンテキストが5000文字を超えている
状況操作状況操作
ユーザーが「トークン」または「コスト」に言及するトークン節約の戦略を適用しますユーザーがトークンまたはコストに言及するトークン節約の戦略を適用します
長い会話(10往復超)古いコンテキストを要約します長い会話(10往復超)古いコンテキストを要約します
ファイルを複数回読み込む以前の読み込みを参照し、再読み込みしませんファイルを複数回読み込む以前の読み込みを参照し、再読み込みしません
エラーメッセージが繰り返されるエラーのパターンを要約し、エラー全体を繰り返しませんエラーメッセージが繰り返されるエラーのパターンを要約し、エラー全体を繰り返しません

📋 トークン節約の戦略

戦略1:再送信する代わりに要約する

タイミング:以前の会話のコンテキストが直接関係しなくなった場合 タイミング:以前の会話のコンテキストが直接関係しなくなった場合

実施内容:

  • 以前の会話から重要な点を要約します
  • 会話履歴全体を簡潔な要約に置き換えます
  • 直近のメッセージのうち、最も関連性の高いものだけを残します

実施内容:

  • 以前の会話から重要な点を要約します
  • 会話履歴全体を簡潔な要約に置き換えます
  • 直近のメッセージのうち、最も関連性の高いものだけを残します

例:

❌ Bad: Re-sending 50 turns of conversation (10,000+ tokens)
✅ Good: "Previous context: User was analyzing stock investment strategies. 
   Key decisions made: prioritize low P/E, check cash flow. 
   Now focusing on: specific company analysis."
戦略2:繰り返す代わりに参照する

タイミング:同じファイル/内容を再び参照する必要がある場合 タイミング:同じファイル/内容を再び参照する必要がある場合

実施内容:

  • ファイル全体を再読み込みしません
  • すでに抽出した重要な情報を参照します
  • 必要な場合に限り、新しいセクションを読み込みます

実施内容:

  • ファイル全体を再読み込みしません
  • すでに抽出した重要な情報を参照します
  • 必要な場合に限り、新しいセクションを読み込みます

例:

❌ Bad: Reading the same 200KB file again
✅ Good: "As we found earlier in the file, the revenue is $50M..."
戦略3:重複するブロックを削除する

タイミング:同一のテキストがコンテキスト内に複数回現れる場合 タイミング:同一のテキストがコンテキスト内に複数回現れる場合

実施内容:

  • 同一のブロック(100文字以上)を特定します
  • 最初に現れたものだけを残します
  • 削除した内容を記録します

実施内容:

  • 同一のブロック(100文字以上)を特定します
  • 最初に現れたものだけを残します
  • 削除した内容を記録します

例:

❌ Bad: Same error message appears 5 times (500 chars × 5 = 2500 chars)
✅ Good: "[Error message appeared 5 times, showing once]: Connection timeout..."
戦略4:冗長な出力を圧縮する

タイミング:ツールの出力またはファイルの内容が非常に長い場合 タイミング:ツールの出力またはファイルの内容が非常に長い場合

実施内容:

  • 関連する部分だけを抽出します
  • それ以外は要約します
  • 参照できるように情報源を記録します

実施内容:

  • 関連する部分だけを抽出します
  • それ以外は要約します
  • 参照できるように情報源を記録します

例:

❌ Bad: Including full 1000-line log file
✅ Good: "Log file (1000 lines): Key errors on lines 45, 78, 234. 
   Pattern: Connection drops every 5 minutes. Full log available if needed."

🔄 ワークフロー

重要:エージェントはタスクを開始するたびに、以下の条件を積極的に確認してください。

每次任务开始前的检查流程:

1. 检查对话轮数:是否 > 10 轮?
2. 检查上下文大小:是否 > 5000 字符?
3. 检查文件读取:是否有文件被读取超过 1 次?
4. 检查用户意图:用户是否提到 "token" / "成本" / "省钱"?

如果满足任一条件 → 应用 save-token 策略 → 报告优化结果 → 继续执行任务

推奨:エージェントはユーザーに返信する前に、次の点を自問してください。

  • 「コンテキストが長くなっていないか?」
  • 「省略できる重複した内容はないか?」
  • 「再送信する代わりに要約できないか?」

📊 報告形式

トークン節約の戦略を適用した場合は、ユーザーに知らせてください。

💡 Token Optimization Applied:
- Strategy: [Strategy Name]
- Context before: X tokens
- Context after: Y tokens  
- Saved: Z tokens (P%)

⚠️ このスキルではできないこと

できないこと理由できないこと理由
コンテキストを直接変更するスキルはガイダンスであり、実行機能ではありませんコンテキストを直接変更するスキルはガイダンスであり、実行機能ではありません
コンテンツを自動的に削除する残す内容はエージェントが判断する必要がありますコンテンツを自動的に削除する残す内容はエージェントが判断する必要があります
正確な節約量を保証する実装方法によって異なります正確な節約量を保証する実装方法によって異なります

✅ このスキルでできること

できること説明できること説明
戦略を提供するトークンの節約方法を教えます戦略を提供するトークンの節約方法を教えます
活用の機会を特定する適用するタイミングを認識できるよう支援します活用の機会を特定する適用するタイミングを認識できるよう支援します
実装を案内するベストプラクティスを示します実装を案内するベストプラクティスを示します

📝 バージョン

  • バージョン:1.1.0
  • 更新日:2026-03-12
  • 変更点:これは実行スクリプトではなく、ガイダンススキルであることを明確化

コメント