项目介绍
Flow-Next 是一个把编码 Agent 从临时对话推进到可复现工程流程的本地插件。它先把任务写成持久规格，再让新上下文工作者实施，由独立角色检查规格合规与代码质量，并把测试、QA、审查和 PR 状态保存成回执。项目状态留在仓库的 .flow/ 中，因此任务可以跨会话恢复，也便于人和多个 Agent 追踪决定。它支持多种编码宿主，但会继承宿主的文件、Shell、模型和 GitHub 权限；采用前应明确自动化上限、PR 合并策略和敏感仓库边界。
核心功能
持久化规格与上下文恢复
capture 把任务和决策写入 .flow/，后续工作者可从明确规格和项目记忆继续，而非依赖完整聊天历史。
分角色实施与审查
工作流可调度实施者、规格审查者和代码质量审查者，在支持的宿主上使用新上下文或不同模型降低自审偏差。
证据与回执
测试、人工 QA、审查结论和交付状态被记录为结构化证据；仓库工作示例展示了评审发现 Git 颜色输出破坏引用解析并修复后留痕。
PR 与落地控制
可创建带证据的 PR、处理评审意见并执行落地；v6.0.0 要求 land 指定一个 PR，且 --until=merge 只有在当前授权和 GitHub 门禁均满足时才会合并。
跨宿主工作流
同一工作流概念映射到 Claude Code、Codex、Droid、Cursor、Grok Build 与 OpenCode，但命令语法和自动循环能力按宿主调整。
安装与使用
先选择宿主并固定经过评审的版本，在测试仓库安装。运行 setup 只初始化项目级状态，然后用一个低风险任务验证规格、实现、审查和草稿 PR 边界；不要在第一次验证时启用 Ralph 自动循环或允许自动合并。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我在隔离测试仓库安装并最小验证 Flow-Next。项目地址：https://github.com/gmickel/flow-next。先阅读 README、platforms、install-codex.sh、SECURITY 和最新 release，确认 Python 3.11+；若使用 Codex 多 Agent，请确认 CLI 0.102.0+。固定我指定的版本；如果未指定，先展示最新正式版和拟安装提交让我确认。说明将写入 CODEX_HOME 与项目 .flow/ 的内容，再执行安装和 setup。只用一个文档型测试任务验证规格、实施、独立审查、测试回执与草稿 PR。不要启用 Ralph，不要访问生产仓库或秘密，不要配置外部追踪器，不要使用 --until=merge，不要自动合并、强推或扩大 gh 权限。最后报告所有文件和配置变化、运行证据、卸载或回滚办法，以及仍未验证的能力。- Python 3.11 或更高版本
- 受支持的编码 Agent 宿主及相应模型访问权限
- Codex 多 Agent 角色需要 CLI 0.102.0 或更高版本
- 审查与 PR 子系统需要 jq、gh 和由用户完成的 GitHub 登录
- 允许在测试仓库创建 .flow/、分支、提交与草稿 PR
/plugin marketplace add https://github.com/gmickel/flow-next
/plugin install flow-next
/reload-plugins
/flow-next:setup- 1固定版本并准备宿主
确认 Python、宿主版本和模型权限，选择经过评审的 Flow-Next tag；需要 PR 时再准备 jq 与最小权限 gh 凭据。
- 2安装并初始化测试仓库
按宿主文档安装插件，运行 setup，检查 CODEX_HOME 或插件目录变化以及仓库中新建的 .flow/ 文件。
- 3捕获一个低风险规格
用 flow 或 capture 描述小型文档任务，审阅生成的目标、验收条件和限制，再允许工作者实施。
- 4检查审查与回执
确认规格审查、代码质量审查、测试和人工 QA 的结果均有证据，且失败会回到修复循环。
- 5停在草稿 PR 并人工决策
首次验证只创建草稿 PR，人工检查 diff、权限和 git 状态；不要传 --until=merge，确认策略后再决定是否落地。
在隔离测试仓库运行 setup，确认 .flow/ 和项目说明按预期生成；执行一个只改文档的小任务，让 flow 产出规格、实现、审查与测试回执，并停在草稿 PR。检查 PR diff、证据和本地 git 状态，不传 --until=merge、不启用 Ralph，验证完成后由人工关闭或合并测试 PR。
- Codex 安装器按当前 CODEX_HOME 安装，运行前应确认目标目录。
- setup 会写项目级 .flow/ 状态与说明片段，建议先查看 git diff。
- 合并需要显式 --until=merge 或命名 PR 的 land 调用，并继续受当前授权、检查、评审、讨论线程与仓库保护策略控制。
- bun 只用于已弃用的 Ralph TUI，不是核心工作流必需依赖。
- 从旧版升级到 v6.0.0 时，裸调用或定时调用 land 不再自动发现 PR，八个 land.* 配置键与 make-pr 的 --no-mermaid 参数已退役。
使用场景
复杂功能的规格化交付
把跨文件功能先固化为验收条件，再由独立角色实施和审查，减少长会话中目标漂移。
中断后恢复开发任务
借助 .flow/ 的规格、决定和回执，让新会话或新 Agent 从明确状态继续。
跨模型对抗式评审
在宿主支持时为实施和评审选择不同模型，分别检查规格合规与代码质量。
带证据的草稿 PR
把测试、人工 QA 和审查结论连同实现送入草稿 PR，给维护者留下可追踪入口。
使用评价
Flow-Next 的价值不在于再加一个代码生成命令，而在于把规格、上下文隔离、独立审查和证据回执变成仓库内可恢复的流程。它对长任务、多 Agent 和严格 PR 交付尤其有吸引力。相应代价是更多状态文件、角色调用与工具权限，且工作流纪律不能替代项目自己的测试、安全和分支保护。v6.0.0 把 PR 正文改成面向审阅者的简报，并把落地收窄为一次处理一个命名 PR；这是更清晰的边界，但自动合并仍应只在隔离验证和仓库门禁完备后启用。
值得一试的地方
- 规格和工作状态留在仓库，可跨会话恢复
- 实施与审查角色分离，支持跨模型检查
- 证据回执把测试、QA 和决定串到交付记录
- 覆盖多种主流编码 Agent 宿主
- v6.0.0 的 PR 简报按验收条件组织审阅步骤
- MIT 许可证明确，2026-09-21 仍有发布与提交活动
使用前要知道
- 多角色和跨模型运行会增加时延、额度与协调成本
- 不同宿主的命令、钩子和自动循环能力并非完全一致
- 安装器会写入宿主配置和多个插件目录，升级前需审查 diff
- PR 流程依赖 gh 权限，外部追踪器会扩展数据边界
- 自动审查与回执无法证明不存在回归或安全缺陷
- 本轮没有进行安装与端到端功能验证
README
Flow-Next
Overview
把需求捕获、规格编写、隔离实现、跨模型审查、证据回执、拉取请求与落地串成可重复流程的本地插件，支持 Claude Code、Codex、Cursor、Droid、Grok Build 与 OpenCode。 Repeatable agentic engineering. The workflow layer that turns AI coding agents into a disciplined factory: durable specs, fresh-context workers, adversarial cross-model reviews, receipts. Everything in your repo, zero dependencies. Claude Code · Codex · Cursor · Droid.
Getting started
- 先选择宿主并固定经过评审的版本，在测试仓库安装。运行 setup 只初始化项目级状态，然后用一个低风险任务验证规格、实现、审查和草稿 PR 边界；不要在第一次验证时启用 Ralph 自动循环或允许自动合并。
- Flow-Next 以规格为中心组织需求捕获、实施、评审、PR 和落地，并把过程状态与证据放回仓库。
- 主入口 flow 可以从自然语言任务开始；需要控制时也可分别调用 capture、work、make-pr、resolve-pr 与 land。
- 在隔离测试仓库运行 setup，确认 .flow/ 和项目说明按预期生成；执行一个只改文档的小任务，让 flow 产出规格、实现、审查与测试回执，并停在草稿 PR。检查 PR diff、证据和本地 git 状态，不传 --until=merge、不启用 Ralph，验证完成后由人工关闭或合并测试 PR。
Configuration
/plugin marketplace add https://github.com/gmickel/flow-next
/plugin install flow-next
/reload-plugins
/flow-next:setup