SuperAPI AI 工具集

run-after

通用与其它

查看项目

更新于 11-05 17:23

技能介绍

用途 run-after 用于处理会话中无法由智能体主动感知的后续步骤:某些命令必须等用户先完成一个外部事件(如部署、提交、合并、推送、CI 通过)之后才能执行。用户启动该事件后,再运行本技能,由它确认计划、监控事件、执行命令。

主要能力

  • 收集等待步骤:从对话中列出每个被推迟的步骤,并为每条记录五项信息:确切命令(含参数)、运行位置(本地、工作树或远程目标)、门槛事件(commit、push、merge、CI 或 deploy)及其对应的变更(提交 SHA、分支或 PR 编号)、步骤顺序、是否会在仓库外写入数据。若带参数,则只保留参数指定或门槛匹配的步骤;若对话被压缩,会说明早期步骤可能缺失。
  • 确定门槛判定方式:门槛只有针对本次变更才算通过(例如部署了旧提交不算通过)。对 squash 或 rebase 合并,以基线分支上的合并提交为准。文档给出了 commit、push、merge、CI、deploy 五类门槛的判定条件与检查命令。部署信号按顺序查找:项目内写明的部署检查、.github/workflows 中的部署工作流、报告运行版本的端点或 CLI;都找不到则询问用户如何判断。
  • 确认计划:按执行顺序逐行打印计划,注明每条命令的门槛、当前状态及是否写入数据,并说明监控方式与时间限制(默认 60 分钟)。用户可选择全部执行、部分执行或取消。只有用户批准的命令集合才会被执行,且每条只执行一次;计划外或之后变更的命令需重新批准。
  • 监控门槛:使用能自行结束的命令监控,避免前台 sleep 或轮询循环;阻塞式命令放到后台运行,其他检查用 wait-until.sh 包装(间隔 30 秒,超时按限制),该脚本输出 passed、failed 或 timeout 的 JSON 判定。无后台能力的运行环境可前台运行或定期调度检查;也可选“完成时我告诉你”,直接结束回合等待用户。
  • 执行与汇报:按顺序执行门槛已通过的已批准步骤,并读取退出码与输出作为成功证据(如回填报告 0 行而预期有行会标记为警告)。某步失败即停止,不重试也不执行后续步骤。最后可用通知逐行汇报:✅ 成功及证据、❌ 失败及引用的错误、⚠️ 门槛失败/超时/输出异常、👉 下一步;未执行的步骤说明被哪个门槛或失败所阻止。

使用方式 在用户启动外部事件后调用本技能,技能会先收集等待步骤、确定各门槛的检查方式、展示计划并等待用户选择,随后在后台监控门槛,通过后执行获批步骤并汇报结果。

适用场景 部署后回填数据、合并后清缓存、提交后执行命令、CI 通过后继续操作等需要等到特定事件发生的后续步骤。

限制 资料未提供安装命令、平台支持范围、收费与效果信息。执行依赖会话中能识别出的等待步骤与门槛;门检查需要相应工具(如 git、gh 等)可用;对话压缩可能导致早期步骤缺失;没有后台能力的运行环境需改用前台或调度方式;默认监控时限为 60 分钟,超过用户指定时间会超时。