mcpField
U
usage-limit-reducer

usage-limit-reducer

github.com/dubibubiiAgent 工作流20351 次安装27 周前更新
代码仓库

关于 usage-limit-reducer

Usage Limit Reducer 是面向 Claude Code 的技能，可检查本地 Token 用量，并根据 Dubi 的 11 条规则提供相关建议。它帮助用户寻找降低用量的方法，不会自动更改设置。

主要功能

  1. 01生成本地 Token 用量报告
  2. 02检查会话长度和所用模型
  3. 03检查 CLAUDE.md 文件
  4. 04提供针对性的用量建议
  5. 05不自动更改设置

适用场景

  1. 01诊断 Token 用量偏高的原因
  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

详细介绍

使用量限制优化器

应用 Dubi 的 11 条规则，减少 Claude 的令牌用量。Claude 每轮都会重新读取整个对话，因此通常有 98.5% 的令牌都花在重读历史记录上，而不是生成回复。此技能会诊断用户的令牌用在了哪里，并应用真正能显著减少用量的规则。

如何运行此技能

按顺序执行以下步骤。明显不适用的步骤可以跳过，但不要全部跳过——关键在于根据用户的实际使用情况匹配规则。

步骤 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。

步骤 2 — 诊断当前会话

提出建议前，检查以下三项：

  1. 对话长度。 如果当前会话已经有很多轮，则直接适用规则 #2。建议使用 /compact（就地总结）或使用 /clear，然后在新对话的第一条消息中粘贴一段话的摘要。
  2. 是否存在 CLAUDE.md。 检查项目根目录和 ~/.claude/CLAUDE.md 中是否有 CLAUDE.md。如果缺少，则适用规则 #6——提议创建一个文件，写入用户的角色、风格和项目约定，避免每次新会话都耗费 3–5 条消息进行设置。
  3. 当前使用的模型。 如果用户用 Opus 处理简单任务（语法、格式调整、简短回答、快速重命名），则适用规则 #8——建议处理这些任务时使用 /model claude-haiku-4-5，将 Opus 留给深度工作。
步骤 3 — 应用适用的规则

从中挑选 2–4 条与用户当前任务最相关的规则。不要把 11 条规则全都列出来。对每条选中的规则，说明 (a) 应该怎么做，(b) 为什么有效，(c) 具体的下一步操作。

#规则Claude Code 操作
1不要通过后续消息纠正——修正提示词后重新开始Claude 误解时，使用 /clear 并重新编写提示词，而不是不断追加修正
2每 15–20 轮开启新对话使用 /compact 就地总结，或使用 /clear 并粘贴摘要
3将问题集中在一条消息中将相关问题合并到一个提示词中；信息完整时 Claude 通常回答得更好
4跟踪实际令牌用量运行步骤 1 中的脚本
5复用常用上下文将内容放入 CLAUDE.md、技能或 .context/，不要在每次会话中重新粘贴
6设置记忆 / 用户偏好创建或更新 CLAUDE.md；使用 ~/.claude/projects/*/memory/ 下的记忆系统
7关闭不使用的功能检查 ~/.claude/settings.json，审视未使用的 MCP 服务、钩子和权限
8简单任务使用 Haiku语法、草稿、格式调整、快速查询使用 /model claude-haiku-4-5
9将工作分散到一天中采用 5 小时滚动窗口——分成 2–3 个会话，而不是一次长时间工作
10避开高峰时段工作工作日太平洋时间上午 5–11 点 / 东部时间上午 8 点至下午 2 点为高峰；晚上和周末可以延长套餐用量
11启用超额用量作为安全保障Pro/Max 套餐可在 Settings → Usage 中设置——达到限额后会启用按量付费
步骤 4 — 提供具体的下一步操作

最后根据诊断结果，列出简短、有序的当前待办事项。示例：

  • “运行 /compact——当前对话已超过 40 轮。”
  • “我可以根据你的偏好创建 CLAUDE.md——需要我创建吗？”
  • “这次重命名改用 Haiku：/model claude-haiku-4-5。”

不要复述所有规则。不要说教。建议应与当前会话的实际情况相符。

Claude Code 中无法实现的规则

  • 规则 #1（“编辑你的提示词”）是 claude.ai 网页 UI 功能；在 Claude Code 中，对应的操作是 /clear + 重启。
  • 规则 #5（“上传到 Projects”）也仅限网页端；请改用 CLAUDE.md、技能和 .context/。
  • 规则 #11（超额使用）由套餐级别决定——提及即可，无需实现。

此技能不会做什么

  • 它不会悄悄更改用户的模型或设置。它会先提出建议，只有在确认后才会执行。
  • 它不会在未征求同意的情况下总结并清除内容——用户可能还有未保存的对话上下文。
  • 它不会将数据发送到任何地方。使用情况报告严格保存在本地。

评论

支持 Markdown