当用户要求启动 Ralph loop 时…

用户要求启动 Ralph loop、迭代循环，或希望同一提示词每轮回传以反复自主迭代任务直至完成时使用。

适用场景

解决思路

1. 收集用户的任务提示词以及可选参数：`max_iterations`（数字，默认 `0` 表示无限）和 `completion_promise`（文本；未设置时用 `null`）。
2. 如果 `.cursor/ralph/` 不存在则创建该目录，然后在 `.cursor/ralph/scratchpad.md` 写入状态文件，格式必须为：YAML frontmatter 包含 `iteration: 1`、`max_iterations: <N or 0>`、`completion_promise: "<TEXT>" or null`，正文放用户的任务提示词。
3. 向用户确认 Ralph loop 已激活，然后立即开始处理任务。
4. stop hook 会自动拦截每次回合结束，并把同一提示词作为 followup message 回传；你会看到它以 `[Ralph loop iteration N.]` 为前缀。
5. 如果设置了 completion promise，只有在陈述完全且真实成立时，才允许输出 `<promise>TEXT</promise>`。
6. 不要输出虚假的 promise 来逃离循环。
7. 始终建议设置 `max_iterations` 作为安全网。
8. 如果 `completion_promise` 值包含特殊字符，在 YAML frontmatter 中要用引号把它括起来。
9. 输出确认循环已激活：说明 prompt、iteration limit、promise（若设置），然后立即开始处理任务。

适用边界 · 注意事项

• 用户没有明确要求启动 Ralph loop、迭代循环，或不需要用同一提示词反复自主迭代时。
• 当前环境没有或不支持自动拦截回合结束并回传同一提示词的 stop hook（例如非 Cursor 环境）时；此时无法形成 Ralph loop。
• 任务不适合反复自主迭代直至完成，或无法验证完成条件且不希望用 `max_iterations` 兜底时。