umputun/ralphex

解决的问题

ralphex 是一个 CLI 工具，旨在使用 Claude Code 或 codex 等 AI 编码代理自动执行复杂的软件实现计划。它消除了对交互式代理进行手动“看护”的需求，并防止因单次长时间 AI 会话中上下文过多而导致的质量下降。通过在每个新会话中执行每个任务，它能保持 AI 模型的敏锐和专注。

工作原理

ralphex 协调一个多阶段流水线，将基于 Markdown 的计划转化为完成的代码：

1. 任务执行：读取计划文件，使用 AI 代理逐个执行未完成的任务，并在每一步后运行验证命令（如测试或 linter）。
2. 首次代码审查：并行启动五个专业代理（质量、实现、测试、简化、文档），以发现并修复问题。
3. 外部审查：可选地使用外部工具（如 OpenAI Codex）提供独立的跨模型审查。
4. 第二次代码审查：由两个代理进行最终检查，重点关注关键和重大问题，确保没有引入回归。
5. 最终化：可选步骤，可重新基线并压缩提交，以清理 Git 历史记录。

适用人群

希望使用 AI 代理自动实现功能和代码审查，而无需 IDE 插件或云服务的开发者，以及偏好结构化、计划驱动的 AI 辅助编码方式的用户。

特色亮点

• 自主流水线：从计划创建到最终提交的全流程自动化。
• 多代理审查：使用多个专业代理和可选的跨模型验证的高级流水线。
• 工作树隔离：支持使用 git worktrees 并行运行多个计划。
• 灵活的执行器：支持 Claude Code 和 codex 作为主要执行引擎。
• 实时监控：包含流式终端输出，以及可选的 Web 仪表板以跟踪进度。