Skip to main content
参考

Loop 命令参考

/loop 循环执行的参数格式、间隔单位、默认值与取消方式

/loop 让 Qoder CLI 按固定间隔重复执行一段提示或斜杠命令,底层通过定时任务系统实现。本页说明其参数格式、间隔换算与取消方式。关于循环执行的使用指南,见 重复执行任务

用法

/loop [间隔] <提示>
  • [间隔](可选):执行间隔。省略时默认 10m(10 分钟)。
  • <提示>(必填):要重复执行的提示文本或斜杠命令。为空时显示用法提示。

间隔单位

间隔由数字加单位后缀组成:
后缀单位说明
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. 默认:否则间隔为 10m,整段输入作为提示。

示例

/loop 5m /babysit-prs          # 每 5 分钟执行 /babysit-prs
/loop 30m check the deploy     # 每 30 分钟检查部署
/loop 1h /standup 1            # 每小时执行 /standup 1
/loop check the deploy         # 默认每 10 分钟
/loop run tests every 20m      # 每 20 分钟运行测试

间隔到 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)。
  • 创建循环任务后会立即执行一次当前提示,不等待第一次 cron 触发。

下一步