prp-ralph-loop

prp-ralph-loop 是一个自主执行代理技能，旨在弥合规划与生产级代码之间的差距。该技能基于“Ralph Wiggum”循环技术，通过运行迭代开发周期直到满足所有定义的标准，从而促进持续的自我修正。它作为执行产品需求提示 (PRP) 的 AI 代理的协调者，确保代码修改不仅被实现，还能通过构建、代码检查 (linting) 和测试闸道进行严格验证。

此技能通过检测 .claude/prp-ralph.state.md 的存在来识别活动的工作会话，该状态文件用于追踪迭代、任务进度和代码库的历史学习。通过维护这种状态，代理确保了迭代间的连续性，使其能够调试之前的失败、遵循早期循环中发现的模式，并系统地核对需求。它是专为使用 Claude Code 来自动化复杂功能实现、错误修复和代码库重构的开发人员与工程团队设计的。

• 执行迭代代码实现周期，直到检测到完成信号。

• 强制执行严格的验证要求，包括类型检查、代码检查、测试套件和构建验证。

• 通过 .claude/prp-ralph.state.md 文件保持持久状态，实现上下文感知恢复和进度日志记录。

• 与本地 Shell 挂钩 (hooks) 集成，以管理会话生命周期和持续提示。

• 通过在每次修复后强制重新验证，支持系统化的错误处理。

• 需要一个已初始化的项目，其中包含 PRP 计划文件或要执行的具体任务。

• 最适合具有明确、基于目标的验证闸道的任务（例如，测试覆盖率或编译器成功）。

• 在初始执行时务必指定 --max-iterations 以防止无限循环情况。

• 确保 stop hook (.claude/hooks/prp-ralph-stop.sh) 已在 settings.local.json 中正确配置，以启用自动循环控制。

• 当所有验证（TypeScript、Python、测试、构建）均退出且代码为 0，并且所有计划要求均满足时，循环才会触发最终完成信号 <promise>COMPLETE</promise>。