这个项目能做什么

Ralph for Claude Code 是一款开源工具,实现了 Geoffrey Huntley 的 "Ralph" 技术,可运行持续自主开发循环,让 Claude Code 迭代式地改进项目直至完成。它支持全局安装,并提供 `ralph`、`ralph-monitor`、`ralph-setup`、`ralph-enable`、`ralph-import`、`ralph-queue` 和 `ralph-migrate` 等命令。 核心能力包括带有双条件退出门的自主开发循环,要求同时满足完成指标和显式 EXIT_SIGNAL;速率限制(默认每小时 100 次调用,可配置);以及具备高级错误检测的熔断机制,可防止失控循环。通过 `--resume` 在多次迭代间保持会话连续性,会话过期时间可配置(默认 24 小时)。实时流式输出(`--live`)与 tmux 集成可对循环状态、进度和日志进行实时监控。 交互式 `ralph-enable` 向导可自动检测项目类型(TypeScript、Python、Rust、Go)和框架(Next.js、FastAPI、Django),随后从 beads、GitHub Issues 或 PRD 文档导入任务。GitHub issue 导入支持元数据过滤(标签、标题、指派人、里程碑、状态),并提供首次/交互式/优先级选择策略,以及完整性评估(0-100 分),可自动为信息稀疏的 issue 生成实现计划。PRD 导入可将 Markdown、文本、JSON、Word 和 PDF 文档转换为 Ralph 格式。 其他功能包括 Docker 和 E2B 云沙箱执行(带资源限制与成本跟踪)、`.ralphrc` 配置文件、日志轮转(10MB,4 个归档)、dry-run 模式、通过 `ralph-stats` 进行指标跟踪、桌面通知、自动 git 备份分支与回滚,以及基于 GitHub Actions 的 CI/CD 流水线。该项目当前版本为 v0.11.5,拥有 784 个通过的测试并处于活跃开发中;多提供商代理抽象正在开发中,旨在与 Claude Code 解耦并支持 Codex、Gemini、Copilot 等其他无头编码 CLI。