用途：在任意目录中初始化并配置 Geoffrey Huntley 提出的 Ralph Wiggum 自主 AI 编码循环（Ralph）。核心形式是一个 Bash 循环：while :; do cat PROMPT.md | claude ; done，循环把提示词文件喂给 Claude，代理完成一个任务、更新实现计划、提交改动后退出，循环随即以全新上下文重启。
主要能力：提供三类工作流入口——初始化新循环（setup-new-loop.md，在目录中建立 Ralph 结构）、理解 Ralph 概念（understand-ralph.md）、定制循环（customize-loop.md，修改提示词或配置）、排查循环问题（troubleshoot-loop.md，调试与优化性能）。领域知识涵盖核心概念、项目结构、提示词设计、验证策略与运营经验，分别位于 references/ 下的 ralph-fundamentals.md、project-structure.md、prompt-design.md、validation-strategy.md、operational-learnings.md。
使用方式：工作流分为规划阶段（对比规格与代码做差距分析，输出按优先级排序的 TODO，不实现不提交）、构建阶段（从计划取任务、实现、跑测试作为背压、提交）、观察阶段（人坐在循环之外，负责工程化环境）。用户按提示先声明意图，再加载对应工作流与参考文件。
限制与注意事项：资料未提供安装命令、依赖版本、具体提示词全文、支持的模型范围与价格信息。运行需 gh CLI 已认证以自动创建私有 GitHub 仓库并在每次提交后推送，可用 RALPH_BACKUP=false 关闭。PROMPT_build.md 含禁止对项目目录执行 rm -rf 等危险操作的安全规则，测试须在隔离临时目录中运行。上下文窗口 200K、可用约 176K token，建议每个循环只放一个紧凑任务。