ralph-prd 的用途是为自主智能体循环(Ralph Wiggum 模式)生成结构化的 prd.json,将批量任务拆分为独立、可验证的工作项,每项都带明确的完成标准与验证步骤。适用于批量迁移(API 变更、依赖库升级、lint 修复)、跨多文件的大规模重构,以及任何可分解为独立可验证单元、需要显式定义“完成”的工作。
主要能力:定义 PRD 结构,包含 instructions(内嵌 markdown,提供上下文、示例、约束)与 items 列表。每个 item 含 id、category、description、file、steps(操作步骤加验证步骤)、passes(初始为 false,完成置 true)、skipped(无法完成时填原因)。生成流程为:确定范围、收集输入数据(lint 输出、文件列表、API 变更)、设计条目粒度(按文件、按错误或按组件)、定义验证步骤(类型检查、测试、lint)、编写 instructions、生成条目、抽查样例。生成前需与用户确认粒度、验证步骤、instructions 内容、跳过条件与路径/ID 格式。
使用方式:以 lint 输出为例,将按文件分组的 JSON 数组映射为 items,id 用去掉仓库根前缀的文件路径,category 设为 migration,steps 包含修复全部错误、运行 yarn type-check:go 必须通过,存在测试时追加 yarn test <path>。instructions 中应写入违规/任务类型的前后示例、范围规则、跳过条件、文档链接与类型命名约定。每个 item 至少一个验证步骤。
限制:验证应具体,避免模糊描述;缺失跳过条件会导致智能体尝试不可能的修复;条目范围过大难以验证和恢复,基于文件的迁移建议一个文件一个条目;instructions 不充分会让执行智能体猜测约定。
资料未提供:官方收费、价格、平台支持与具体安装命令暂未提供。