Ralphy简介

在快速开发周期的时代，开发者始终在寻找方法来减少重复编码工作。Ralphy提供了独特的解决方案：一个自主的命令行界面（CLI），能自动循环使用一系列 AI 引擎——Claude Code、Codex、OpenCode、Cursor、Qwen、Factory Droid 和 GitHub Copilot——将产品需求文档（PRD）转化为实际代码。

为何 Ralphy 脱颖而出

• 多引擎支持 – 即时切换 AI 模型或并行运行以获得更快反馈。
• 任务自动化 – 单条命令即可生成完整功能，也可一次性提交已列出的完整 PRD。
• 智能冲突解决 – 当代理并行运行时，Ralphy 自动合并分支并解决大多数冲突。
• 浏览器自动化 – 利用 agent‑browser 在终端直接测试 UI 流程或验证部署。
• 可定制性 – 定义项目规则、模型覆盖，甚至为 Discord、Slack 或自定义服务设置 webhook 通知。
• 轻量级沙箱 – 对于大型 node_modules 的 monorepo，Ralphy 提供沙盒模式避免重复依赖拷贝。

快速开始

安装 (npm)

npm install -g ralphy-cli

安装 (Git 克隆)

git clone https://github.com/michaelshimeles/ralphy.git
cd ralphy
chmod +x ralphy.sh
./ralphy.sh "add login button"

两种安装方式提供相同的命令集；shell 脚本适用于不具备 Node.js 的环境。

使用场景

单个任务

ralphy "add dark mode"
ralphy "fix the auth bug"

完整 PRD

在仓库根目录放置名为 PRD.md 的 Markdown 文件：

# Product Requirement Document

## Tasks
- [ ] create auth
- [ ] add dashboard
- [ ] setup CI/CD

然后执行：

ralphy --prd PRD.md

配置项目

ralphy --init   # 自动检测语言、框架等设置
ralphy --add-rule "use TypeScript strict mode"   # 添加自定义规则至配置
ralphy --config   # 查看当前配置

平行引擎

通过一次性运行多个代理加速工作：

ralphy --parallel          # 默认 3 个代理
ralphy --parallel --max-parallel 5   # 增加代理池

任务分支工作流

ralphy --branch-per-task --create-pr --draft-pr

此命令为每个任务创建一个功能分支（例如 ralphy/create-auth），自动合并更改，并能打开草稿 PR。

高级功能

• 模型覆盖 – ralphy --model sonnet "add feature" 或 ralphy --sonnet "add feature"。
• 引擎专用参数 – 在 -- 后传递 CLI 标志给底层引擎。
• Webhook 通知 – 在 .ralphy/config.yaml 中为 discord_webhook、slack_webhook 或 custom_webhook URL 添加实时更新。
• 浏览器自动化 – 通过 --browser 启用；Ralphy 将调用 agent-browser 执行点击、填表和截图。
• 沙箱模式 – 使用 --sandbox 快速克隆并使用符号链接大型依赖树。

获取帮助与贡献

项目欢迎贡献。加入 Discord 社区，提交 Pull Request，或在 GitHub 上开 issue。仓库的 README 包含详细文档、示例 PRD、以及更新日志条目。

结论

Ralphy 在产品规范与代码之间搭建桥梁，自动化完成降低开发速度的大量琐碎工作。借助多 LLM、并行执行和自动合并 PR，Ralphy 能把一个简单的 PRD 转化为实际可运行的功能——全部只需在终端操作。无论你是希望加速的独立开发者，还是想标准化 AI 驱动编码的团队，Ralphy 都值得加入你的开发堆栈。