用途
Spidey 用于为任意项目搭建 Ralph 自主开发循环。与直接使用 Ralph（只接收一份任务清单）不同，Spidey 会先根据用户的描述生成完整的产品需求文档（PRD），再从 PRD 推导出全部任务，从而让自主循环有明确的需求依据。
主要能力
Spidey 的流水线包含四个阶段：
- 阶段 0：PRD 生成。在写任何代码之前，先通过多轮深度提问生成完整 PRD。提问分为六轮：愿景与用户、核心体验、技术与平台、数据与业务逻辑、范围与约束、边界情况与打磨。不要求问完所有问题，但必须在六轮中至少覆盖四轮。PRD 写入
.ralph/specs/PRD.md，包含概述、目标用户、用户故事（含验收标准）、技术需求（技术栈、架构、数据模型、API 端点）、界面与导航、非功能性需求、MVP 范围、成功指标、待解决问题等章节。生成后需向用户展示摘要并请求批准。 - 阶段 1：任务推导。PRD 获批后，从中推导出
.ralph/fix_plan.md。规则包括：每个用户故事变成一个或多个任务；每条验收标准变成验证步骤；基础设施/搭建任务优先（Critical）；核心用户流程为 High；增强功能为 Medium；打磨/锦上添花为 Low；每个任务需能在单次循环迭代（约 15 分钟 Claude 工作）内完成。计划末尾设有验证门（Verification Gate）。 - 阶段 2：循环配置。检查 Ralph 是否安装（
which ralph-loop或which ralph），未安装则从https://github.com/frankbria/ralph-claude-code.git克隆并执行./install.sh；依赖为 jq、tmux、coreutils。创建目录结构.ralph/specs、.ralph/examples、.ralph/logs、.ralph/docs/generated。生成.ralphrc（含项目名、类型、每小时最大调用数、超时、允许工具、会话连续性、熔断阈值等），并根据项目类型调整ALLOWED_TOOLS。生成PROMPT.md（含任务说明、项目上下文、架构规则、规则、必需的 RALPH_STATUS 输出格式）和AGENT.md（构建、测试、运行、lint、类型检查命令）。初始化 git 仓库（对熔断器至关重要，因为熔断器通过git diff --name-only检测进展）。最后打印运行说明。 - 阶段 3：自主执行。通过
ralph --monitor运行循环与实时仪表盘，或ralph仅运行循环。
使用方式
运行 ralph --monitor 启动循环加 tmux 实时仪表盘（推荐），或 ralph 仅启动循环。用 ralph-monitor 在单独终端查看仪表盘。循环会自上而下处理 fix_plan.md，每次迭代一个任务，直到所有条目勾选完毕且验证门通过。
快速参考命令：ralph-enable（对现有项目运行交互式向导）、ralph-setup my-proj（创建新的空白项目）、ralph-import prd.md（将现有 PRD 转换为 Ralph 格式）、ralph --monitor（运行循环加仪表盘）、ralph-monitor（仅仪表盘）。
适用场景
适用于希望以自主循环方式推进开发、且需要从需求文档出发保证任务可追溯的项目。
限制
- 退出检测为双条件门：仅当
completion_indicators >= 2且 Claude 在 RALPH_STATUS 中输出EXIT_SIGNAL: true时才停止。 - 熔断器：3 次循环无文件变更则 OPEN（暂停）；5 次循环相同错误则 OPEN；2 次循环无进展则 HALF_OPEN（监控）；HALF_OPEN 中有进展则 CLOSED（恢复）。
- 会话连续性：通过
--continue标志保持会话，24 小时过期（可配置）。 - 速率限制：每 5 小时窗口 100 次调用（可配置），达到限制时自动等待并倒计时。
- 必须存在 git 仓库并有初始提交，否则熔断器会误触发。
- 关于收费、价格、平台支持等具体信息，资料中暂未提供。