claude-ralph

claude-ralph 是一个自主编程代理循环，旨在将产品需求文档 (PRD) 转换为完整实现的功能分支。通过将经过验证的 Ralph 模式移植到 Claude Code CLI，此工具让开发人员能将重复的实现任务交给 AI 进行迭代开发。该代理程序会处理基于 JSON 的 PRD，选取高优先级的用户故事，并为每个任务启动干净、独立的 Claude Code 实例来处理实现、测试与验证。它通过 git、进度日志和结构化任务文件在迭代间维护上下文与状态，确保开发流程保持井然有序、高质量且可靠。此系统包含内置的质量门（如 Linting、类型检查与自动化测试），非常适合构建复杂功能。它也通过 Playwright 支持前端功能的用户界面验证。用户可定义 Markdown 格式的需求，将其转换为 JSON，并让自动化循环处理从分支创建到代码库更新的所有事务。此工具非常适合希望通过现有的 Claude Max 订阅来加速发布速度、进行深度端到端自主编码的个人开发者或团队。

• 完全自动化循环执行：自动循环执行 prd.json 中的任务，直到所有故事完成为止。

• Claude Code CLI 集成：通过官方 Claude Code 接口使用您现有的 Claude Pro 或 Max 订阅。

• 迭代实现：将大型功能拆解为小型、原子化的用户故事，便于 AI 管理与验证。

• 质量保证：在每次提交前强制执行包括类型检查、Linting 和单元测试在内的质量门。

• UI 验证支持：针对使用 Playwright 进行浏览器测试提供特定支持。

• 状态持久化：使用 progress.txt 和 git 历史记录来追踪跨工作阶段的学习内容、模式与代码库知识。

• 安装：将存储库复制到您的 scripts/ 目录，并依照全局或项目特定技能的使用说明进行设置。

• 使用方式：首先使用 PRD 技能产生需求，然后将其转换为 prd.json 以供自动化执行器使用。

• 先决条件：需要安装 Claude Code CLI、jq、git，以及选用的 Playwright 用于前端测试。

• 工作流程：遵循产生 PRD、精简用户故事并启动自动化 ralph.sh 循环的迭代流程。

• 最佳实践：确保故事的大小适合单次编程周期，并包含明确的二元验收标准以获得最佳效果。