1仕組みと動作原理
5時間枠の起算仕様の活用：枠は固定時刻でのローテーションではなく「枠内の最初のリクエスト」から起算されるため、リセット後に誰も送信しなければタイマーは開始されません。リセット直後にタイマータスクが極小メッセージを代理送信することで、枠の起算点を睡眠時間中に潜り込ませます。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
Claude 订阅的 5 小时用量窗口从**窗口内第一条请求**开始计时，而不是按固定时刻轮转。
ここで行っていること：「就寝中の枠リセット」という空き時間をメリットに変換します。起床時には枠の消費をほぼゼロに抑えたまま、新枠の残り時間を大幅に進めておくことができます。「つつくコストは極小：1ターンの `claude -p` メッセージ1通のみ。2026-08-29に全フロー実証済み。」
タイマー本体はデタッチされたバックグラウンドプロセスチェーン：caffeinate -is でスリープを防止して待機時間を維持 → sleep N 秒 → cd $HOME → claude -p で「Reply with exactly: ok」を1ターン送信。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 はアイドル／給電スリープを防止（プロセス終了時に自動解放、物理的なクラムシェル閉じは防止不可）；sleep は最もシンプルな単発キャリア（macOSの at に依存しない、ScheduleWakeup の上限3600秒は不足）；cd $HOME はプロジェクトの CLAUDE.md/hooks の読み込みによる無駄なトークン消費を防止；claude -p は1単語を返して即終了する正規のAPIリクエスト。
run_in_background が重要な仕様：フォアグラウンドの sleep はハーネスに遮断されます。デタッチされたバックグラウンドプロセスはセッションの生存に依存せず、終了時に元のセッションを起動して「二重の保険」を形成します。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
**必须 run_in_background**：前台 sleep 会被 harness 拦截；后台任务是 detached 进程，且退出时会重新唤醒当前会话（见 Step 5）。
「起こされること自体も1回のAPIリクエストであり、`claude -p` と相互に二重の保険となる——どちらか一方が発生すれば枠が開く。」これが設計のハイライトです。起床通知（ホスト起点の要求）とタイマーpingが相互に冗長化されています。
冪等性と読み戻し検証：起動前に ps で同種のタイマーが既存か確認（存在する場合は報告して置換するか確認）；起動後は ps でプロセスチェーンの3行（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 でプロセスチェーンの実在を確認する」という独立した読み戻し検証です。最低3行を期待し、sleep 行が欠けていればプロセスが起動していません。
時間換算の計算式化：待機分数 = リセットまでの分数 + 5分のバッファ；現在時刻以前の絶対時刻は翌日の同時刻として解釈（深夜の0時またぎが標準的な入力パターン）；SLEEP_SECONDS = 待機分数 × 60。
daymade-claude-code/claude-code-ping-start-5h-quota/SKILL.md
换算公式（占位符全文统一）：`等待分钟数 = 距重置分钟数 + 5`；`SLEEP_SECONDS = 等待分钟数 × 60`。
+5分のバッファを設ける理由：「口頭に基づくリセット時刻の見積もりには誤差がある；リセット前に突くと旧枠を消費してしまい純粋な無駄になる」。目標の時計時刻をユーザーに報告し（「ユーザーが就寝前に知りたいのは壁掛け時計の時刻」）、0時またぎ（例：「6時15分リセット」は翌朝を指す）のニュアンスも説明します。
完了確認と取り消し規律：指定時刻に起床後、タスクの output ファイルを読み込み、「ok」+「[exited with code 0]」を確認；実際のトリガー時刻は output ファイルの mtime（stat -f '%Sm'）を正とします。取り消しは特徴文字列による pkill を行い、秒数指定での kill は厳禁とします。
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 1ターントリガー）
02冪等性：起動前に既存タイマーを検知し、置換するか確認（重複起動を防止）
03プロセスチェーンの独立読み戻し検証（ps の3行確認）
04タスク output パスの永続的記録 + 起床後の完了確認（ok / exit 0 / stat による実時刻取得）
05特徴文字列による安全な取り消し（pkill 'Reply with exactly: ok'；秒数指定での kill は禁止）
06相対／絶対時間の換算 + 0時またぎの翌日解釈 + 5分の安全バッファ
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | claude（官方 Claude Code CLI；claude -p 单轮 print 模式） |
| cli | caffeinate（macOS 防睡眠） |
| cli | sleep / date / ps / pkill / stat（macOS/BSD 系统工具） |
| cli | 宿主 Bash 的 run_in_background 后台任务 + task-notification 唤醒（harness 能力） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: エージェントがホストのバックグラウンドで実行: caffeinate -is /bin/sh -c 'sleep <S> && cd $HOME && claude -p
- 网络端点: 外部ネットワークアクセスの宣言: 公式の claude CLI を通じて Anthropic に対して正規のサブスクリプションAPIリクエストを発行（claude -p の1ターン。これが本スキルの主目的）
監査ノート： 統一判定基準による分類：スクリプト資産なし、認証情報への接触なし（claude CLI 自身のログイン状態を利用し、スキルは key/cookie/env を読み込まない）、直接のネットワーク通信コードなし——ローカルシステムのCLI/プロセス管理が中心（青寄り）。黄へ引き上げる理由：① 公式 claude CLI 経由で正規の外部ネットワークAPI通信が発生する（Anthropic宛てで予期される挙動だが、サブスクリプション枠の消費と計測ウィンドウの開始を伴う）；② 指示文に「サンドボックスで遮断された場合は dangerouslyDisableSandbox: true で再試行」とあり、特定のエラー経路でホストのサンドボックスを無効化して caffeinate/claude を実行するよう促すセキュリティレベル緩和の提示が含まれるため、ユーザーの認知が必要；③ バックグラウンド常駐プロセス + pkill 特徴文字列によるキャンセルには、他プロセスを誤終了させるリスクがわずかに残る（スキル側に誤殺防止規律はあるが確率は非ゼロ）。
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サブスクリプションの利用枠を使い切り、数時間後にリセットされる予定で、就寝中や離席中に5時間の枠開始を潜り込ませたいmacOSローカルユーザー。単発タイマーの仕様を受け入れ、起動後に ps での検証や output パスの記録を行いたいシーン。トリガー条件は description 内のフレーズ（「あとX時間でリセット」「寝るから時間になったらping」など）。
不向きな用途： 適していないケース：非macOS環境（Linuxの caffeinate/date -v は利用不可かつ未検証）；定期的な死活監視や毎日の定時実行が必要な場合（/loop や cron を使用）；ChatGPT/Codexのリセット時刻の確認・予測が必要な場合（tibo-reset-codex へ転送）；電源オフや画面を閉じる運用が常態化しているデバイス（約定不可）；サンドボックス無効化での再試行やバックグラウンドプロセスに抵抗があるユーザー。
Install Agent-Ready
① Verified Mirror 2026-09-09
Option A · Direct DownloadDownload claude-code-ping-start-5h-quota.tar.gz
sha256:
Option B · Copy Guide for Agentc6f9d07b09144f82…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit d5c4678cb5.