用途
Ralph Prompt Generator: Multi-Task 用于为多个相关任务生成 Ralph 兼容的提示词,这些任务需要按顺序或并行完成。它采用阶段化组织方式,配合里程碑跟踪、累积式成功标准和清晰的任务推进流程。
适用场景包括:CRUD 操作实现(创建、读取、更新、删除)、多步骤功能开发、多阶段数据库迁移、API 端点套件、多模块测试套件创建、多文件重构项目。
核心理念
该生成器遵循一条原则:失败是确定性的、可修复的。每个阶段的迭代都会从之前的尝试中学习。不必畏惧失败——失败是可预期的,并为通过提示词调优来改进提供数据。
使用方式
输入要求
- 要完成的任务清单
- 任务依赖关系(哪些任务依赖其他任务)
- 每个任务的成功标准
- 最终完成承诺短语
生成提示词
按以下形式发起:
Generate a Ralph multi-task prompt for:
Tasks:
1. [Task 1]
2. [Task 2]
3. [Task 3]
Dependencies: [Task 2 depends on Task 1, etc.]
Final promise: [COMPLETION_PHRASE]
生成工作流
-
梳理任务:建立任务清单表格,列出任务编号、任务名称、依赖关系、验证方式和预估复杂度。
-
定义阶段:将任务分组成逻辑阶段,例如:
- 阶段 1:基础——独立的设置任务,无依赖
- 阶段 2:核心实现——主要功能,依赖阶段 1
- 阶段 3:增强——附加功能,依赖阶段 2
- 阶段 4:验证——测试、清理、核验
-
创建阶段里程碑:每个阶段需要清晰的进入条件(开始前必须完成什么)、阶段内的具体任务、退出条件(什么能证明阶段完成)以及阶段里程碑标记。
-
组织提示词结构:使用模板,包含标题(多任务:总体目标)、概述、任务清单表,以及按阶段展开的目标、任务、成功标准、检查点;最后是最终验证、完成清单、完成输出和进度跟踪。
提示词结构要点
生成的提示词包含以下组成部分:
- 概述:用 1-2 句话描述总体目标和范围。
- 任务清单表:列出编号、任务、所属阶段、依赖关系和验证方式。
- 各阶段:每个阶段包含目标、前置条件、任务详情(要求、涉及文件、验证方式)、成功标准(复选框形式、含测试命令)和阶段检查点(记录任务完成证据和测试状态)。
- 最终验证:运行完整验证,包括全部测试、集成检查和 lint/类型检查。
- 完成清单:逐项核对各阶段任务完成与验证情况、测试通过、无回归以及其他要求。
- 完成条件:当所有阶段完成且所有清单项验证通过时,输出承诺短语。
- 进度跟踪:按阶段记录状态(完成/进行中/未开始)和任务计数。
- 受阻处理:记录哪个阶段/任务造成阻塞、列出已尝试的方法、识别具体阻碍,并强调不得跳过任务或输出虚假承诺。
示例
资料提供了两个示例:
-
CRUD API 实现:为 Products 资源实现完整 CRUD 操作,含 RESTful 端点、校验和测试,分为四个阶段(基础、核心 CRUD、更新与删除、集成与验证),承诺短语为
CRUD_API_COMPLETE。 -
CI/CD 流水线搭建:使用 GitHub Actions 搭建完整 CI/CD 流水线,含 lint、测试、构建和分阶段部署,分为四个阶段(工作流基础、质量关卡、构建、部署),承诺短语为
PIPELINE_COMPLETE。
最佳实践
- 任务组织:将相关任务分组到阶段中;明确阶段间依赖;阶段内的独立任务可并行。
- 阶段设计:每个阶段有清晰的进入/退出条件;在每个阶段边界记录检查点;阶段名称应反映用途(基础、核心、增强、验证)。
- 进度跟踪:每个任务后更新进度标记;在检查点记录证据;即使任务看似简单也不要跳过阶段。
- 应当:创建清晰的阶段边界;明确依赖关系;为每个任务包含验证;系统化跟踪进度;每个阶段后设置检查点。
- 不应:跳过阶段或任务;让依赖关系含糊不清;忘记阶段检查点;在所有阶段完成前输出承诺。
与 Ralph Loop 集成
/ralph-wiggum:ralph-loop "[paste generated prompt]" --completion-promise "YOUR_PROMISE" --max-iterations 50
推荐迭代次数(按复杂度):
- 4-5 个任务:
--max-iterations 35-45 - 6-8 个任务:
--max-iterations 50-70 - 9+ 个任务:
--max-iterations 80-100
相关工具
- 单任务提示词:见 ralph-prompt-single-task
- 项目级提示词:见 ralph-prompt-project
- 研究/分析提示词:见 ralph-prompt-research
限制
除上述内容外,关于该工具的收费、价格、平台支持等信息暂未提供。