全部技能 / 基础工具与工作流 / claude-code-ping-start-5h-quota
基础工具与工作流 · daymade/claude-code-skills

claude-code-ping-start-5h-quota

睡前/离开前额度耗尽时，设置一次性本机定时器，在 Claude 订阅额度重置后自动发一条极简 claude -p 消息，立刻开启新的 5 小时用量窗口——用户睡醒时新窗口已跑掉大半，等于白赚一个 冷却期。Use when 用户说「还有 X 小时重置额度，帮我定时戳一下 Claude」「我去睡觉了，到点 ping 一下开启新窗口」「额度用完了，重置后帮我踩个点」「设个定时器开启新的 5 小时 冷却期」，或提到 定时戳、戳 Claude、quota ping、开窗、额度重置后自动发消息。仅限一次性定时任务与 macOS 本机（caffeinate/BSD date）；周期性任务用 /loop 或 cron，查询 ChatGPT/Codex 何时重置用 tibo-reset-codex，分析额度为什么烧完用 claude-usage-analyst。

风险提醒：黄色 · 留意使用AI 侦查报告
作者 daymadeGitHub daymade/claude-code-skills ↗Stars 1385许可 MIT（仓库根 LICENSE 文件；GitHub API spdx MIT；Copyright (c) 2025 daymade）commit d5c4678cb5
agent 宿主通常会约束 skill 执行权限；风险提醒为 AI 侦查观点，不构成质量或安全保证。第三方 skill 仅作拆解与展示，安装使用风险自负，版权归原作者。

1实现原理 · 为什么它能做到

利用 5 小时窗口的起算语义：窗口从『窗口内第一条请求』起算而非固定时刻轮转，所以额度耗尽后没人发消息窗口就不开始计时；重置后立刻由定时任务代发一条极简消息，把窗口计时的起点藏进睡眠时间。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
Claude 订阅的 5 小时用量窗口从**窗口内第一条请求**开始计时，而不是按固定时刻轮转。
注：这里在做什么：把『睡觉期间额度重置』这个空档转化为收益——用户睡醒时新窗口已经消耗掉大半时长而几乎没消耗额度；'一次戳的成本极小：一条 `claude -p` 单轮消息。2026-08-29 实测全流程成功。'

定时器本体是一条 detached 后台进程链：caffeinate -is 防睡眠撑住等待期 → sleep N 秒 → cd $HOME → claude -p 发『Reply with exactly: ok』单轮消息，由 Bash run_in_background 启动。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
caffeinate -is /bin/sh -c 'sleep <SLEEP_SECONDS> && cd "$HOME" && claude -p "Reply with exactly: ok"'
注：命令解剖表解释每个组件为什么在：caffeinate 防 idle/插电睡眠（进程结束自动释放，防不了物理合盖）；sleep 是最简一次性载体（macOS 别依赖 at，ScheduleWakeup 上限 3600s 不够）；cd $HOME 避免加载项目 CLAUDE.md/hooks 白烧 token；claude -p 回一个词就退出的真实 API 请求。

run_in_background 是关键语义：前台 sleep 会被 harness 拦截；后台 detached 进程不依赖会话存活，且退出时会唤醒原会话形成『双保险』。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**必须 run_in_background**：前台 sleep 会被 harness 拦截；后台任务是 detached 进程，且退出时会重新唤醒当前会话（见 Step 5）。
注：『被唤醒这件事本身也是一次 API 请求，与 `claude -p` 互为双保险——任何一个发生都能开窗。』这是设计亮点：唤醒通知=宿主发起的请求，与定时戳互为冗余。

幂等与读回验证：启动前 ps 检查是否已有同款定时器（有则报告并问是否替换）；启动后用 ps 验证进程链三行（sh/caffeinate/sleep）都在。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
ps -ef | grep -E 'claude -p "Reply with exactly: ok"' | grep -v grep
注：『启动回执不算数，用 ps 确认进程链真的存在』是独立读回验证；预期至少三行，少了 sleep 行说明进程没起来。

