auto-continue

name	auto_continue
description	把当前项目接入用量自动暂停/恢复。当用户想让某个 Claude Code 项目在接近 5-hour 用量上限时自动保存进度并暂停、reset 后自动从断点恢复时使用。本技能是安装器——它铺好独立监控脚本 monitor.py、注册每 15 分钟运行的 Windows 计划任务、并把 worker 协作规范(E 节)追加进当前项目的 CLAUDE.md。监控走方案 A(独立脚本读 Chrome DOM),不消耗 Claude 额度。触发短语:接入 auto_continue、安装用量监控、自动暂停恢复、auto_continue。

auto_continue 安装器

把当前所在项目接入「用量自动暂停 / 恢复」。监控侧是一个由 Windows 任务计划驱动的独立脚本 (方案 A,读 Chrome DOM,不消耗 Claude 额度);worker 侧靠 CLAUDE.md 的 E 节协作规范在 /loop 中 读取共享控制文件来暂停 / 恢复。完整设计见本技能目录下的 readme.md。

安装前先确认(向用户问清,缺一不可)

1. 账号级目录路径:默认 %USERPROFILE%\.claude\auto_continue\。
2. 当前项目就是要被托管的 worker 吗? E 节会追加到“当前项目”的 CLAUDE.md。
3. Chrome 调试端口:默认 9222。
4. 提醒用户:监控依赖一个以调试端口启动、并登录了 Claude.ai 的 Chrome;worker 长任务要在 /loop 下跑。

安装步骤(按序执行,每步完成后简述结果)

步骤 1 — 铺设监控脚本

• 确保账号级目录存在:%USERPROFILE%\.claude\auto_continue\。
• 把本技能 scripts\monitor.py 复制到该目录。
• monitor.py 已内置全部默认值(含已校准的选择器、cdp_url=http://127.0.0.1:9222、threshold=90), config.json 可选——仅当需要改阈值 / 端口 / 路径时,才由 scripts\config.example.json 生成 config.json 覆盖对应项。cdp_url 必须用 127.0.0.1 而非 localhost(后者可能走 IPv6 连不上)。

步骤 2 — 注册 Windows 计划任务(15 分钟一次)

用 schtasks 注册名为 auto_continue_monitor 的任务,每 15 分钟运行 python "%USERPROFILE%\.claude\auto_continue\monitor.py":

$py = (Get-Command python).Source
$mon = "$env:USERPROFILE\.claude\auto_continue\monitor.py"
schtasks /create /tn auto_continue_monitor /sc minute /mo 15 /f `
  /tr "`"$py`" `"$mon`""

注册后用 schtasks /query /tn auto_continue_monitor 核对。确认已安装 Playwright:pip install playwright (无需 playwright install,脚本是 connect 已有 Chrome)。

步骤 3 — 追加 worker 协作规范到当前项目 CLAUDE.md

把 readme.md 第 4 节的 ## E. Auto-Continue 协作规范 整节原样追加到当前项目 CLAUDE.md 末尾 (若已存在 E 节则跳过或更新)。控制文件路径须与 config.json 的 control_path 一致。

步骤 4 — 启动调试 Chrome 并登录

指导用户:用 scripts\start_chrome_debug.ps1 启动带调试端口的 Chrome,在该独立 profile 窗口里登录 Claude.ai 并保持打开(它与日常 Chrome 是两套登录态;登录一次会被记住)。选择器已对当前 claude.ai 校准(用量按钮 button[aria-label^="Usage"],面板内锚定文案 5-hour limit),无需手动校准; 仅当 Claude.ai 改版导致读取失败时,才需更新 monitor.py / config.json 里的这两个值。

步骤 5 — 验证

• 手动跑一次:python "%USERPROFILE%\.claude\auto_continue\monitor.py",看 monitor.log 是否出现 ok: percent=.. state=..,并检查 control.json 内容正确。
• 提示用户:worker 长任务用 /loop 启动(如 /loop 15m <任务>),它会按 E 节在每轮读取 control.json。

关键约束

• 控制文件路径在 monitor(config.json)与 worker(CLAUDE.md E 节)两侧必须一致。
• 5-hour limit 是账号级共用,控制文件放账号级目录,统管本账号所有 worker。
• monitor 故障为 fail-open:故障期间 worker 约 40 分钟后回到 RUN,可能在监控失灵时越过上限。