Repolode
提交项目
ClaytonFarr

ClaytonFarr/ralph-playbook

基于 Geoff Huntley 的 Ralph 方法论，讲解如何运行自主 AI 编码循环的实践指南与提示词模板。

在 GitHub 查看官网
Star
1,037
Fork
266
未关闭 Issue
3
最近提交
8个月前

这是什么？

Ralph Playbook 是一份关于 Ralph 方法的实践指南，Ralph 是一种让 AI 编码代理在自主循环中工作的模式。每一轮迭代都从全新上下文开始，读取磁盘上的提示词文件和共享的实现计划，完成一个任务后提交并退出，无需人工编排即可持续推进。

指南将工作流分为三个阶段：以按主题拆分的 spec 文件定义需求；通过规划循环对比 spec 与代码进行差距分析；再通过构建循环，依据测试等反馈机制实现任务。仓库提供可直接改造的 PROMPT_plan 与 PROMPT_build 模板、用于记录构建和测试命令的 AGENTS.md 约定、示例 loop.sh 脚本，以及在跳过权限模式下运行代理时的沙箱隔离建议。

此外，文档还介绍了若干扩展思路，例如从验收标准推导测试需求、用 LLM 作为评审处理主观质量，以及将既有代码库逆向整理为 spec。内容同时提供格式化网页版与 Markdown 版本。

核心功能

  • 01定义从需求、规划到构建的三阶段工作流
  • 02提供规划模式与构建模式的提示词模板
  • 03包含支持模式切换和最大迭代次数的示例 loop.sh
  • 04说明 AGENTS.md 与实现计划如何在迭代间共享状态
  • 05给出以沙箱隔离运行免授权代理的安全建议

适用场景

  • 搭建基于书面 spec 自动实现项目功能的编码循环
  • 为跨多个小任务工作的 AI 代理组织提示词和计划文件
  • 在授予代理广泛权限前参考安全执行方式

快速上手

  1. 1

    阅读 README 中的 Ralph Playbook 指南

  2. 2

    设置用于自主运行的基础循环脚本

    while :; do cat PROMPT.md | claude ; done

使用前须知

  • 该仓库是方法论指南，而不是可安装的软件包。
  • 示例循环使用 Claude 并需要跳过权限确认，因此必须在隔离的沙箱环境中运行以保证安全。
  • 效果取决于对提示词、规范和反压机制的细致调整，结果可能具有不确定性。

标签

#ai-agents#coding-agent#prompt-engineering#llm#automation#claude#developer-workflow

常见问题

ralph-playbook 是什么？
基于 Geoff Huntley 的 Ralph 方法论，讲解如何运行自主 AI 编码循环的实践指南与提示词模板。 Ralph Playbook 是一份关于 Ralph 方法的实践指南，Ralph 是一种让 AI 编码代理在自主循环中工作的模式。每一轮迭代都从全新上下文开始，读取磁盘上的提示词文件和共享的实现计划，完成一个任务后提交并退出，无需人工编排即可持续推进。
ralph-playbook 可以免费使用吗？用的什么许可证？
ralph-playbook 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
ralph-playbook 还在维护吗？
超过半年未提交。ralph-playbook 最近一次提交是在 2026年3月6日。
ralph-playbook 适合用来做什么？
搭建基于书面 spec 自动实现项目功能的编码循环 为跨多个小任务工作的 AI 代理组织提示词和计划文件 在授予代理广泛权限前参考安全执行方式
ralph-playbook 怎么安装和运行？
阅读 README 中的 Ralph Playbook 指南 设置用于自主运行的基础循环脚本: while :; do cat PROMPT.md | claude ; done
在哪里获取 ralph-playbook？
源代码和安装说明在 GitHub 上：https://github.com/ClaytonFarr/ralph-playbook

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目