用途:系统化执行 Flow epic 或任务,专注完成既定计划,用于实现方案并逐项推进。
主要能力与硬性要求:使用 .flow/ 作为唯一任务跟踪方式,不使用 markdown TODO、plan 文件、TodoWrite 或其他跟踪方法。flowctl 为捆绑工具,不全局安装,which flowctl 会失败(预期);须使用 FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl" 与 $FLOWCTL <command>。每个完成的任务必须运行 flowctl done 并确认状态为 done。提交前用 git add -A 暂存(不列举文件),以包含 .flow/ 及 scripts/ralph/(如存在)。在 flowctl show <task> 显示 status: done 前不得声称完成;测试/Quick 命令未通过前不得调用 /flow-next:impl-review。
使用方式:输入接受 Flow epic ID(如 fn-1-add-oauth 或旧式 fn-N/fn-N-xxx)、单个任务 ID(如 fn-1-add-oauth.2 或旧式 fn-N.M)、Markdown 规格文件路径(先创建 epic 再执行)、想法文本(创建最小 epic 与单任务再执行),以及链式指令(如 then review with /flow-next:impl-review)。示例:/flow-next:work fn-1-add-oauth、/flow-next:work fn-1-add-oauth.3、/flow-next:work docs/my-feature-spec.md、/flow-next:work Add rate limiting。无输入时须询问。
流程:先检查 REVIEW_BACKEND=$($FLOWCTL review-backend)(返回 ASK 表示未配置,或 rp/codex/none)。解析参数可跳过提问:分支模式 --branch=current/--current、--branch=new/--new-branch、--branch=worktree/--worktree;评审模式 --review=codex、--review=rp、--review=export、--review=none。若已配置 rp/codex/none 只问分支问题;若为 ASK 则同时问分支与评审。用户回复前不得读写代码。之后读取 phases.md 并按阶段顺序执行。每个任务由 worker 子代理以全新上下文实现、提交与评审,避免上下文串扰;用户选择评审时把评审模式传给 worker,worker 在实现后调用 /flow-next:impl-review 并循环直到 SHIP。epic 全部任务完成后,若 --require-completion-review 已配置,工作技能会在允许 epic 关闭前调用 /flow-next:epic-review 验证整体实现,修复循环由该技能内部处理直到 SHIP。Ralph 模式规则:当 REVIEW_RECEIPT_PATH 已设置或 FLOW_RALPH=1 时,提交前必须用 flowctl done 并验证状态为 done,必须 git add -A,不得用 TodoWrite。
限制与护栏:未询问分支问题不得开始;没有计划/epic 不得开始;不得跳过测试;不得留下半成品任务;不得用 TodoWrite 跟踪任务;不得在 .flow/ 外创建 plan 文件。默认值:分支=new,评审=已配置后端,否则 none(无自动检测回退)。