命令表
所有动词分发到机械引擎 bash <skill-dir>/runner/flow.sh <command>。Claude Code、Cursor、Antigravity 里打 /flow …；Codex CLI 里打 $flow …。Windows PowerShell 调 <skill-dir>\runner\flow.cmd <command>，别调 bash。
/flow status——我在哪，什么拦着/flow next 检查 gate + 解锁下一 stage/flow assess brownfield 评估/flow card 建一张构建 card/flow check C-001 验 card（完成 = 世间证据）/flow auto 自治构建（security-class 就 halt）/flow doctor 环境自检| 命令 | 干什么 |
|---|---|
/flow resume |
只读的 session-story 简报，中途进入项目用：上个 session（只报命令名，永远不报原始参数）、in-flight card 加 dwell、gate 状态、一行 NEXT ->。不拿锁。冷接手项目先跑它。 |
/flow（status） |
我在哪，什么拦着，NEXT -> 行（跟 resume 同一个 helper 产出）、当前 stage dwell、card 清单（十张之后压成摘要）、一行记忆摘要。 |
/flow recall |
读回持久记忆——open debt、最近 retro、上张 card 的 scope、harness 摩擦和 backlog、审计健康、playbook——stage 或 card 开工前跑。 |
/flow unlock |
崩掉或丢下的 session 之后，清这个项目的并发锁。 |
/flow doctor |
跨 macOS、Linux、Windows 的环境自检：bash、python、grep、git、安装路径。 |
stage 与规划
Section titled “stage 与规划”| 命令 | 干什么 |
|---|---|
/flow next |
检查当前 stage 的 gate；过了就解锁下一个（或从 stage 00 开始）。机械通过之后，施加刚过的 stage 的语义挑战。 |
/flow gate <stage> [--json] |
对一个 stage（或 --card C-NNN 对 card）的只读机械扫描：报 findings，不推进任何东西。推进是 next/check 的活。--json 出封闭的 gate.report 信封。 |
/flow assess |
brownfield：在规划之前脚手架并设 gate 于 flow/00-inspect.md 的现状评估。操作者评审。 |
/flow skip <stage> --reason |
跳过挂着对得上的 open debt 行的 gate。只非 security-class；stage 05 永远不能跳过。 |
/flow clarify |
列 Scope、PRD、Contract 上 ## Open decisions 下残留的 - [ ] bullet。建议性质，不是 next gate。 |
/flow constitution |
查操作者写的项目内不变量 flow/constitution.md。建议性质，不是 next gate。 |
/flow converge |
把现有代码往计划上收敛的只追加 remainder card。事务性——全写或全不写；永远不改已有 card；没口子打印 CONVERGED，什么都不写。 |
card 与构建
Section titled “card 与构建”| 命令 | 干什么 |
|---|---|
/flow card |
切下一张构建 card，六个规划 gate 全过之后才能切。 |
/flow card start|done C-NNN |
标 card in flight，或 CLI 接管翻成 done（走和 check 一样的规则——gate 不过就回滚）。跟手改共存。 |
/flow check C-NNN |
验 card：[FILL] 占位符、状态、必填节、完成证据。 |
/flow ready |
列可构建的 todo card，加并行安全提示。 |
/flow auto |
自治运行 preflight；auto stop 清掉。Tier-A 不问直接合，Tier-B 全新 subagent 修一次，Tier-C security-class halt。 |
/flow attest semantic|live-verify|status|recover |
铸造或查看背书执行控制面的指纹绑定证据。 |
/flow workspace add|list|enter|remove|check|doctor|port |
多 agent worktree 隔离：一个 agent 一棵 git worktree，并行跑不互相翻分支。workspace port 给每张 card 分确定性端口。 |
/flow loop-prep <card> |
给单数字目标迭代的 plumbing：隔离 worktree 加从 card allowed files 派生的数字 verify 命令。 |
/flow loop-log <card> --iterations N --start M --end K --outcome … |
把跑完的 loop 记进 usage telemetry。 |
| 命令 | 干什么 |
|---|---|
/flow mode [teach|work] |
看或设谁写 gate 产物。默认 teach。 |
/flow project-type [web|cli|library|skill] |
看或设项目类型，决定完成证据规则和 contract 接缝。默认 web。 |
/flow debt add|list |
在 DEBT.md 里记或列故意的 gate 跳过。security-class 项只操作者能记。 |
/flow rules [cursor|windsurf|roo|cline|aider|openhands|copilot|list] [--write] |
输出（或写入）workspace 规则脚手架，让第三方 harness 守 flow 的纪律。建议性质。 |
/flow contract、/flow tokens、/flow coherence、/flow consistency 各标一个轴的漂移，永远不自动修。四个合起来是格子：版本、URL、design token、产物之间还对得上对不上。
| 命令 | 轴 | 报什么 |
|---|---|---|
/flow coherence |
版本 | 各版本声明字段之间的漂移——文档对代码的便宜切片 |
/flow contract |
URL | 客户端 base-URL 对 served-path 前缀漂移，schema diff 工具漏掉的双 /api 和混前缀类（web） |
/flow tokens |
设计 | DESIGN.md 声明的 token 对实际用的 CSS：没用的 token、值对不上、孤儿变量 |
/flow consistency |
可追溯 | 每个 PRD FRn 都被 card 认领、被 contract 接口服务，有数字成功指标，没残留占位符 |
contract gate 之后、切 card 之前跑 consistency 和 coherence。建它们描述的面的时候跑 contract 和 tokens。
/flow design <file> 是相关的机械检查，针对单个 UI 文件，不是全项目扫。
描述和时机：README.md
持久层与知识
Section titled “持久层与知识”| 命令 | 干什么 |
|---|---|
/flow harness <args> |
透传给持久层 CLI：intake、story、trace、decision、backlog、query、audit、propose，外加 init、tool、intervention、promote-suggest、rollup、usage、prune、graph、journal。 |
/flow promote <file> |
把 playbook 拷进跨项目知识库 ~/.claude/flow/playbooks。 |
/flow usage [--global|--prune] |
把本地 JSONL usage 日志卷成构建分析：周期、gate 挂率、每 stage 每 card dwell、命令分布。只在本地。 |
/flow retro |
打印三个 retro 问题。操作者写那行，永远不是 agent。 |
harness 子命令
Section titled “harness 子命令”/flow harness <args> 透传给持久层，flow 自有的 Python 加 SQLite CLI，存 session 之间活下来的东西。
| 子命令 | 干什么 |
|---|---|
intake |
按类型、摘要、flag 记一条进来的请求；auth 这类风险 flag 自动升级 lane |
story |
跟踪一个工作单元和它的证据。用 story complete --proof-source … 关闭它 |
trace |
card check 通过时写的 tier 打分记录 |
decision |
记一个决策，日后拿实际结果闭环 |
backlog |
propose 写进去的改进 backlog |
query |
把记录读回来 |
audit |
给积累的记录打熵和漂移分 |
propose |
把重复摩擦和干预挖成 backlog 项；确定性，两次及以上触发 |
init |
建或升级 harness 数据库 |
tool |
按 kind 的 inbound 工具和能力注册表 |
intervention |
记一次人、评审、CI、agent 的 override |
promote-suggest |
从重复摩擦和干预起草 playbook 建议 |
rollup |
把 JSONL usage sink 灌进 usage 库（幂等） |
usage |
从 usage 库打印 usage 分析 |
prune |
每个 JSONL sink 只留最后 N 行（crash 安全） |
graph |
图执行器：记录和推进 journal |
大多数是引擎替你写的——走过 stage 种 intake，通过的 check 记 trace——所以手动面主要是读。这一层可选：没有 python3 gate 照跑，只关这个库。
schema、flag、实时权威表：skills/flow/harness/README.md
| 命令 | 干什么 |
|---|---|
/flow eval [--stage 01|02|05|card|routing|converge] [--fixture <id>] [--n 3] [--timeout <s>] |
语义 gate 的行为证据：模型真拦得住空洞但机械干净的 fixture 吗？自愿开，计费；没 claude CLI 零调用干净跳过。 |
/flow eval --report |
离线，零调用：上个完整批的记分卡，加对上个批的漂移。 |
/flow eval --replay |
无 key 重放存好的 fixture——零模型调用。fixture 缺失或过期 exit 1。verdict 永不计入 eval floor。 |
/flow eval --diff <old> <new> |
离线 fixture 回归分类器：两个批对照 baseline 比。 |