用途
jflow 是一条用于交付代码变更的“短路径”,把工作拆成规格、实现、验证、收尾几个阶段,每个阶段由独立会话执行。它的核心主张是:改动是否完成,由一次全新会话在真实环境上对照答案键作出的证明来决定,而不是对 diff 的讨论。人类决定做什么,构建方决定怎么做,验证方决定能不能用。
tool 的命令形式为 jflow spec <slug>、jflow build <slug>、jflow prove <slug>、jflow review <slug>、jflow done <slug>。单独的 jflow <slug> 会读取运行目录,打印第一行成立状态对应的卡片。
主要能力
- spec:由一个全新会话与人类一起写出 spec.md 和 Proof 表,逐行定义“通过”长什么样。spec.md 即答案键,之后只读;只有 jflow spec 在人类确认后才能修改,且修改后每一行都要重跑。
- build:由全新构建会话实现改动,该会话在后续所有修复中被保留;构建方的判断记录在 notes.md 中。
- prove:每份证明都在全新会话中进行,且与构建方来自不同厂商,以避免同一厂商会话的盲区。每份回执为 receipts/prove-N.md,从 1 开始编号,可附证据。
- review:独立只读审查,每轮为全新会话,回执为 receipts/review-N.md。
- done:在同一构建会话、同一模型下完成收尾。
- 状态驱动:代码改动通过提交 SHA 判定,回执本身的提交会移动 HEAD,但 .jflow/ 下的文件不计入“改动”。
使用方式
模型与推理强度按命令分工(picker ID 包括 claude-opus-5.5、claude-sonnet-5.5、gpt-6.1-terra、gpt-6.1-sol):
| 命令 | 模型 · 强度 | 会话 |
|---|---|---|
| jflow spec <slug> | Opus 5.5 · high | 全新,与人类一起 |
| jflow build <slug> | Opus 5.5 · high | 全新;构建会话,所有修复沿用 |
| jflow prove <slug> | GPT-6.1 Sol · high;每行均为现成命令时用 GPT-6.1 Terra · medium | 每次证明均为全新 |
| jflow review <slug> | GPT-6.1 Sol · high | 每轮审查全新,只读 |
| jflow done <slug> | 同模型,构建会话 | 构建会话 |
若构建方使用 OpenAI,则 prove 改用 Sonnet 5.5 · high,review 改用 Opus 5.5 · high。资料称,2026-11-04 的实测中 Terra 能较好执行现成检查,但在需要自己编写驱动时放弃;跑在错误厂商上的会话会在第一行和回执中说明,然后继续执行。
各命令完成后,需先提交该步骤产生的文件,再输出收尾卡片;卡片是当轮最后输出,内容形如:
Next: <exact message to send>
Model: <model · effort>
Session: <fresh | builder session>
执行 prove 或 review 的会话会在消息中把回执路径交给构建方,例如“Fix .jflow/<slug>/receipts/prove-2.md, then print the card.”。当构建会话无法恢复时,由构建方模型上的新会话接手分支、spec.md、notes.md 和未结回执,并在 notes.md 中说明。
在 Codex 中运行 prove 需加参数 -c sandbox_workspace_write.network_access=true,资料称 2026-11-04 在 Codex 0.166 上实测,本地测试客户端在默认沙箱中会卡住。
人类阅读的一切内容遵循 plain skill 的规则:在第一条消息前调用一次;每个问题只承载一个决定,选项用字母标出,推荐项置于最前并带 ➡️。
运行目录与状态推进
运行状态存放在 .jflow/<slug>/,受 git 跟踪,并与 .workflow/ 使用不同根目录,避免其他技能的状态或钩子读取:
.jflow/<slug>/
spec.md 规格与 Proof 表,由 spec 写入,之后只读
notes.md 构建方的判断,少量几行
receipts/prove-N.md 每份证明一份,从 1 编号,可附证据
receipts/review-N.md 每轮审查一份
下一步判断依据状态:
- 无 spec.md 或 Status: drafting → jflow spec
- Status: ready 且 Base 之后无提交 → jflow build
- 自最新 prove 回执的 sha 以来代码有改动,或尚无回执 → jflow prove
- 最新 prove 回执为 BROKEN → 回到构建会话并附上该回执
- 最新 prove 回执为 BLOCKED 或 UNREACHABLE → 由人类按 references/prove.md 决定
- 所有行 PROVED、Review: required、自最新 review 回执的 sha 以来代码有改动,或尚无回执 → jflow review
- 最新 review 回执存在缺陷 → 回到构建会话并附上该回执
- 其他情况 → jflow done
- Status: done → 无事可做,直接说明
轮次设有上限,因为尚未收敛的循环需要人来处理:出现 BROKEN 后,一行允许两次重新证明;review 最多两轮,绝无第三轮;由 review 修复引发的重新证明不计入该上限。达到上限即停止,并把未结事项交给人类。
适用场景
适合希望以可验证证据判断代码变更是否完成、愿意在会话中承担决策与确认职责的团队或个人;也适合需要将“答案键”与实现分离、由独立方验证的交付流程。每个步骤都可以作为普通消息在人类启动的会话中、在任意 CLI 里运行。
限制
流程依赖多个指定模型和不同厂商的会话分工;prove 与 review 必须与构建方不同厂商。人类必须参与规格确认和受阻情形下的决策。Codex 中 prove 需额外开启网络访问参数。资料未提供安装方式、价格、许可或其他平台支持信息。