loop

name: loop description: 循环执行器。按设定时间间隔（如 /loop 5m /指令）周期性自动运行指定 Prompt 或外挂指令。 description_zh: 循环执行器 — 按时间间隔周期性自动运行指定指令 when_to_use: When the user wants to set up a recurring task, poll for status, or run something repeatedly on an interval (e.g. "check the deploy every 5 minutes", "keep running /babysit-prs"). Do NOT invoke for one-off tasks.

🔄 Loop — Recurring Prompt Scheduler (循环执行组合包)

You are executing the Loop Workflow — a parser + scheduler that takes a user's free-form input, extracts the interval and prompt, converts it to a cron expression, schedules the recurring job, and immediately executes the first run.

[!CAUTION] PARSE BEFORE SCHEDULE: You MUST correctly parse the interval and prompt from the user's input using the priority rules below. Mis-parsing can result in a wrong cadence or an empty prompt being scheduled. Verify your parse result before calling schedule_cron_job.

Process Flow Overview (流程总览)

graph TD
    A["📝 Step 1: Parse Input<br/>Extract interval + prompt"] --> B{"Prompt<br/>empty?"}
    B -->|"Yes"| C["⛔ Show Usage<br/>/loop [interval] prompt<br/>STOP"]
    B -->|"No"| D["⏰ Step 2: Convert Interval<br/>to Cron Expression"]
    D --> E{"Clean<br/>division?"}
    E -->|"No"| F["🔄 Round to nearest<br/>Tell user what changed"]
    E -->|"Yes"| G["📅 Step 3: Schedule Job<br/>schedule_cron_job"]
    F --> G
    G --> H["✅ Step 4: Confirm<br/>Report schedule details"]
    H --> I["🚀 Step 5: Immediate Execution<br/>Run prompt NOW"]
    I --> J["🏁 DONE"]

    style A fill:#3498db,color:#fff
    style C fill:#e74c3c,color:#fff
    style G fill:#2ecc71,color:#fff
    style I fill:#9b59b6,color:#fff
    style J fill:#27ae60,color:#fff

Step 1: 📝 Parse Input (输入解析)

Parse the user's input into [interval] <prompt…> using these rules in priority order:

Rule Priority Table

[!IMPORTANT] Rule 2 guard: Only match every when what follows is a valid time expression. check every PR has no interval — apply Rule 3 instead.

Parse Examples

If the resulting prompt is empty, show usage /loop [interval] <prompt> and stop — do NOT call schedule_cron_job.

Step 2: ⏰ Interval → Cron Conversion (间隔转换)

Supported interval suffixes: s (seconds), m (minutes), h (hours), d (days).

Conversion Table

Rounding Rule

If the interval doesn't cleanly divide its unit (e.g., 7m → */7 gives uneven gaps at :56→:00; 90m → 1.5h which cron can't express), pick the nearest clean interval and inform the user what you rounded to before scheduling:

⚠️ Interval "90m" (1.5h) cannot be exactly represented in cron.
   Rounding to 2h (cron: "0 */2 * * *"). OK to proceed?

Step 3: 📅 Schedule the Job (调度任务)

Call schedule_cron_job with:

• cron: The expression from the conversion table above
• prompt: The parsed prompt, verbatim (slash commands are passed through unchanged)
• recurring: true

Step 4: ✅ Confirm to User (确认报告)

Briefly confirm all 5 items:

✅ Scheduled!
- **Task**: <parsed prompt>
- **Cron**: <cron expression>
- **Cadence**: Every <human-readable interval>
- **Auto-expire**: Recurring tasks auto-expire after 30 days
- **Cancel**: Run `delete_cron_job <job_id>` to stop sooner

Step 5: 🚀 Immediate Execution (立即首次执行)

Execute the parsed prompt NOW — do not wait for the first cron fire.

• If the prompt is a slash command (e.g., /babysit-prs) → invoke it via the Skill tool.
• If the prompt is a plain instruction (e.g., check the deploy) → act on it directly.

🔥 Hard Rules (铁律)

1. Parse Before Schedule: Always parse and validate the interval + prompt before calling schedule_cron_job. Never schedule an empty prompt.
2. Priority Order Is Strict: Apply parsing rules in exact priority order (1 → 2 → 3). Do not skip or reorder.
3. "Every" Guard: Only match every in Rule 2 when followed by a valid time expression. every PR is NOT a time expression.
4. Rounding Transparency: If the interval is rounded, you MUST inform the user what it was rounded to before scheduling.
5. Immediate First Run: Always execute the prompt once immediately after scheduling. The user should not have to wait for the first cron trigger.
6. Verbatim Prompt Pass-Through: Pass the parsed prompt exactly as-is to schedule_cron_job. Do not modify, interpret, or expand it.
7. Confirm All 5 Items: Every confirmation must include: task, cron expression, human-readable cadence, auto-expire note, and cancel command with job ID.