save-token について
save-token は、要約、参照、重複排除、出力圧縮によってコンテキストの重複を減らすエージェント向けガイダンススキルです。適用時を見極める手助けをしますが、実行時のコンテキスト自体は変更しません。
主な機能
- 01以前の会話コンテキストを要約
- 02既読の内容を参照
- 03重複したテキストブロックを排除
- 04長いツール出力やファイル出力を圧縮
- 05トークン節約策を使う場面を特定
活用シーン
- 01長い会話のコンテキストを簡潔化
- 02確認済みファイルの再読を回避
- 03繰り返すエラーをパターンとして提示
- 04長いログから要点を抽出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ yesilsin-netizen/ save-token --skill save-tokenインストール後、Claude Code で/save-tokenを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEpackage.json.gitignoreREADME.mdsave-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
- 変更点:これは実行スクリプトではなく、ガイダンススキルであることを明確化
コメント
Markdown 対応