Claude-Code-Skill-Otsukare

Claude Code 使用量守护者,防止任务因超限中断

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Claude-Code-Skill-Otsukare。
它的用途是:Claude Code 使用量守护者,防止任务因超限中断
完整的 Skill 内容见:https://321skill.com/skills/claude-code-skill-otsukare/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

当你需要在 Cursor 中让 Claude Code 处理一个可能运行数小时的大型项目代码分析时,你可以对它说:“otsukare,请帮我重构整个项目的 API 接口。” 它会先检查你的用量配置,然后启动守护模式。在任务执行中,它会监控用量,在接近5小时限制的90%时安全暂停,并在限制重置10分钟后自动恢复任务,直到完成。

介绍

otsukare 是一个专门为 Claude Code 设计的用量守护 Skill,它解决了用户在运行长时间或高消耗任务时,因触及 5 小时或 7 天用量限制而导致任务意外中断的痛点。它通过在任务开始前被调用,将任务包裹在一个监控层中,实时追踪用量,并在用量接近阈值时安全暂停任务,待限制重置后自动恢复,确保长任务能够顺利完成。

使用方式非常简单:在启动一个可能耗尽用量限制的长任务前,对 Claude Code 说出触发词(如“otsukare”、“watch my usage”),otsukare 就会被激活。它会引导用户完成必要的本地配置(主要是确保用量数据文件存在),然后开始执行守护流程。它本身不执行具体工作,而是像一个智能的“交通信号灯”,在任务执行过程中,根据用量情况控制任务流(Dispatch gate)的并发规模,并在合适的时机暂停与恢复。

这个 Skill 非常适合那些需要 Claude Code 处理代码生成、大型重构、批量文件处理、数据清洗等耗时较长或令牌消耗巨大的任务的开发者。特别是当任务需要在无人值守的情况下运行(例如夜间),或者用户无法时刻监控用量时,otsukare 提供了关键的自动化保障。

与同类简单的“用量提醒”工具相比,otsukare 的核心区别在于其主动的“守护”与“恢复”机制。它不仅仅是报警,而是深度介入任务执行流程,通过“Dispatch gate”机制动态控制子任务并发数来预防用量在单次执行中突破100%的“硬中断”状态,并具备完整的暂停、状态保存和自动恢复能力,形成了一个闭环的解决方案。

核心特点

核心区别在于其主动的“用量门控”机制和完整的自动恢复工作流。它不仅监控,还会在每次派遣子任务前根据剩余用量动态计算安全并发数,从源头防止用量在单次任务流中突破100%导致不可恢复的中断;并能在暂停后,于限制重置后自动恢复任务,无需人工干预。

注意事项

不适合需要频繁调用 `run_in_background` 非阻塞子代理的任务,因为这会破坏其状态保存和恢复的完整性。

常见问题

otsukare 是什么意思?

“otsukare”是日语“お疲れ”的罗马字,意为“辛苦了”,这里寓意“让AI在超限前休息,之后继续工作”。

使用前必须做什么配置?

必须按照项目 README 配置,让 Claude Code 的状态行用量数据能写入本地的 `last-statusline-input.json` 文件,否则 otsukare 无法获取用量信息。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/claude-code-skill-otsukare/raw/index.md 读取 Claude-Code-Skill-Otsukare 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。