时间换算公式化：等待分钟数 = 距重置分钟数 + 5 分钟缓冲；绝对时刻早于/等于当前时间按次日同刻理解（深夜跨零点是常态输入）；SLEEP_SECONDS = 等待分钟数 × 60。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
换算公式（占位符全文统一）：`等待分钟数 = 距重置分钟数 + 5`；`SLEEP_SECONDS = 等待分钟数 × 60`。
注：+5 分钟缓冲的理由：『重置时刻按用户口述估算有误差；早于重置时刻戳到的是旧窗口，纯浪费』。目标钟面时刻要报告给用户（'用户睡前想知道的是墙钟时刻'），并解释跨零点『6 点 15 重置』指明早的语义。

收尾核实与取消纪律：到点被唤醒后读任务 output 文件，预期 'ok' + '[exited with code 0]'；实际触发时刻以 output 文件 mtime 为准（stat -f '%Sm'）；取消用特征串 pkill 且明令禁止按秒数杀。

daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**禁止按秒数 `pkill -f 'sleep <SLEEP_SECONDS>'`**：本机长驻脚本的心跳 sleep 可能恰好同秒数，实测发生过误杀
注：取消命令为 pkill -f 'Reply with exactly: ok'（2026-08-29 实测可杀 caffeinate 与 sh；残留孤儿 sleep 无害，sh 已死 && 后不会执行）；output 文件路径在 Step 4 交代时写入对话历史，作为『通知丢失/上下文压缩』后的兜底（'路径也丢了就 ps 查进程链…读不到任何本地证据时如实说「无法本地确认」'——禁谎报）。

2核心能力

01一次性延迟触发额度窗口（caffeinate 防睡 + sleep 定时 + claude -p 单轮戳）
02幂等：启动前检测已有定时器并询问是否替换（不默默叠加第二个）
03进程链独立读回验证（ps 三行预期）
04任务 output 路径持久化交代 + 唤醒收尾核实（ok/exit 0/实际时刻 stat）
05特征串安全取消（pkill 'Reply with exactly: ok'；禁止按秒数杀）
06相对/绝对时间换算 + 跨零点次日语义 + 5 分钟缓冲

3外部依赖

类型依赖
cliclaude（官方 Claude Code CLI；claude -p 单轮 print 模式）
clicaffeinate（macOS 防睡眠）
clisleep / date / ps / pkill / stat（macOS/BSD 系统工具）
cli宿主 Bash 的 run_in_background 后台任务 + task-notification 唤醒（harness 能力）

4风险提醒 风险提醒：黄色 · 留意使用

风险提醒：黄色 · 留意使用
  • pkill 特征串存在误杀面 — pkill -f 'Reply with exactly: ok' 会杀掉本机任何命令行含该串的进程；虽比按秒数杀安全，但误杀概率非零，且取消后需 ps 确认。
  • dangerouslyDisableSandbox 建议属安全降级 — 沙箱拦截 caffeinate 时 SKILL.md 指示用 dangerouslyDisableSandbox: true 重试——在宿主沙箱被关闭的情况下执行命令链，用户应清楚该路径的授权含义。
  • 计时准确性依赖本机状态 — 机器睡眠/合盖/关机会使触发顺延或失效（caffeinate 防不住物理合盖）；时间差超几分钟时新窗口重置时刻要按实际触发时刻重算。
  • 消耗真实订阅调用 — 若用户口述重置时刻偏早或缓冲不足，戳到旧窗口会白消耗一次调用且不开新窗口（有补戳 10-15 分钟短定时器的处置，但仍需用户在场判断）。
  • 机制依赖宿主后台任务语义 — run_in_background detached + task-notification 唤醒是 Claude Code harness 特性；换宿主（Codex 等）无对应语义时本 skill 的『双保险/唤醒核实』不成立（skill 明示 Claude Code 场景）。
风险提醒：黄色，留意使用。按统一分档：无脚本资产、无凭证接触（claude CLI 用自己的登录态，skill 不读 key/cookie/env）、无直接网络代码——本地系统 CLI/进程管理为主（偏蓝）。抬到黄色的理由：① 经官方 claude CLI 产生真实网络 API 外发（对象 Anthropic，可预期但会消耗订阅与开启计时窗口）；② 指令含『沙箱拦截时用 dangerouslyDisableSandbox: true 重试』——在特定故障路径下建议关闭宿主沙箱执行 caffeinate/claude，属安全降级提示需用户知情；③ 后台长驻进程 + pkill 特征串取消存在误杀其他进程的残余面（skill 已有防误杀纪律但非零概率）。

