用途
Ralph Prompt Generator: Complete Project 用于从零开始为整个项目生成 Ralph 兼容的提示词。它把开发过程组织为架构阶段与实现阶段,并包含测试与文档环节,配合清晰的里程碑和增量式完成方式。资料说明其最佳用途包括:从零构建完整的 REST API、创建 CLI 工具、开发库/包、构建 Web 应用、创建自动化工具,以及需求明确的绿地项目。
主要能力
该工具围绕以下几个环节组织生成流程:
- 第 1 步:定义项目范围。提供项目定义模板,包含项目名称、一句话目的、技术栈、目标用户、核心功能列表、非目标(明确排除项)以及成功定义(可度量、可验证的完成标准)。
- 第 2 步:映射项目阶段。资料给出的标准阶段为:0 设置(项目脚手架、依赖,约 5%)、1 架构(设计模式、结构,约 10%)、2 核心(主要功能,约 40%)、3 功能(附加功能,约 25%)、4 测试(测试覆盖,约 10%)、5 打磨(文档、清理,约 10%)。
- 第 3 步:定义里程碑。每个阶段需要具体里程碑,资料强调好的里程碑应可通过运行命令验证、是二元的(完成或未完成)、不依赖主观判断,例如“项目构建无错误”“所有测试通过”“CLI 帮助命令可用”。
- 第 4 步:组织提示词结构。使用模板,包含项目名、愿景、技术规格(语言、框架、数据库、测试、构建)、核心功能、非目标,随后是 Phase 0 至 Phase 5 各阶段的 Objective、Tasks、Deliverables 与 Verification 命令,以及各阶段的 Checkpoint。
使用方式
资料给出的快速开始要求输入:项目描述(要构建什么)、技术需求(语言、框架、功能)、成功标准(什么算完成)、最终完成承诺语。生成提示词的方式如下:
Generate a Ralph project prompt for:
Project: [Project description]
Tech stack: [Language, framework, tools]
Features: [List of required features]
Promise: [COMPLETION_PHRASE]
生成的提示词可在 Ralph 循环中运行,资料给出的集成命令为:
/ralph-wiggum:ralph-loop "[paste generated prompt]" --completion-promise "YOUR_PROMISE" --max-iterations 100
按项目规模推荐的迭代次数:小型项目(CLI 工具、简单 API)为 60-80;中型项目(带认证的完整 API)为 100-150;大型项目(多特性应用)为 150-200。对于大型项目,资料建议拆分为多个 Ralph 会话,例如第一个会话处理 Phase 0-2(设置到核心),第二个会话处理 Phase 3-5(功能到打磨)。
资料还提到相关同类提示词:单任务提示词见 ralph-prompt-single-task,多任务提示词见 ralph-prompt-multi-task,研究/分析提示词见 ralph-prompt-research。
进度跟踪与卡住处理
每个阶段后需要更新进度,格式包含 Phase 0 至 Phase 5 的状态(COMPLETE/IN PROGRESS/NOT STARTED)、当前阶段与整体状态。若同一问题多次迭代仍卡住,应:记录具体阻塞点、列出已尝试的方法、尽可能识别根本原因、考虑是否应缩减该功能范围(但不能不记录就跳过),并且不要输出虚假的完成承诺,应继续或等待达到最大迭代次数。
适用场景
适用于需求相对明确、需要从零搭建并分阶段验证的项目,尤其是 REST API、CLI 工具、库/包、Web 应用与自动化工具。资料中的现实成功案例包括:使用 Ralph 在 3 个月内创建“cursed”编程语言;Y Combinator 黑客松中一夜生成 6 个仓库;以 297 美元 API 成本完成 5 万美元合同。
限制与注意事项
资料中的 Ralph 理念指出:这些成功之所以成立,是因为 Ralph 接受失败是确定性的、可修复的,每次迭代都从前一次学习;不要惧怕失败,失败是预期内的,用于通过提示词调优而非更换工具来改进。资料列出的应做事项包括:定义清晰的项目范围、使用全部 6 个阶段、包含验证命令、设定现实的特性范围、在检查点记录进度;不应做的事项包括:跳过架构阶段、急于进入实现、把测试留到“以后”、项目中途范围蔓延、在文档完成前输出承诺语。完成判定要求:全部 6 个阶段完成并验证、所有测试通过、所有质量检查为绿、文档完整、无遗留 TODO,之后输出完成承诺语。完成承诺语由用户输入决定。