task-auto

/task-auto — 自动批量执行

⚠️ 不要在 plan mode 下使用此命令。 此命令需要运行脚本、创建文件和执行任务，plan mode 的只读限制会阻断这些操作。

你是一个工作流自动化管理员。你的职责是配置自动循环执行机制，然后开始执行第一个任务。

前置条件

• 本命令依赖 ralph-loop 插件 和 jq 实现自动循环。两者缺一不可。

输入

• $ARGUMENTS：可选参数
  • --phase RANGE：阶段范围（如 1, 1-3, 0,2）
  • --task RANGE：任务编号范围（如 1-5, 1,3,7），指定时忽略 --phase
  • --max N：覆盖最大迭代次数（最小 3，默认自动计算）
  • --all：所有阶段的任务
  • --yes：跳过确认，直接开始

执行流程

步骤 1：前置检查

1. 确认 docs/workflow/workflow.json 存在（否则提示运行 /workflow-init，终止）
2. 确认 docs/workflow/TASK_STATUS.md 存在且有待执行任务（否则终止）
3. 检查 ralph-loop 插件是否已安装（使用通配符搜索 ~/.claude/plugins/marketplaces/*/plugins/ralph-loop/hooks/hooks.json，不要硬编码特定 marketplace 名称）：
   • 如果未安装：告知用户 ralph-loop 未安装，自动循环无法工作。给出安装方式（在 Claude Code 中运行 /install-plugin ralph-loop），建议使用 /task-exec 手动逐个执行。终止执行。
4. 检查 jq 是否可用（运行 jq --version）：
   • 如果不可用：告知用户 jq 是 ralph-loop stop hook 的必要依赖，自动循环无法工作。建议安装 jq（如 winget install jqlang.jq、brew install jq 等）。终止执行。
5. 检查 .claude/ralph-loop.local.md 是否已存在且 frontmatter 中 active: true：
   • 如果存在活跃循环：告知用户当前有正在进行的自动执行循环，询问：
     • 覆盖：继续设置，将覆盖现有状态
     • 取消：终止本次操作（建议先用 /ralph-loop:cancel-ralph 取消现有循环）
   • 用户确认覆盖后继续，否则终止

步骤 2：运行设置脚本

运行设置脚本：uv run "${CLAUDE_PLUGIN_ROOT}/scripts/setup_autoexec.py" --path <PROJECT_ROOT> $ARGUMENTS

• <PROJECT_ROOT> 替换为当前项目的根目录绝对路径
• 将 $ARGUMENTS 中的参数直接透传给脚本（--yes 由脚本接受但忽略）

步骤 3：确认启动

如果用户未指定 --yes：

• 展示设置脚本的输出摘要
• 等待用户确认后继续

如果用户指定了 --yes，跳过确认直接继续。

步骤 4：执行第一个任务

读取 .claude/ralph-loop.local.md 文件中 --- 分隔的 prompt 部分（第二个 --- 之后的全部内容），按照其中的自动执行协议开始执行第一个任务。

从此步骤开始，严格遵循 prompt 中定义的执行流程。

注意：

• 第一个任务执行完成后，如果 ralph-loop 插件已安装，其 Stop Hook 会自动拦截退出并触发下一次迭代
• 每次迭代只执行一个任务
• 必须完成状态更新、门控校验和 git commit 后才能结束迭代

---

中途取消

如需取消自动执行循环，使用 /ralph-loop:cancel-ralph 命令。