跳转到内容
flow — gated build harness for coding agentsflow — gated build harness for coding agentsflow

安装与首次运行

这篇教程走完，flow skill 落在 agent 家目录的磁盘上，agent 重启过，harness 回了状态、一个下一步动作、或一次 gate 结果。

时间：一条命令，一次重启，一次机械检查。可选的深路（版本号和一次 gate 拒绝实录）十分钟——那是额外深度，不是及格线。

开始之前

Section titled “开始之前”

要 Node.js 22.14 或更高，一个支持的 coding agent（Claude Code、Codex CLI、Cursor、Antigravity，或 Agents home）。skill 运行时还要 bash——Windows 上指 Git Bash。python3 推荐但可选：没有它 gate 照跑，只关持久 SQLite 层。

第 1 步——跑 installer

Section titled “第 1 步——跑 installer”
Terminal window
npx @manhquy/flow-skill@latest

用 @latest 拿 skill v0.34.4（installer 0.7.11）。裸 npx @manhquy/flow-skill 可能被 npx 缓存 serving，悄悄重跑旧拷贝。

三件事发生：

  1. npm 下载当前发布的 installer。
  2. installer 列出这台机器检测到的 agent 交互多选。
  3. 把 skill 树拷进你选的每个家目录，例如 ~/.claude/skills/flow。

选你真用的 agent。以后加别的重跑这条命令。

第 2 步——重启 agent

Section titled “第 2 步——重启 agent”

skill 是磁盘上一堆文件；agent 启动时读那个目录。不重启，agent 不知道 skill 已经存在。

Agent 重启之后
Claude Code 输入 /flow
Codex CLI 重启一次，然后输入 $flow
Cursor / Agents home 重新加载工具，打开 flow skill
Antigravity 重启 IDE 或 agy，然后 /flow

第 3 步——检查环境

Section titled “第 3 步——检查环境”
Terminal window
bash ~/.claude/skills/flow/runner/flow.sh doctor

要 READY。doctor 跨 macOS、Linux、Windows 检查 bash、python、grep、git。缺 python3 报持久层关掉——那是降级模式，不是失败。别的，去安装出问题怎么办。

Windows PowerShell 调 runner\flow.cmd，别调 bash。PowerShell 里裸 bash 通常解析到 WSL，读不了 C:/... 路径，好好的安装看着像坏了。

确认 installer 对 skill 版本号是可选深度。见两个版本号。

打印两个版本号
Terminal window
npx @manhquy/flow-skill@latest --help
# expect: flow-skill v0.7.11 (ships skill v0.34.4)

installer 打印自己的版本和它带的 skill 版本。再从磁盘读 skill 版本：

Terminal window
grep -E '^\s*version:' ~/.claude/skills/flow/SKILL.md | head -1

两个数字各走各的。别从本页抄数字。

第 4 步——说你想做什么

Section titled “第 4 步——说你想做什么”

动词一个不用学。全新 agent session，项目目录里，打：

“我想给我的店做个库存应用。”

或打 /flow（Codex：$flow）。

concierge 先跑 status 命令拿机械 ground truth，问一个关于谁起草产物的人话确认问题，给恰好一个下一步动作。手打的 /flow 动词永远赢对话路由。

Claude 上路由稳。Codex 或 Antigravity 上，对话路由当尽力而为，打动词。完整说明在日常循环。

成功是任何一个：状态、一个下一步动作、一次 gate 结果。“concierge 说 yes” 本身不是奖杯。

你现在有了什么

Section titled “你现在有了什么”
  • skill 装进至少一个 agent 家目录。
  • agent 重启过，看得到 skill。
  • harness 的一个回答：状态、下一步动作、或 gate 结果。

下一步

Section titled “下一步”

在走完一个完整项目里带真实项目走过每个规划 gate，或读双层 harness弄懂谁在审你的文件。

看一次 gate 拒绝

Section titled “看一次 gate 拒绝”

可选深度。机械层活着的确定性演示。在 gate 毙掉也有效。

空 Idea 文件实录

建空目录，agent 在那打开。要第一 stage：

/flow next

runner 脚手架 flow/00-idea.md，立刻 gate 检查。你还没写任何东西，它拒绝：

FAIL: gate for stage 00-idea is not clean.
  [x] unchecked gate boxes:
      L4:- [ ] The pitch below is 3 sentences, no more
  [x] unfilled [FILL] placeholders:
      L10:[FILL: sentence 1 — who has the problem]
Fix the above, then run '/flow next' again. (Kill at a gate is also valid.)

这就是安装在干活。机械层读了文件，找到没打的框和没填的占位符，带着行号非零退出。它不替你填，也永远不会。