Ralph常见问题解答：新手入门必知的20个问题
项目地址: https://gitcode.com/GitHub_Trending/ralph1/ralph Ralph是一个自主AI代理循环，能够重复运行AI编码工具（Amp或Claude Code），直到所有PRD项目完成为止。每个迭代都是一个全新的实例，具有干净的上下文。对于刚接触Ralph的新手来说，可能会有许多疑问，下面为你解答20个常见问题。
一、Ralph基础认知
1. 什么是Ralph？
Ralph是一个自主AI代理循环，它能运行AI编码工具（Amp或Claude Code），不断迭代直至所有PRD项目完成。其内存通过git历史、progress.txt和prd.json持久化。
2. Ralph的主要功能是什么？
Ralph的核心功能是根据PRD（产品需求文档）自动完成各项任务，它会将PRD分解为小的任务故事，然后逐个实现，直至所有任务完成。
3. Ralph的工作流程是怎样的？
Ralph的工作流程可以通过项目中的流程图来清晰了解。
从图中可以看到，首先你编写PRD，然后将其转换为prd.json，接着运行ralph.sh启动自主循环，之后Amp会选择任务故事并进行实现，实现后提交更改，更新prd.json，记录进度，直到所有故事完成。
二、安装与配置
4. 如何获取Ralph项目？
你可以通过克隆仓库来获取Ralph项目，仓库地址是 https://gitcode.com/GitHub_Trending/ralph1/ralph。
5. 安装Ralph需要哪些环境？
由于Ralph涉及到运行bash脚本和AI编码工具，需要确保你的系统支持bash环境，并且已经安装了相关的依赖，如git等。
6. 如何配置Ralph？
目前从项目文件来看，主要的配置可能涉及到prd.json文件，你可以参考prd.json.example来创建和配置自己的prd.json。
三、运行与使用
7. 如何启动Ralph？
你可以通过运行ralph.sh脚本来启动Ralph，基本命令是./ralph.sh [max_iterations]，其中max_iterations是可选的最大迭代次数。
8. 可以指定使用的AI工具吗？
可以的，你可以通过./ralph.sh --tool claude [max_iterations]命令指定使用Claude Code工具，默认可能使用Amp工具。
9. ralph.sh脚本的作用是什么？
ralph.sh是一个bash循环脚本，它用于生成全新的AI实例，支持--tool amp或--tool claude参数来选择使用的AI工具。
10. 运行Ralph过程中会产生哪些文件？
运行过程中会产生progress.txt用于记录进度，同时git历史和prd.json也会用于持久化内存。
四、任务与PRD
11. 什么是PRD？
PRD指的是产品需求文档，它定义了你想要构建的内容，是Ralph工作的依据。
12. 如何编写PRD？
虽然项目中没有明确的PRD编写指南文件，但你可以根据项目的需求和目标，清晰、详细地定义要完成的功能和任务。
13. PRD如何转换为prd.json？
项目中有将PRD转换为prd.json的步骤，它会将PRD分解为小的任务故事。
14. prd.json的作用是什么？
prd.json用于记录分解后的任务故事，Ralph会根据其中的内容来完成各项任务，并且在任务完成后会更新其中的“passed”字段为true。
五、迭代与进度
15. Ralph的迭代是怎样的？
每个迭代都是一个全新的实例，具有干净的上下文，这样可以避免之前迭代的干扰，确保任务的独立进行。
16. 如何查看Ralph的工作进度？
你可以查看progress.txt文件，它会记录Ralph的工作进度。
17. 如果任务未完成，Ralph会如何处理？
Ralph会不断循环运行，直到所有PRD项目完成为止，所以如果任务未完成，它会继续进行下一次迭代。
六、高级问题
18. Ralph支持哪些AI工具？
目前Ralph支持Amp和Claude Code这两种AI编码工具。
19. 如何在运行之间手动更新prd.json？
如果你需要在运行之间手动更新prd.json，根据技能文档skills/ralph/SKILL.md中的说明，在更新之前应该先进行存档。
20. Ralph的记忆是如何持久化的？
Ralph的记忆通过git历史、progress.txt和prd.json来持久化，这样可以在不同的运行和迭代之间保留重要信息。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
