ralph
一个能自动执行PRD（产品需求文档）的AI代理循环工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ralph。 它的用途是：一个能自动执行PRD（产品需求文档）的AI代理循环工具。 完整的 Skill 内容见：https://321skill.com/skills/ralph/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘加载prd技能，为[用户登录功能]创建一个PRD’，AI会引导你完成需求澄清并生成文档。接着
对AI说：‘加载ralph技能，将tasks/prd-用户登录.md转换为prd.json’，即可生成Ralph可执行的格式。最后在终端运行`./scripts/ralph/ralph.sh`，Ralph就会开始自动循环，逐一实现PRD中的所有用户故事。
介绍
Ralph是一个自主的AI代理循环，它解决了开发者在面对复杂、多步骤产品需求时，需要手动反复与AI编码工具交互的痛点。它通过一个bash脚本循环，自动调用Amp或Claude Code等AI编码工具，将PRD拆解为独立用户故事，并逐一实现、测试和提交，直至所有需求完成。
使用Ralph时，开发者首先需要创建一个详细的PRD文档，然后将其转换为Ralph能理解的JSON格式。运行Ralph脚本后，它会自动创建分支，挑选最高优先级且未完成的故事，交由AI工具实现，运行质量检查（如类型检查、测试），成功后提交代码并更新进度文件，如此循环直到所有任务完成或达到最大迭代次数。
这个工具非常适合独立开发者、小团队或产品经理，他们希望利用AI将清晰的产品需求自动转化为可工作的代码，从而将精力集中在需求定义和最终验收上，减少中间繁琐的编码指令环节。
与同类单次交互的AI编码助手不同，Ralph的核心在于其“循环”和“自动化”特性。它不是一次性的代码生成，而是一个具备记忆（通过git、progress.txt）和持续迭代能力的系统，能够处理超出单次上下文长度的复杂项目，并确保最终交付物符合PRD的所有条目。
核心特点
Ralph的核心区别在于它是一个具备状态记忆和自动迭代的“循环代理”，而非单次对话工具。它通过git历史、progress.txt和prd.json持久化进度，能自动拆分PRD、顺序执行多个用户故事并处理超出单次上下文的大型任务，实现了从需求文档到可提交代码的端到端自动化工作流。
注意事项
不适合需求模糊、频繁变更或需要大量人工创造性设计的探索性项目。
常见问题
Ralph支持哪些AI编码工具？
目前主要支持Amp CLI和Claude Code，通过`--tool`参数指定。
Ralph如何保证代码质量？
每个故事实现后，Ralph会自动运行预设的质量检查（如类型检查、测试），只有通过检查才会提交代码并标记为完成。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ralph/raw/index.md 读取 ralph 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ralph/raw/index.md（查看排版版本）