Ralph 用于自主递归执行任务，兼容任意 agent harness（如 amp、opencode、claude）。用户先提供提示词，例如“实现 prd.json 中的下一个任务并确保所有 QA 检查通过”；agent 每次只执行一个任务（实现、测试、提交），随后创建新会话，携带已完成摘要与同一提示词继续，直至全部完成。
它分两个阶段：Setup（通过“set up ralph”“configure ralph”触发）用于配置任务来源；Loop（通过“run ralph”“start the loop”触发）用于递归执行。支持的任务来源包括：/tasks/prd-[feature-name].md 形式的 PRD Markdown 文件（会提取 US-001 等用户故事并生成带顺序依赖的任务）、含显式依赖的 prd.json 文件，以及 amp 兼容的 task_list（父子任务关系）。
运行时会读取 ralph.json 配置，找到下一个就绪任务，执行并更新任务状态与 scripts/ralph/progress.json 进度文件，提交变更，生成会话摘要并通过 harness 创建新会话。harness 类型有 generic（使用 /new 命令，适用于 opencode、claude 等）、amp（使用内置 handoff）和 custom。质量检查（typecheck、test、lint 等命令）必须全部通过才继续下一任务；无就绪任务时校验完成、归档进度并报告全部完成。
配置与用法以资料中的 ralph.json、progress.json 结构和示例为准，实际能否运行取决于对应 harness 和命令是否可用。