用途
Ralph Prompt Builder 是生成 Ralph Wiggum 自主循环技术优化提示词的主编排器技能。它分析用户的任务描述，将其分类为单任务、多任务、完整项目或研究分析，并路由到相应的专用生成器，最终输出可直接用于 Ralph Loop 的提示词。
任务分类与路由
编排器根据任务特征将其分类并路由到四个专用生成器之一：
- 单任务（ralph-prompt-single-task）：适用于 bug 修复、单一功能、重构、单一模块修改。完成标准是测试通过。推荐迭代次数 15-35。
- 多任务（ralph-prompt-multi-task）：适用于 CRUD、多步功能、迁移、多个端点。完成标准是多个功能正常工作。推荐迭代次数 35-100。
- 完整项目（ralph-prompt-project）：适用于从零构建的全新应用、库或工具。完成标准是完整应用可运行。推荐迭代次数 60-200。
- 研究分析（ralph-prompt-research）：适用于审计、规划、调查、比较。完成标准是产出文档。推荐迭代次数 30-100。
分类依据
编排器通过以下问题进行分类：任务是从零创建还是修改现有代码；有多少个独立交付物；是否需要先调查再行动；完成标准是什么。
主要能力
任务分类
接收任务描述后，输出分类结果、分类原因和推荐的生成器，并允许用户指定偏好的类型。
生成器输入引导
每个生成器需要不同的输入：
- 单任务：任务描述、成功标准、完成承诺文本
- 多任务：任务列表、任务间依赖关系、最终完成承诺
- 项目：项目描述、技术栈、功能列表、完成承诺
- 研究：研究目标、范围（包含/排除）、交付物格式、完成承诺
生成器结构
ralph-prompt-single-task 生成包含任务标题与目标、上下文、需求、成功标准（复选框）、带命令的验证步骤、TDD 方法、完成条件和卡住时指导的结构化提示词。最佳实践包括：包含实际测试命令、使标准为二元（通过/失败）、包含 TDD 循环。
ralph-prompt-multi-task 生成包含任务清单表、阶段划分（基础→核心→增强→验证）、各阶段任务与交付物、阶段检查点、进度跟踪和最终验证的提示词。最佳实践包括：将任务分组为逻辑阶段、明确依赖关系、记录检查点。
ralph-prompt-project 生成包含项目愿景与规格、六个阶段（阶段0设置、阶段1架构、阶段2核心、阶段3功能、阶段4测试、阶段5文档）、各阶段任务与交付物、最终验证和进度跟踪的提示词。最佳实践包括：明确非目标、按顺序完成所有阶段、不跳过测试与文档。
ralph-prompt-research 生成包含研究目标与范围、五个阶段（发现、分析、综合、建议、文档）、各阶段交付物和基于证据的结论的提示词。最佳实践包括：清晰定义范围边界、边做边创建工件、用证据支持结论。
使用方式
快速开始
使用格式：Use ralph-prompt-builder to create a prompt for: [描述你的任务]
工作流程
- 描述任务：提供需要做什么、技术/上下文、具体需求、期望结果
- 审查分类：编排器分类任务并解释原因
- 提供生成器输入：根据分类提供相应输入
- 生成与审查：检查需求完整性、验证命令正确性、确认完成标准、调整最大迭代次数
- 使用 Ralph 执行：
/ralph-wiggum:ralph-loop "[生成的提示词]" --completion-promise "[你的承诺]" --max-iterations [推荐值]
完成承诺
好的完成承诺应具体、可验证、面向行动。例如：bug 修复用 AUTH_FIX_COMPLETE，CRUD 用 PRODUCT_CRUD_DONE，项目用 TODO_API_V1_COMPLETE，研究用 SECURITY_AUDIT_DELIVERED。
迭代次数建议
根据复杂度设置：简单单任务 15、多任务 35、项目 60、研究 30；中等分别为 25、50、100、50；复杂分别为 35、70、150、80；非常复杂的多任务 100、项目 200、研究 100。调整因素：熟悉代码库 -20%，外部依赖 +30%，需求不清晰 +50%，需要全面测试 +25%。
适用场景
- 修复 bug（如修复令牌刷新中的竞态条件）
- 添加分页到 API 端点
- 重构数据库查询为 async/await
- 为认证模块编写测试
- 实现 CRUD 资源
- 添加登录、注册、登出和密码重置
- 搭建 CI/CD 流水线
- 从零构建 REST API、CLI 工具、URL 缩短服务
- 分析代码库安全漏洞
- 比较框架选型
- 创建迁移计划
限制
- 任务描述需具体，避免模糊描述
- 需提供完整上下文和需求
- 需包含具体验证命令
- 需设置合适的最大迭代次数
- 首次不一定完美，Ralph 接受迭代
- 任务过大时应考虑拆分（项目→多个项目，多任务→多个多任务）
- 若分类错误可显式指定生成器
- 需在使用前审查生成的提示词