Ralph 是一个轻量、自主、可复现的 AI 编程助手工作流，它不是“一次提问、一次回答”的传统 Copilot，而是一个能持续迭代、自我校验、自动推进项目落地的「AI 代理循环」。它把产品需求文档（PRD）当作待办清单，调用 Amp 或 Claude Code 等 AI 编程工具反复执行「理解需求→生成代码→提交验证→检查完成度」的闭环，直到所有功能点被真正实现并提交到 Git 历史中。它解决了开发者常面临的痛点：AI 输出零散难整合、需求进度难追踪、人工反复粘贴调试耗时低效。
核心功能
- 全自动需求驱动开发：只需一份结构化的
prd.json，Ralph 就能逐条解析需求项，自动生成对应功能代码，无需手动拆解任务或编写提示词 - 上下文隔离 + 持久化记忆：每次 AI 调用都是全新干净的会话（避免上下文污染），而长期记忆则通过 Git 提交历史、
progress.txt进度文件和prd.json的版本演进自动保存 - 双引擎灵活支持：原生兼容 Amp CLI（默认）与 Anthropic 官方
@anthropic-ai/claude-code，用户可根据偏好、成本或效果自由切换 - 开箱即用的工程化设计：内置 prompt 模板、进度追踪机制、Git 集成钩子，不依赖复杂框架或云服务，纯本地终端运行，隐私可控
- 可审计、可回溯的开发过程：每轮生成都产生独立 commit，附带清晰 message（如 “feat(prd): implement user login validation”），团队协作或代码审查时一目了然
- 极简集成方式：既可作为脚本嵌入现有项目（
scripts/ralph/），也可全局安装为 Amp/Claude 的通用技能，在所有项目中复用
适合哪些人用
Ralph 特别适合以下几类中文开发者与技术团队：独立开发者——想快速将产品想法落地，又不愿陷入重复调试和文档同步；初创团队技术负责人——需在资源有限时高效交付 MVP，并留下清晰可追溯的代码演进路径；AI 编程实践者——希望超越“聊天式编程”，探索更系统、更可靠、更工程化的 AI 协作范式；教育与学习者——通过观察 Ralph 如何将 PRD 转为真实 commit，深入理解需求拆解、测试驱动与渐进式开发的本质。
快速上手
只需三步即可启动 Ralph：
- 准备环境：安装任一 AI 工具（推荐 Amp CLI 或 Claude Code），再安装
jq（macOS 执行brew install jq） - 初始化项目：在你的 Git 仓库根目录下创建
scripts/ralph/，复制ralph.sh和对应 prompt 模板（prompt.md或CLAUDE.md），并赋予执行权限：chmod +x scripts/ralph/ralph.sh - 定义需求并运行：编写
prd.json（示例见 GitHub README），然后执行./scripts/ralph/ralph.sh——Ralph 将自动开始循环，直到所有需求标记为 completed
进阶用户还可将 skills/ 目录全局安装至 Amp/Claude 配置，实现跨项目复用。
项目信息
snarktank/ralph
GitHub
Ralph is an autonomous AI agent loop that runs repeatedly until all PRD items are complete.
编程语言：TypeScript｜GitHub Star 数：16,545｜开源协议：MIT｜GitHub 项目地址
这是一款由全球开发者共建、经实战验证的前沿 AI 工程化工具——它不鼓吹“取代程序员”，而是坚定地站在开发者身后，把机械性、重复性、易出错的推进工作交给 AI，让你专注真正的设计、权衡与创造。
