gmickel/flow-next

Flow‑Next – AI 驱动的编码代理工作流程

它是什么 – Flow‑Next 是一个插件，位于代码生成 LLM（Claude Code、OpenAI Codex、Cursor、Grok Build 等）与您的仓库之间。您向代理描述错误、功能、工单或性能问题，Flow‑Next 会编排完整的开发周期：它创建失败的测试或验收规格，要求模型编写修复，将 diff 路由到不同的模型系列进行审查，运行测试/基准测试，最后打开一个将每个更改映射到原始标准的 pull request。所有工件（规格、决策、收据）都存储在 .flow/ 目录下，以便工作保持可审计。

为何重要 – 纯 LLM 生成的代码通常缺乏周围的脚手架：清晰的规格、自动化验证和独立审查。Flow‑Next 自动添加这些缺失的步骤，README 声称与单独运行代理相比，可将交付速度提升至 2 倍，质量提升 10‑50%（减少隐藏测试失败）。

主要功能

• 路由选择 – 根据输入（错误、功能、性能请求、工单），Flow‑Next 选择最小工作流程（例如，测试优先、规格优先、测量优先）。您可以使用 flow --explain 查看规划的路由。
• 规格与测试生成 – 将堆栈跟踪转换为失败的测试，为功能编写编号的验收标准，或在重构前创建特征化测试。
• 模型系列审查 – diff 由与编写它的模型不同系列的模型审查，减少盲点偏差。
• 证据与收据 – 每个阶段记录 ran、skipped(reason) 或 failed(reason)。结果、测量和审查决策保存在 .flow/ 中。
• 自主模式 – flow --auto（或 --until=merge）在无人提示的情况下运行，循环进行审查、CI 和合并，直到 PR 获得批准。
• 多主机支持 – 可作为 Claude Code、OpenAI Codex、Factory Droid、Cursor、xAI Grok Build、OpenCode 和 Meta Muse Code 的插件安装，并提供主机特定的安装命令。
• CLI 与文档 – flowctl 提供 CLI；广泛的文档、Discord 社区和公开的证据页面支持性能声明。

典型工作流程

1. 设置 – 为您的主机安装插件，运行 /flow-next:setup 以编写指令片段并选择审查模型。
2. 调用 – /flow-next:flow <description>（或 flow --auto）。Flow‑Next 决定路由、创建测试/规格、生成代码、运行验证，并在第一个人工决策点停止。
3. 审查与 PR – 当您说“打开 PR”时，它会打开一个 pull request，其主体将每个更改映射到相应的验收标准。
4. 落地 – /flow-next:land <PR> 解决剩余的审查/CI 反馈，并在您授权后 squash‑merge。

证据 – README 引用了一项 170 次端到端运行的基准测试，比较 Flow‑Next 与纯 Claude Code，显示在错误修复、小型/大型功能和 Rust 案例中，速度提升 1.1‑1.9 倍，质量提升 8‑48%。

适用对象 – 已经使用 LLM 编码助手并希望获得可重复、可审计的管道的团队，该管道添加规格、测试、独立审查和自动化 PR 处理。它适用于 monorepo、微服务架构和遗留代码库，并与 GitHub、GitLab 和 Jira 集成。

许可证与社区 – MIT 许可、开源。项目活跃（在三个 OS 上运行 CI、Discord、赞助链接），并列入“awesome‑Claude‑Code‑workflows”集合。