SuperAPI AI 工具集

deferred-task-execution

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:延迟执行智能体任务,直到用户指定的时刻或经过一段时长后再继续。适用于用户要求“稍后执行某事”“X分钟后执行”“在某个具体时间执行”等场景。

主要能力:使用后台计时脚本等待,脚本位于 ~/.claude/skills/deferred-task-execution/scripts/wait-until.sh。支持两类输入参数:时长,如30s、5m、1h、90m、2h30m、1h15m30s;时刻,如14:30、9:00、3pm、3:30pm。若指定时刻今天已过,则等到明天同一时刻。脚本通过自身顶部的 USER_TZ 变量处理时区,默认 Australia/Melbourne,时刻参数按该时区解释,无需与主机时区一致;除非用户提到出行,否则不必询问时区。

使用方式:先确认要执行的任务和触发时间,把自然语言转换为 wait-until 参数,例如“in 30 minutes”对应 30m,“at 3pm”对应 3pm,“at half past 9”对应 9:30am。告知用户将发生什么以及计时器何时触发,请其确认后再启动。随后在 Bash 中以 run_in_background: true 运行脚本:~/.claude/skills/deferred-task-execution/scripts/wait-until.sh <argument>。记录返回的任务 ID,用于取消。后台 Bash 会在脚本退出时通知,等待该通知,不要轮询。当输出包含“Timer complete. Proceed with deferred task.”后,执行用户请求的延迟任务。

适用场景与限制:仅适合用户期望在后台计时后自动继续的工作流。计时器正常工作要求智能体会话保持开启;如果用户关闭会话,延迟任务不会执行,应提前提醒。对于数小时的长等待,需要提醒用户会话必须保持活跃。若用户要求取消,使用 TaskStop 并传入后台任务 ID。始终告知用户计算出的唤醒时间,让其知道何时会执行操作。