5第二遍独立确认

  • [ok] 无自带脚本/资产（纯指令 skill） — glob 确认目录仅 SKILL.md；external_deps/internal_assets 不夸大（asset 列表为空）。
  • [ok] caffeinate/sleep/claude -p 命令链存在且为固定模板 — Step 2 代码块逐字存在；命令解剖表逐组件解释；无 shell 拼接注入（数字换算后入占位符）。
  • [ok] run_in_background 语义与双保险 — SKILL.md 原文『后台任务是 detached 进程，且退出时会重新唤醒当前会话』与 Step 5『被唤醒本身也是一次 API 请求』一致。
  • [ok] 幂等检查与 ps 读回验证 — Step 0 的 ps grep 命令与 Step 3 的三行预期存在；Step 4 交代 output 路径进对话历史。
  • [ok] 凭证接触面为零 — token 扫描（API_KEY/token/cookie/secret/Authorization）零命中；无 env/keychain/文件读取。
  • [ok] pkill 取消纪律（防误杀） — 禁止按秒数 pkill 的原文与实测误杀背景存在；特征串 pkill 为唯一取消路径。
  • [ok] 功能声明 vs 夸大检查 — 『5 小时窗口从窗口内第一条请求起算』是描述性机制声明（对 Claude 订阅语义的表述，标注 2026-08-29 实测）；skill 边界（macOS/一次性/不查询重置时刻）自我声明清晰，无越界承诺。
  • [ok] 元数据（license/stars/commit） — 仓库级 MIT、stars=1385、pushed_at=2026-09-09T12:33:29Z；本地 HEAD==pin d5c4678cb5d4fd6acc9c922690df035dbd33d247。

6结论

  • 用『窗口第一条请求起算』的订阅语义做时间套利，价值主张清晰且成本极小（一条 claude -p 单轮消息）。
  • 双保险与可恢复现场设计：claude -p 与唤醒互为备份，output 路径写进对话历史防压缩丢失，读不到证据就如实说无法确认。
  • 防误杀/幂等纪律来自实测教训：禁止按秒数 pkill（误杀过心跳 sleep）、启动前查重、替换走全流程。
  • 把系统知识教给后续 agent：命令解剖表逐组件『为什么在、改掉会怎样』，防止未来 agent 优化掉关键组件。
  • 边界诚实：macOS-only、一次性、不查不预测重置、关机合盖无法履约就不承诺——不假装通用。
    • 适合：适合：Claude 订阅额度耗尽且即将在数小时内重置、想睡觉/离开前把 5 小时窗口起点藏进空档的 macOS 本机用户；接受一次性定时器语义、愿意在启动后 ps 核验并把 output 路径记下来的场景。触发场景即 description 里的中文口令（「还有 X 小时重置」「我去睡觉了到点 ping」等）。
    不适合：不适合：非 macOS（Linux caffeinate/date -v 不可用且未验证）；需要周期性保活/每日定时（应用 /loop 或 cron）；需要查询/预测 ChatGPT/Codex 重置时刻（转 tibo-reset-codex）；关机/合盖常态化的设备（无法履约）；对『关闭沙箱重试』或后台进程面不适的用户。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-09
    方式 A · 人下载镜像包下载 claude-code-ping-start-5h-quota.tar.gz
    sha256: c6f9d07b09144f82…
    方式 B · JSON 格式安装指南，复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub？直接去上游安装（实时版，可能已更新）GitHub 原始 ↗
    本页镜像锁定 commit d5c4678cb5；上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库daymade / daymade/claude-code-skills
    原始 GitHubdaymade/claude-code-skills ↗
    Stars1385
    最近推送2026-09-09
    本 skill commitd5c4678cb5
    许可MIT（仓库根 LICENSE 文件；GitHub API spdx MIT；Copyright (c) 2025 daymade）
    本站信息
    收录日期2026-09-06
    分类基础工具与工作流
    侦查报告2026-09-06 · 2 遍
    本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。