shengdabai What This Skill Does
当用户即将耗尽 Claude Code 用量限制时，此 skill 会：
- 保存当前任务快照 — 记录任务描述、进度、下一步、关键上下文
- 设置 CronCreate 原生定时任务 — durable + one-shot，在指定时间触发恢复
- 自动恢复 — Claude Code 在定时时间读取快照并继续执行
Architecture (v3 — Native CronCreate)
CronCreate (durable: true, recurring: false)
→ 到时间后 Claude Code 自动执行 prompt
→ prompt 读取快照文件
→ 继续未完成的工作
为什么不用 launchd？
- launchd 没有 TTY，Claude Code 需要终端环境
- osascript 打开 Terminal.app 不可靠（权限问题、PATH 问题）
- CronCreate 是 Claude Code 原生功能，durable 模式写入
.claude/scheduled_tasks.json，重启后自动恢复 - One-shot durable 任务如果错过（REPL 关闭期间），下次启动时会补执行
Execution Steps
当用户触发此 skill 时，按以下步骤严格执行：
Step 1: 收集任务上下文
从当前对话上下文中提取（不要额外询问用户，除非信息严重不足）：
- Task Description: 用户原始任务描述
- Progress: 已完成的步骤（列出具体文件修改、命令执行等）
- Next Steps: 接下来需要做的事情（越具体越好）
- Key Context: 重要的文件路径、变量名、架构决策、API key 位置等
- Resume Time: 用户指定的恢复时间（如 "2am"、"5小时后"），默认 5 小时后
Step 2: 写入任务快照
mkdir -p ~/.claude/limit-continue-work/snapshots
写入文件 ~/.claude/limit-continue-work/snapshots/snapshot-$(date +%Y%m%d-%H%M%S).md：
---
created: {当前 ISO 时间}
working_directory: {pwd 输出}
resume_after: {恢复时间, ISO 格式}
status: pending
---
## Task Description
{从对话上下文提取}
## Progress So Far
{已完成的具体步骤}
## Next Steps
{接下来要做的事情，尽量具体到命令级别}
## Key Context
{文件路径、决策、注意事项}
Step 3: 设置 CronCreate 定时恢复
计算 cron 表达式：根据用户指定的恢复时间，生成对应的 cron 表达式。
示例：
- "2am" →
"3 2 10 4 *"(4月10日 2:03am，避开整点) - "5小时后" → 计算目标时间的 minute hour day month
- "明天早上" →
"57 8 {tomorrow_day} {tomorrow_month} *"
调用 CronCreate：
CronCreate({
cron: "{计算出的 cron 表达式}",
prompt: "我之前的任务因为用量限制中断了，现在用量已经重置。\n\n请读取任务快照文件了解完整上下文: {快照文件绝对路径}\n\n执行步骤：\n1. 用 Read 工具读取上面的快照文件\n2. 理解之前的任务、进度和下一步\n3. cd 到 working_directory 指定的目录\n4. 从 Next Steps 部分继续执行未完成的工作\n5. 全部完成后运行: sed -i '' 's/^status: pending/status: completed/' '{快照文件路径}'",
durable: true,
recurring: false
})
关键参数：
durable: true— 写入.claude/scheduled_tasks.json，重启后保留recurring: false— 一次性任务，执行后自动删除- 避开 :00 和 :30 分钟，减少 API 拥堵
Step 4: 验证并确认
# 确认快照已写入
ls -la ~/.claude/limit-continue-work/snapshots/
# 确认 scheduled_tasks.json 已更新
cat ~/.claude/scheduled_tasks.json 2>/dev/null | head -20
同时调用 CronList 确认任务已注册。
向用户输出确认信息：
- 快照保存位置
- 预计恢复时间（精确到分钟）
- 恢复方式：CronCreate (durable, one-shot) → Claude Code 自动执行 prompt → 读取快照 → 继续工作
- 取消命令：
CronDelete({id: "{job_id}"}) - 重要提醒：Claude Code 需要保持运行（REPL idle 状态）或在恢复时间之前重新启动。如果 REPL 关闭，下次启动时会补执行错过的 durable one-shot 任务。
Step 5: 清理旧数据
# 清理 7 天前的旧快照
find ~/.claude/limit-continue-work/snapshots/ -name "snapshot-*.md" -mtime +7 -delete 2>/dev/null
# 清理旧的 launchd 残留（v2 遗留）
rm -f ~/Library/LaunchAgents/com.claude.limit-continue-work.plist 2>/dev/null
launchctl bootout gui/$(id -u) com.claude.limit-continue-work 2>/dev/null || true
rm -f ~/.claude/limit-continue-work/resume.sh 2>/dev/null
rm -f ~/.claude/limit-continue-work/run-session.command 2>/dev/null
rm -f ~/.claude/limit-continue-work/resume-prompt.txt 2>/dev/null
Cancel Scheduled Resume
用户说"取消恢复"时：
- 调用
CronList找到对应的 job ID - 调用
CronDelete({id: "job_id"})取消 - 可选：将快照 status 改为
cancelled
Manual Resume
如果用户想手动恢复（不等定时任务）：
- 读取最新的 pending 快照：
ls -t ~/.claude/limit-continue-work/snapshots/snapshot-*.md | head -1 - 读取快照内容
- 按 Next Steps 继续执行
Debugging
如果恢复没有触发：
CronList— 检查任务是否还在cat ~/.claude/scheduled_tasks.json— 检查 durable 任务文件- 确认 Claude Code REPL 在恢复时间点是否运行（或之后是否重新启动过）
- 检查快照文件 status 是否仍为
pending
常见问题：
- 任务没触发：Claude Code REPL 必须在运行中（idle 状态）或在恢复时间后重新启动
- 7天过期：recurring 任务 7 天后自动过期，但 one-shot (recurring: false) 不受此限制
- 错过的任务：durable one-shot 任务如果在 REPL 关闭时错过，下次启动会补执行
Notes
- v3 完全使用 Claude Code 原生 CronCreate，不依赖 launchd、osascript、Terminal.app
- durable 模式持久化到
.claude/scheduled_tasks.json - one-shot 模式执行一次后自动删除
- 快照自动保留 7 天
- 如果用户关闭了 Claude Code，下次打开时错过的 durable one-shot 任务会自动补执行
- 用户可以在任意 Claude Code 会话中手动恢复（读取快照文件即可）
Migration from v2
v3 会自动清理 v2 遗留的 launchd 相关文件（Step 5），无需用户手动操作。