Ralph项目入门10分钟快速搭建你的第一个AI自动化编码工作流【免费下载链接】ralphRalph is an autonomous AI agent loop that runs Amp repeatedly until all PRD items are complete.项目地址: https://gitcode.com/gh_mirrors/ralph1/ralphRalph是一个革命性的AI自动化编码工具它能将产品需求文档PRD自动转换为可执行代码通过AI代理循环持续工作直到所有任务完成。这个强大的AI自动化工作流工具能显著提升开发效率让开发者专注于核心业务逻辑而不是重复性编码任务。什么是RalphRalph是一个自主AI代理循环系统它能够运行AI编码工具如Amp或Claude Code反复执行直到所有PRD项目全部完成。每个迭代都是一个新的实例具有干净的上下文而记忆通过git历史、progress.txt和prd.json持久化保存。Ralph的核心优势自动化编码将PRD自动转换为可执行代码智能迭代每次迭代都是全新的AI实例避免上下文污染持续学习通过progress.txt记录学习成果质量控制每次提交前运行类型检查和测试开源免费完全开源无需付费订阅快速安装指南⚡前置要求在开始之前请确保您的系统已安装以下工具AI编码工具二选一Amp CLI默认推荐Claude Codenpm install -g anthropic-ai/claude-code必需工具jq命令行工具macOS用户brew install jqGit仓库用于项目管理安装步骤从GitCode克隆Ralph仓库git clone https://gitcode.com/gh_mirrors/ralph1/ralph.git cd ralph选项1复制到您的项目推荐将Ralph文件复制到您的项目中# 从您的项目根目录 mkdir -p scripts/ralph cp /path/to/ralph/ralph.sh scripts/ralph/ # 复制适合您AI工具的提示模板 cp /path/to/ralph/prompt.md scripts/ralph/prompt.md # 用于Amp # 或者 cp /path/to/ralph/CLAUDE.md scripts/ralph/CLAUDE.md # 用于Claude Code chmod x scripts/ralph/ralph.sh选项2全局安装技能Amp用户将技能复制到您的Amp或Claude配置中以便在所有项目中使用# 对于Amp cp -r skills/prd ~/.config/amp/skills/ cp -r skills/ralph ~/.config/amp/skills/Ralph工作流程详解1. 创建PRD文档使用PRD技能生成详细的需求文档加载prd技能并为[您的功能描述]创建PRD回答澄清问题后技能会将输出保存到tasks/prd-[功能名称].md。2. 将PRD转换为Ralph格式使用Ralph技能将Markdown PRD转换为JSON格式加载ralph技能并将tasks/prd-[功能名称].md转换为prd.json这将创建prd.json其中包含为自主执行而构建的用户故事。3. 运行Ralph# 使用Amp默认 ./scripts/ralph/ralph.sh [最大迭代次数] # 使用Claude Code ./scripts/ralph/ralph.sh --tool claude [最大迭代次数]默认最大迭代次数为10次。使用--tool amp或--tool claude选择您的AI编码工具。上图展示了Ralph与Amp协作的完整工作流程从PRD定义到任务完成的自动化循环过程。Ralph如何工作Ralph的工作机制非常智能创建功能分支从PRD的branchName选择最高优先级的未完成故事passes: false实现单个故事运行质量检查类型检查、测试如果检查通过则提交更新prd.json将故事标记为passes: true将学习成果追加到progress.txt重复直到所有故事通过或达到最大迭代次数关键概念每次迭代 全新上下文每次迭代都会启动一个新的AI实例Amp或Claude Code具有干净的上下文。迭代之间唯一的记忆是Git历史来自先前迭代的提交progress.txt学习和上下文prd.json哪些故事已完成小型任务每个PRD项目都应足够小以便在一个上下文窗口中完成。如果任务太大LLM在完成之前会用尽上下文并产生糟糕的代码。核心文件结构文件用途ralph.sh启动新AI实例的bash循环支持--tool amp或--tool claudeprompt.mdAmp的提示模板CLAUDE.mdClaude Code的提示模板prd.json带有passes状态的用户故事任务列表prd.json.example示例PRD格式供参考progress.txt未来迭代的仅追加学习记录skills/prd/生成PRD的技能适用于Amp和Claude Codeskills/ralph/将PRD转换为JSON的技能适用于Amp和Claude Codeflowchart/Ralph工作原理的交互式可视化最佳实践正确的故事大小合适大小的故事添加数据库列和迁移向现有页面添加UI组件使用新逻辑更新服务器操作向列表添加过滤器下拉菜单太大应拆分构建整个仪表板添加身份验证重构APIAGENTS.md更新至关重要每次迭代后Ralph都会使用学习成果更新相关的AGENTS.md文件。这很关键因为AI编码工具会自动读取这些文件因此未来的迭代以及未来的人类开发人员将从发现的模式、陷阱和约定中受益。反馈循环Ralph只有在存在反馈循环时才能正常工作类型检查捕获类型错误测试验证行为CI必须保持绿色损坏的代码会在迭代中累积浏览器验证UI故事前端故事必须在验收标准中包含使用dev-browser技能在浏览器中验证。Ralph将使用dev-browser技能导航到页面与UI交互并确认更改有效。调试技巧检查当前状态# 查看哪些故事已完成 cat prd.json | jq .userStories[] | {id, title, passes} # 查看先前迭代的学习成果 cat progress.txt # 检查git历史 git log --oneline -10自定义提示模板将prompt.md用于Amp或CLAUDE.md用于Claude Code复制到您的项目后为您的项目自定义它添加项目特定的质量检查命令包含代码库约定为您的技术栈添加常见陷阱开始您的第一个AI自动化项目现在您已经了解了Ralph的基本概念和工作原理是时候开始您的第一个AI自动化编码项目了设置环境安装Amp或Claude Code创建PRD使用PRD技能定义您的功能需求转换格式将PRD转换为Ralph的JSON格式运行循环启动Ralph并观察AI如何自动化完成编码任务监控进度定期检查progress.txt和git提交历史Ralph代表了AI辅助开发的未来方向它将重复性编码任务自动化让开发者能够专注于更有创造性的工作。无论您是个人开发者还是团队领导者Ralph都能显著提升您的开发效率和代码质量。立即开始您的AI自动化编码之旅体验Ralph带来的革命性开发效率提升【免费下载链接】ralphRalph is an autonomous AI agent loop that runs Amp repeatedly until all PRD items are complete.项目地址: https://gitcode.com/gh_mirrors/ralph1/ralph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考