ralph
一个用于驱动AI编码代理循环运行的轻量级脚本工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ralph。 它的用途是：一个用于驱动AI编码代理循环运行的轻量级脚本工具。 完整的 Skill 内容见：https://321skill.com/skills/ralph-santanderai/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你有一个需要AI持续优化的代码重构任务时，可以对 ralph 说：`./ralph-loop.sh 30 refactor_prompt.md`。它会循环启动30次全新的AI编码代理会话，每次都会读取 `refactor_prompt.md` 中的指令，在现有代码库基础上进行渐进式改进，并将所有修改和日志记录在项目中。
介绍
ralph 是一个由 Santander AI Lab 开源的轻量级脚本工具，它解决了在无人值守情况下，让AI编码代理（如 Codex, Claude Code, Gemini CLI, Devin CLI）持续、循环地处理同一任务的问题。它通过启动一个全新的代理会话来执行每一次迭代，确保每次运行都从一个干净的状态开始，避免因会话历史导致的性能下降或偏差。
使用方式非常简单，只需在命令行中指定最大迭代次数和包含任务提示词的文件路径即可。例如，ralph-loop.sh 50 task_prompt.txt 会让AI代理根据 task_prompt.txt 中的指令，在项目目录下循环工作最多50次。每次迭代都会生成独立的日志，便于追踪进度。
这个工具非常适合那些需要AI代理进行长时间、渐进式代码开发或问题解决的项目负责人、独立开发者或研究团队。它特别适用于“请持续改进直到完成”这类开放式任务，将工作的连续性完全交由项目文件本身（如代码、计划文档）来承载。
需要注意的是，由于每次迭代都是全新的会话，AI代理无法记住前一次迭代中的对话历史。因此，你的提示词和项目文件必须清晰地定义当前状态和下一步目标。同时，你需要确保已安装并配置好至少一个它所支持的AI编码CLI。
核心特点
与直接使用AI编码CLI不同，ralph 的核心在于其“循环与重置”机制。它通过每次迭代都启动一个全新的代理会话，并配合外部文件（如 `stop.md`）实现可控的长时间运行，这避免了单次会话可能存在的记忆混乱或性能衰减问题，特别适合需要AI进行“马拉松式”编码或问题解决的任务。
注意事项
不适合需要AI代理在单次会话中记住大量复杂对话历史的交互式、探索性任务。
常见问题
ralph 支持哪些AI编码代理？
支持 Codex CLI, Claude Code, Gemini CLI 和 Devin CLI，你需要在系统PATH中安装至少一个。
如何停止正在循环运行的 ralph？
在运行目录下创建一个名为 `stop.md` 的空文件，ralph 会在下一次迭代前检测到并优雅退出。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ralph-santanderai/raw/index.md 读取 ralph 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ralph-santanderai/raw/index.md（查看排版版本）