re0-watch 是 lilmgenius/paperthin 下的一个技能,用于监视单个长时间运行的智能体作业,识别完成、声明暂停、健康静默与疑似卡死,并按需发出告警。
用途与目标
该技能仅在人类明确调用时,为一个正在运行的作业建立“可观察监视”。默认行为是只告警;恢复动作只作为提案交给人类审批,技能本身绝不执行无人值守恢复。
主要能力
- 运行身份登记:记录不可变的运行标识、所属宿主、权威终止来源、推进中的进度信号、存活工件、暂停来源与告警接收方。仅靠自我报告的“running”字样不足以建立身份。
- 三组时间量:检查频率(观察者多久醒来一次)、静默阈值(进度可冻结多久)、告警冷却(同一运行与同一冻结信号重复告警的最小间隔)。阈值建议由观测节奏推导,约为最长健康静默的 2 至 3 倍,并结合延迟发现成本;仅在既未提供也无法推导时,才建议以 30 分钟作为未经验证的起始值。检查频率、告警冷却与重试间隔没有默认值。
- 登记与解除:通过宿主已有的注册原语建立监视,每个运行身份只能有一个观察者,后来重复注册会被拒绝并报告已有观察者。注册组件负责解除。
- 告警内容:运行身份、冻结或未解决的信号、最后移动的 UTC 时间与已过时长、判决所在层级、不确定性以及已记录的尝试次数。
- 有序评估层级:依次检查身份、权威终止、暂停声明、进度与心跳、疑似卡死、告警冷却、经批准的恢复提案。任一层级未解决,都不允许提出恢复建议。
使用方式
技能以脚本与文件形式运行,例如使用 node scripts/wake.mjs --arm <arm.json> --observation <observation.json> --json 评估每次唤醒,使用 node scripts/goal-rearm.mjs plan/verify/check 处理 Codex 线程目标的重新登记与失效检查。脚本退出码含义为:0 不发送、2 告警、3 需要人工判断。用户需将每次唤醒读取到的宿主数据(终止来源、暂停工件、各信号)完整写入观察文件。
适用场景
适用于需要跨时间观察一个长任务是否仍在推进、是否已声明暂停、是否疑似卡死的场景,尤其是希望只获得告警、由人类决定是否恢复的场合。
限制
- 只观察与告警,不执行恢复;恢复提案需人类批准,且批准不会转移到新运行或重试通道。
- 未知不等于不存在:读取失败、缺失或权限拒绝的工件都按“未知”处理,不得据此判断无暂停或已卡死。
- 暂停声明需按登记记录中的算法与密钥校验签名,签名不匹配或无法验证即拒绝。
- 若宿主缺少监控注册原语,则不能建立监视,只能返回建议并声明无人值守能力不可用。
- 未完成的线程目标不能新建,只能通过取代方式重新登记。
- 暂停格式与数值建议均为未经验证的起点。