FlowPilot

English

一个文件，一句开发需求，全自动开发。

把 flow.js 丢进任何项目，打开你选择的客户端（Claude Code / Codex / Cursor / snow-cli 等）描述你要做什么，然后去喝杯咖啡。 回来的时候，代码写好了，测试跑完了，git 也提交了。

新增说明：现已兼容 Claude Code、Codex、Cursor、snow-cli 和其他客户端；init 时可直接选择目标客户端并生成对应的 instruction file / 配置。

新增说明：内置 instruction file / 客户端增强模板现已将输出风格作为硬约束，要求回答遵循：先结论、后细节、简洁直给、终端友好；同时补强了依赖分析、并行调度、危险操作确认等执行约束，FlowPilot 自己的终端输出也会强化分组、状态图标与下一步提示。 这次升级不仅包含表现层优化：更友好的话术、更清晰的分组、更直观的终端排版之外，也同步增强了中断恢复、收尾边界、实时进度上报与验证策略。使用前请以最新文档和命令实际输出为准。

多客户端全自动并行开关：

• Claude Code：开启 Agent Teams
• Codex：在 ~/.codex/config.toml 中设置 multi_agent = true，建议直接用 codex --yolo
• Cursor：开启 Agents，并将 Auto-Run Mode 调成 Run Everything

Codex 增强规则预览：

• 标准执行流程：任务分析 → 并行调度与子任务下发 → 结果汇总 → 递归迭代
• 并行约束：无前置依赖且无写冲突的任务优先并发；单轮最多同时下发 50 个子任务
• 子任务契约：下发子任务时必须明确 代理名称 / 任务定义 / 执行动作 / 预期结果

快速开始

# 1. 构建并复制到你的项目
cd FlowPilot && npm install && npm run build
cp dist/flow.js /your/project/

# 2. 初始化（会显示客户端选项）
cd /your/project
node flow.js init

# 3. 启动客户端，直接描述需求
claude --dangerously-skip-permissions

初始化时会直接显示客户端选项：

• Claude Code：生成 CLAUDE.md + .claude/settings.json
• Codex：生成 AGENTS.md，并附加 Codex 平台增强规则（并行调度 + 子任务契约）
• Cursor / Other：生成通用版 AGENTS.md
• snow-cli：生成 AGENTS.md + ROLE.md

中断后直接继续：

# Claude Code
claude --dangerously-skip-permissions --continue

# Codex
codex --yolo

• Claude Code：推荐直接用 --continue / --resume
• Codex：重新进入项目目录后启动 codex --yolo，然后说「继续任务」
• Cursor：重新打开项目，在原会话或新会话中说「继续任务」
• snow-cli / 其他客户端：重新进入项目目录，恢复或新开会话后说「继续任务」

需要更完整说明时，再往下看「初始化与客户端选项」「执行流程」「错误处理」。

最近更新

🔥 OpenSpec 集成 — 任务解析器兼容 OpenSpec checkbox 格式，双路径协议自动选择标准/OpenSpec 规划流程，支持 tasks.md 自动发现与用户确认

🧠 长期记忆系统 — checkpoint 自动提取知识存入 .flowpilot/memory.json，BM25 + Dense 双路检索，MMR 重排序 + 时间衰减，next 时自动注入相关记忆到子Agent上下文

🔄 自我进化引擎（完整闭环） — Reflect → Experiment → Review 三阶段循环，成功/失败均触发进化，参数写入 config 被工作流真正消费，退化自动回滚

| 模块 | 评分 | 借鉴内容 | |------|------|----------| | 记忆系统 | 100% | BM25 稀疏向量（FNV-1a 20-bit）、Dense Vector 检索、RRF 三源融合、Multimodal 嵌入、10语言分词、TTL+LRU 缓存 | | 循环检测 | 100% | 重复失败/乒乓/全局熔断三策略 + FNV-1a 哈希 + 警告注入（独创） | | 历史进化 | 100% | 三阶段循环（Reflect→Experiment→Review）、心跳自检、预快照回滚、协议自修改、活跃时间窗口 | | 知识提取 | 95% | LLM + 规则引擎双路径、标签提取、决策模式匹配、30+ 技术栈检测 |

🔥 子代理执行可视化增强 — 协议层新增子代理进度上报机制（建议每 30 秒更新 phase），formatter 实时显示任务激活时长（⏱️ X分X秒），超过 5 分钟显示超时预警（⚠️ 超时）

🔥 Codex 并发上限调整为 50 — 通过分析 Codex CLI 源码，发现默认并发上限为 6，需在 ~/.codex/config.toml 中配置：

[agents]
max_threads = 50

为什么用 FlowPilot

传统 CC 开发：你是项目经理——拆任务、分配、跟进、验收，全程盯着。 FlowPilot：你是甲方——只说要什么，剩下的全自动。

| 传统 CC 开发 | FlowPilot 开发 | |-------------|---------------| | 手动拆任务、一个个跟 CC 说 | 说一句需求，自动拆解 10+ 个任务 | | 上下文满了要从头来 | 新窗口一句话，从断点继续，零丢失 | | 一次只能做一件事 | 多个子Agent并行开发，速度翻倍 | | 做到一半忘了之前的决策 | 四层记忆 + 跨工作流长期记忆，100个任务也不迷路 | | 每次手动 git commit | 每完成一个任务自动提交，收尾自动跑测试 | | 换个项目要重新配置 | 单文件复制即用，Node/Rust/Go/Python/Java/C++/Makefile 通吃 | | 每次都犯同样的错 | 自我进化引擎，每轮自动反思优化，越跑越聪明 |...