155
// 项目简介
Ralph 是一个自主 AI Agent 循环，它使用 Amp 或 Claude Code 等工具重复执行编码任务，直到满足所有项目需求。每次迭代都在全新的上下文中运行，通过 git 历史记录、进度日志和结构化的 JSON 任务列表来维护项目状态。该系统通过将大型功能分解为可通过自动化质量检查验证的可管理用户故事，确保项目持续推进。
// 技术分析
Ralph 是一个自主 AI 代理循环，旨在通过重复调用 Amp 或 Claude Code 等 AI 工具来执行编码任务，直到完全满足项目需求。其核心理念在于为每次迭代保持干净的上下文，通过将持久化内存卸载到 git 历史记录、进度日志和结构化的 JSON 任务列表中，防止上下文窗口退化。这种方法解决了 AI 代理在大型项目中失去焦点的问题，确保复杂功能被分解为可管理、可验证的单元，并进行系统性的实现和测试。
// 核心亮点
01
实现了一个自主循环，为每个任务生成新的 AI 实例，以确保上下文干净并防止性能下降。
02
利用结构化的 prd.json 文件来跟踪用户故事及其完成状态，使代理能够按顺序优先处理和执行任务。
03
通过 git 历史记录、progress.txt 文件和 AGENTS.md 更新在迭代之间保持持久化内存，以捕获特定项目的学习成果。
04
支持与 Amp 或 Claude Code 的模块化集成，允许开发人员选择他们首选的 AI 编码工具。
05
强制执行严格的反馈循环，要求在提交更改和标记任务完成之前通过类型检查和测试等质量检查。
06
提供先前运行的自动归档功能，确保在开始新功能时保留项目历史记录。
// 典型使用场景
01
通过迭代式 AI 编码周期自动执行基于 PRD 的用户故事。
02
将产品需求生成并转换为结构化的 JSON 格式，以供自主处理。
03
通过自动更新进度日志和 AGENTS.md 文件，实现持续的项目文档记录和学习持久化。
// 快速开始
首先，安装 Amp CLI 或 Claude Code，并确保您的系统上可以使用 'jq'。将 Ralph 脚本和相关的提示模板复制到您的项目目录中，然后生成一个 PRD 并将其转换为所需的 prd.json 格式。最后，使用 ralph.sh 脚本执行循环以启动自主开发过程。