SuperAPI AI 工具集

ralph

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

Ralph 是一个自主功能开发技能,分为设置与执行两个阶段。

用途:把一项功能拆解为可在单次迭代内完成的小任务,建立依赖关系,然后由 Ralph 循环自动逐个实现,直到全部完成。

主要能力:设置阶段支持两种模式——新功能(通过对话澄清需求、拆任务、创建父任务与子任务并设置 dependsOn、保存父任务 ID、重置 progress.txt)和已有任务(查找父任务、校验子任务结构与依赖、显示就绪/完成/阻塞状态)。执行阶段读取 scripts/ralph/parent-task-id.txt,查找 ready 且 open 的叶子任务,用 handoff 工具实现并验证,运行 npm run typecheck 与 npm test,更新 AGENTS.md 与 progress.txt,提交代码并标记任务完成,然后继续循环;全部完成后归档 progress.txt、清空父任务 ID、标记父任务完成并输出 <promise>COMPLETE</promise>。

使用方式:运行 ./scripts/ralph/ralph.sh [max_iterations] 或 npx tsx scripts/ralph/ralph.ts [max_iterations];用 amp task list --parentID [parent-id] --limit 10 查看状态。任务描述需包含可验证的验收标准,UI 任务用 Chrome DevTools MCP 的 take_snapshot 做功能验证。

限制:每个任务必须能在一个上下文窗口内完成,否则需拆分;查询任务须使用 limit(如 5-10)避免上下文溢出;progress.txt 仅作当前功能的短期记忆,新功能需重置;资料未提供收费、平台支持范围等信息。