mcpField
U
usage-limit-reducer

usage-limit-reducer

github.com/dubibubiiエージェントワークフロー20351 回インストール27 週間前に更新
リポジトリ

usage-limit-reducer について

Usage Limit Reducer は Claude Code 向けのスキルで、ローカルのトークン使用量を確認し、Dubi の 11 のルールから状況に合う提案を行います。設定を自動変更せず、使用量を抑える方法を探せます。

主な機能

  1. 01ローカルのトークン使用量レポート
  2. 02セッションの長さとモデルの確認
  3. 03CLAUDE.md ファイルの確認
  4. 04状況に応じた使用量削減の提案
  5. 05設定の自動変更なし

活用シーン

  1. 01トークン使用量が多い原因の診断
  2. 02プロジェクト情報の繰り返し入力の削減
  3. 03定型作業に使うモデルの選択
  4. 04未使用の MCP サーバーやフックの確認

インストール

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

$npx skills add https://github.com/dubibubii/usage-limit-reducer --skill usage-limit-reducer

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

同梱ファイル

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

.gitignore
.gitkeep
README.md
scripts/
usage-report.py
test_usage_report.py

詳細

Usage Limit Reducer

Dubi の 11 のルールを適用して、Claude のトークン使用量を削減します。Claude は毎ターン、会話全体を読み直すため、トークンの 98.5％が応答の生成ではなく、履歴の再読に費やされることもよくあります。このスキルは、ユーザーのトークンがどこで使われているかを診断し、実際に効果のあるルールを適用します。

このスキルの実行方法

手順を順番に進めてください。明らかに当てはまらない手順は省略してかまいませんが、すべてを省略しないでください。ユーザーが実際に行っていることにルールを照らし合わせることが、このスキルの価値です。

Step 1 — 実際のトークン使用状況レポートを実行する

ルール #4：「測定できないものは改善できません」。Claude Code は、すべてのトークン、モデル、タイムスタンプをすでに ~/.claude/projects/<project>/<session>.jsonl に記録しています。このスキルのディレクトリ内にある scripts/usage-report.py の絶対パスを使って、同梱のスクリプトを実行し、内訳を表示してください。

python3 <SKILL_DIR>/scripts/usage-report.py --days 7

フラグ：--days N（既定値は 7）、--project <substring>（cwd で絞り込み）、機械可読な出力にする --json。主な数値をユーザーに伝えてください。特に重要なのは、キャッシュヒット率とモデル構成です。キャッシュヒット率が低い（約 60％未満）場合は、新しいチャットが多すぎるか、キャッシュを無効化する編集が多すぎることを意味します。日常的な作業で Opus の使用率が高い場合は、ルール #8 が当てはまります。

Step 2 — 現在のセッションを診断する

アドバイスする前に、次の 3 点を確認してください。

  1. 会話の長さ。 このセッションのターン数がすでに多い場合は、ルール #2 がそのまま当てはまります。/compact（その場で要約）を提案するか、/clear を実行して、新しいチャットの最初のメッセージとして 1 段落の要約を貼り付けるよう提案してください。
  2. CLAUDE.md の有無。 プロジェクトのルートと ~/.claude/CLAUDE.md を確認してください。存在しない場合は、ルール #6 が当てはまります。ユーザーの役割、スタイル、プロジェクトの規約を記載したファイルの作成を提案してください。そうすれば、新しいセッションのたびに設定に 3～5 メッセージを費やさずに済みます。
  3. 使用中のモデル。 些細な作業（文法、書式設定、短い回答、簡単な名前変更）に Opus を使っている場合は、ルール #8 が当てはまります。そのような作業には /model claude-haiku-4-5 を推奨し、Opus は高度な作業に使うよう勧めてください。
Step 3 — 当てはまるルールを適用する

今ユーザーが行っていることに最も関連するルールを 2～4 個選んでください。11 個すべてを一度に提示しないでください。選んだ各ルールについて、（a）何をするか、（b）なぜ効果があるか、（c）次に何をすればよいかを具体的に伝えてください。

#ルールClaude Code での操作
1修正のために追加で指示せず、修正したプロンプトでやり直すClaude が誤解した場合は、修正指示を重ねる代わりに /clear を実行して、プロンプトを送り直す
215～20 ターンごとに新しいチャットを始めるその場で要約するには /compact を実行するか、/clear を実行して要約を貼り付ける
3質問をまとめて 1 つのメッセージにする関連する依頼を 1 つのプロンプトにまとめる。全体像を示すと、Claude の回答がより適切になることがよくあります
4実際のトークン使用量を追跡するStep 1 のスクリプトを実行する
5繰り返し使うコンテキストを再利用する毎回貼り直すのではなく、CLAUDE.md、スキル、または .context/ に記載する
6メモリ／ユーザー設定を設定するCLAUDE.md を作成または更新する。~/.claude/projects/*/memory/ にあるメモリシステムを使う
7使っていない機能をオフにする~/.claude/settings.json を確認し、使っていない MCP サーバー、フック、権限を見直す
8簡単な作業には Haiku を使う文法、下書き、書式設定、簡単な検索には /model claude-haiku-4-5 を使う
9作業を 1 日に分散する5 時間のローリングウィンドウに合わせ、1 回の長時間作業ではなく 2～3 回のセッションに分ける
10混雑していない時間帯に作業する平日の PT 午前 5～11 時／ET 午前 8 時～午後 2 時が混雑します。夕方や週末なら、プランの利用枠をより長く活用できます
11安全策として Overage を有効にするPro／Max プランでは、Settings → Usage から設定できます。上限に達すると従量課金に切り替わります
Step 4 — 次に行うことを具体的に提案する

診断に基づいて、今すぐ行うことを短く、順番に並べて最後に提示してください。例：

  • 「/compact を実行してください。この会話は 40 ターンを超えています。」
  • 「設定を記載した CLAUDE.md を作成できます。作成しますか？」
  • 「この名前変更には Haiku に切り替えてください：/model claude-haiku-4-5。」

すべてのルールを繰り返さないでください。説教もしないでください。実際のセッションの状況に合わせてアドバイスしてください。

Claude Codeでは実装できないルール

  • ルール #1（「プロンプトを編集」）はclaude.aiのWeb UI機能です。Claude Codeでは、同等の操作は/clearしてから再起動することです。
  • ルール #5（「Projectsにアップロード」）もWeb限定の機能です。代わりにCLAUDE.md、スキル、.context/を使用してください。
  • ルール #11（超過分）はプランレベルの機能です。言及するにとどめ、実装しないでください。

このスキルで行わないこと

  • ユーザーのモデルや設定をひそかに変更することはありません。まず推奨し、確認を得てから実行します。
  • 確認せずに要約して会話をクリアすることはありません。会話には未保存のコンテキストが含まれている場合があります。
  • データを外部に送信することはありません。使用状況レポートは完全にローカルで処理されます。

コメント

Markdown 対応