SuperAPI AI 工具集

ralph-prompt-multi-task

编程与开发

查看项目

更新于 10-16 04:04

技能介绍

用途

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:基础——独立的设置任务,无依赖
    • 阶段 2:核心实现——主要功能,依赖阶段 1
    • 阶段 3:增强——附加功能,依赖阶段 2
    • 阶段 4:验证——测试、清理、核验
  3. 创建阶段里程碑:每个阶段需要清晰的进入条件(开始前必须完成什么)、阶段内的具体任务、退出条件(什么能证明阶段完成)以及阶段里程碑标记。

  4. 组织提示词结构:使用模板,包含标题(多任务:总体目标)、概述、任务清单表,以及按阶段展开的目标、任务、成功标准、检查点;最后是最终验证、完成清单、完成输出和进度跟踪。

提示词结构要点

生成的提示词包含以下组成部分:

  • 概述:用 1-2 句话描述总体目标和范围。
  • 任务清单表:列出编号、任务、所属阶段、依赖关系和验证方式。
  • 各阶段:每个阶段包含目标、前置条件、任务详情(要求、涉及文件、验证方式)、成功标准(复选框形式、含测试命令)和阶段检查点(记录任务完成证据和测试状态)。
  • 最终验证:运行完整验证,包括全部测试、集成检查和 lint/类型检查。
  • 完成清单:逐项核对各阶段任务完成与验证情况、测试通过、无回归以及其他要求。
  • 完成条件:当所有阶段完成且所有清单项验证通过时,输出承诺短语。
  • 进度跟踪:按阶段记录状态(完成/进行中/未开始)和任务计数。
  • 受阻处理:记录哪个阶段/任务造成阻塞、列出已尝试的方法、识别具体阻碍,并强调不得跳过任务或输出虚假承诺。

示例

资料提供了两个示例:

  1. CRUD API 实现:为 Products 资源实现完整 CRUD 操作,含 RESTful 端点、校验和测试,分为四个阶段(基础、核心 CRUD、更新与删除、集成与验证),承诺短语为 CRUD_API_COMPLETE。

  2. 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

限制

除上述内容外,关于该工具的收费、价格、平台支持等信息暂未提供。