SuperAPI AI 工具集

delivery-wait

部署与运维

查看项目

更新于 10-15 21:47

技能介绍

用途:delivery-wait 供交付工作流在必须等待外部 GitHub 状态时使用,运行 scripts/delivery_wait.py 被动等待命令结束,不用模型心跳模拟等待。

主要能力:支持等待精确 head 的检查、PR 合并、工作流完成、标签目标、发布资产以及绝对唤醒时间。命令会先核对已保存状态与最新 GitHub 状态,在无相关变化时保持等待,最终以单一结果退出。

用法:wait <kind> --repo <owner/repo> --deadline <ISO 8601> [--interval <seconds>] [--state <path>] [--json] 执行等待;inspect <kind> 使用相同身份参数但不含 --deadline、--interval、--state。各 kind 需要各自身份参数,例如 checks-terminal 需要 --pr、--head,以及 --all-workflows 或每个预期检查一个 --check;pr-merged 需要 --pr 与 --head;workflow-terminal 需要 --run-id 与 --head;tag-target 需要 --tag 与 --head;release-assets 还需每个必需资产一个 --asset;wake-at 仅需 --deadline。工作流技能建议使用 --json。默认状态文件位于 .agent/waits/,使用仓库需将其加入 gitignore,也可通过 --state 指定私有路径。

限制:每个状态文件只保留一个运行中的等待;不要用 setsid、nohup 或 & 分离等待进程;等待期间不要检查其覆盖的状态;--all-workflows 不覆盖其他应用的提交状态或检查运行,需要时逐个添加 --check;--check 单独使用时只判断指定上下文;没有 --checkpoint 标志;结果中只有 satisfied 才确立所等待的事实,changed、invalidated、timed-out、cancelled 退出码为 0,operational-error 退出码为 2。该工具使用已认证的 gh 传输,优先 GraphQL,仅在限流且 REST 能保留同一事实或该事实仅通过 REST 暴露时回退 REST。