mcpField

Ralph Story Executor

精选按需触发
持续集成最多 20 轮

关于 Ralph Story Executor

该循环由手动触发，最多运行 20 轮，用来逐个实现 .ralph/prd.json 中尚未通过的故事。每一轮先挑出一个 passes: false 的故事并完成实现，再运行测试、lint 和构建的组合检查，结果通过后才更新该故事的状态。

主要功能

  1. 01测试、lint、构建串联为同一道检查
  2. 02以 .ralph/prd.json 中的 passes 字段记录进度
  3. 03手动触发，最多 20 轮
  4. 04支持 Cursor 和 Claude Code

适用场景

  1. 01按 PRD 文件中的故事清单批量实现功能
  2. 02让编码 Agent 在构建验证下持续推进待办
  3. 03需要每个故事都经过完整检查才算完成的项目
目标
.ralph/prd.json 中的每个故事都已标记为 passes: true。
退出条件
不再有 passes: false 的故事时停止，并回复 "ALL STORIES ARE COMPLETE"。
每轮之间运行
npm test && npm run lint && npm run build

启动提示词

在 Cursor / Claude Code 中粘贴运行，Agent 会按下面的步骤循环执行，直到满足退出条件。

prompt.md
开始运行“Ralph Story Executor”循环。
目标：.ralph/prd.json 中的每个故事都已标记为 passes: true。
最大轮数：20。
第 1 步：选取下一个故事 — 读取 .ralph/prd.json，挑出一个 passes: false 的故事作为本轮目标。若已没有这样的故事，则直接结束循环。
第 2 步：实现故事 — 按故事描述修改代码，范围限定在该故事所需的内容之内。
第 3 步：运行检查 — 依次执行测试、lint 和构建，三项全部成功才算通过。任何一项失败，就根据输出修复后在下一轮重试。 `npm test && npm run lint && npm run build`
第 4 步：更新状态 — 检查通过后，把该故事的 passes 改为 true，作为本轮的进度记录。
每轮之间运行：`npm test && npm run lint && npm run build`
退出条件：不再有 passes: false 的故事时停止，并回复 "ALL STORIES ARE COMPLETE"。

步骤

每一轮按顺序执行；未满足退出条件会进入下一轮，最多重复 20 轮。

01
选取下一个故事

读取 .ralph/prd.json，挑出一个 passes: false 的故事作为本轮目标。若已没有这样的故事，则直接结束循环。

02
实现故事

按故事描述修改代码，范围限定在该故事所需的内容之内。

03
运行检查

依次执行测试、lint 和构建，三项全部成功才算通过。任何一项失败，就根据输出修复后在下一轮重试。

$npm test && npm run lint && npm run build
04
更新状态

检查通过后，把该故事的 passes 改为 true，作为本轮的进度记录。

未通过 → 下一轮满足条件即退出

支持的 Agent

可以直接运行这个 Loop 的编码 Agent。

Cursor
Claude Code
Codex

评论

支持 Markdown