flow-next 用于在 .flow/ 目录中快速管理任务与规格。规划功能使用 /flow-next:plan,执行使用 /flow-next:work。
注意 flowctl 是内置的,并非全局安装,which flowctl 会失败属正常。定义一次: FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl" [ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
主要能力:检测与初始化($FLOWCTL detect --json、$FLOWCTL init --json);列出规格与任务($FLOWCTL list/specs/tasks --json,可按 spec 或 status 过滤);查看规格与任务(show、cat);查询可执行任务(ready);创建任务并设置描述与验收标准(task create、task set-spec、task set-description 支持 stdin 和 heredoc);开始与完成任务(start、done,done 需 summary 文件与 evidence JSON);校验结构(validate --spec、validate --all)。
ID 格式:规格为 fn-N-slug,任务为 fn-N-slug.M;旧的 fn-N、fn-N-xxx 仍受支持。
限制与说明:所有写入都需通过 flowctl,不要直接编辑 JSON/MD 文件;使用 --json 可获得机器可读输出;完整命令与选项请运行 $FLOWCTL --help 查看;复杂规划与执行应使用 /flow-next:plan 和 /flow-next:work。其他细节资料未提供。