Skip to main content
参考

Loop 命令参考

/loop 循环执行的参数格式、间隔单位、动态节奏模式与取消方式

/loop 让 Qoder CLI CN 重复执行一段提示或斜杠命令:指定间隔时按固定间隔通过定时任务系统执行;不指定间隔时进入动态节奏模式,由 Agent 自主决定每次唤醒的时机。本页说明其参数格式、间隔换算与取消方式。关于循环执行的使用指南,见 重复执行任务

用法

/loop [间隔] <提示>
  • [间隔](可选):执行间隔。指定时为固定间隔模式;省略时进入动态节奏模式,由 Agent 根据任务情况自主决定下次执行时机(每次在 60 秒至 1 小时之间)。
  • <提示>(必填):要重复执行的提示文本或斜杠命令。为空时显示用法提示。

间隔单位

固定间隔模式下,间隔由数字加单位后缀组成:
后缀单位说明
s向上取整到最近的分钟(最小粒度 1 分钟)。
m分钟每 N 分钟。
h小时每 N 小时。
d每 N 天(本地时间午夜触发)。
最小粒度为 1 分钟。以秒为单位的间隔会被向上取整为 ceil(N/60) 分钟,取整时会提示你。

解析规则

/loop 按以下优先级解析输入:
  1. 前导 token:若第一个词匹配 ^\d+[smhd]$(如 5m2h),则作为间隔,其余为提示,进入固定间隔模式。
  2. 尾随 every 子句:否则若输入以 every <N><单位>every <N> <单位词> 结尾(如 every 20mevery 5 minutes),提取为间隔并从提示中去除,进入固定间隔模式。仅当 every 后接时间表达式时才匹配——check every PR 不含间隔。
  3. 动态节奏:否则进入动态节奏模式,整段输入作为提示,执行节奏由 Agent 自主决定;若 Agent 不再安排下次唤醒,循环结束。

示例

/loop 5m /babysit-prs          # 固定:每 5 分钟执行 /babysit-prs
/loop 30m check the deploy     # 固定:每 30 分钟检查部署
/loop 1h /standup 1            # 固定:每小时执行 /standup 1
/loop monitor CI pipeline      # 动态:Agent 自主决定节奏
/loop run tests every 20m      # 固定:每 20 分钟运行测试

间隔到 cron 的换算

固定间隔模式下,间隔按以下规则换算为 cron 计划:
间隔模式cron 表达式说明
Nm(N ≤ 59)*/N * * * *每 N 分钟
Nm(N ≥ 60)0 */H * * *换算为小时(H = N/60,需整除 24)
Nh(N ≤ 23)0 */N * * *每 N 小时
Nd0 0 */N * *每 N 天午夜
Ns视为 ceil(N/60)mcron 最小粒度为 1 分钟
若间隔不能整除其单位(如 7m 会产生不均匀间隔、90m 无法用 cron 表达),会选择最接近的整齐间隔并在创建任务前告知取整结果。

取消与失效

  • 固定间隔的循环任务在创建后 7 天自动过期。
  • 可在过期前手动删除对应的定时任务(用自然语言请求 Agent 删除,并提供任务 ID)。
  • 动态节奏模式下,Agent 不再安排下次唤醒即结束循环。
  • 创建循环任务后会立即执行一次当前提示,不等待第一次 cron 触发。

下一步