装上 skill，然后说你想做什么。

安装

你需要 Node.js 22.14 或更高，以及一个 coding agent：Claude Code、Codex、Cursor 或 Antigravity。

npx @manhquy/flow-skill@latest

当前配对：skill 产品 v0.34.4，npm installer 0.7.11，都在 @latest 上。不要 npm i 这个包，那不会复制 skill。也不要在 npm 上 pin skill 的版本号。

会发生什么：installer 检测 agent，你选家目录，skill 落盘（例如 ~/.claude/skills/flow）。

然后重启 agent。不重启，agent 不知道 skill 已经存在。

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

可选：bash ~/.claude/skills/flow/runner/flow.sh doctor 应该打出 READY。

--help 会打印 installer 和 skill 两个版本号。这是两个数字。见两个版本号。

你会得到什么

三个能力。第一个在 npx 之后即有，后两个要等你走完 gate 或关闭一张 card。

1. 一次诚实的拦截。 文件为空、伪造、或注水，/flow next 就不会放行下一个 stage。毙掉这个想法是合理的。这是 gate 的拒绝，agent 本人照常运行。
2. 走完 gate 后，仓库里多一份书面计划。 flow/ 下六个文件，然后是 cards/ 下的 card。另一个 session 可以冷启动接上。光装完，这些文件一个都没有。
3. 完成意味着东西真实存在。 上线的 URL、装得上跑得起来的 CLI、可导入的 API，或一次真实跑通的 skill。不是一句 “tests pass”。

首次运行——一条命令，一次重启，一次检查。

npx @manhquy/flow-skill@latest
# 重启 agent
# 在项目目录里：
我想给我的店做个库存应用。
# 或者输入 /flow （Codex：$flow）

对话是入口。手打的 /flow 永远优先。concierge 只问一个确认问题，再给一个下一步动作。在 Claude 上路由很稳；在 Codex 或 Antigravity 上把对话当尽力而为，直接打动词。完整说明在日常循环。

本页的成功标准：skill 已落盘，agent 已重启，你说出了要做什么或输入了 /flow，harness 回了状态、或一个下一步动作、或一次 gate 结果。

长版本，含“看一次 gate 拒绝”：安装与首次运行。

常用命令

你想	输入
我在哪？	/flow
前进或被诚实拦下	/flow next
切一个构建切片	/flow card
拿出证据	/flow check C-001
已有代码库	/flow assess
机器自检	/flow doctor

Codex 用 $flow。完整表格：命令表。/flow auto 是进阶内容，见工作何时必须停下。

流程即任务

Idea → Research → Scope → PRD → ADR → Contract，然后是 card，然后是 Retro。文件名就写在任务旁边：flow/00-idea.md … flow/05-contract.md，不是标题。

Contract 是唯一不能跳过的 stage。见为什么 contract 永远不能跳过和工作何时必须停下。

已有仓库从 /flow assess 开始（评估 brownfield）。teach 和 work 只差一个确认问题；gate 一模一样（teach 对 work）。

不要在这里展开完整流程。去走完一个完整项目。

卡住的时候

• 冷启动接手项目 → 中途接手
• 解开死掉的 session → 解开过期 session
• 安装排错 → 安装出问题怎么办

了解更多

• 两层如何协作 → 双层 harness
• 为什么 “tests pass” 不算完成 → 完成意味着世间的证据
• 工作何时必须停下 → 工作何时必须停下
• 为什么有两个版本号 → 两个版本号
• 架构 → 三层
• 命令表、术语表、更新日志
• 进阶（auto、attest、额外引擎）→ Agent 编排

如果只是想装上跑起来，读到这里就可以停了。