SuperAPI AI 工具集

jflow

编程与开发

查看项目

更新于 11-05 17:10

技能介绍

用途

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 需额外开启网络访问参数。资料未提供安装方式、价格、许可或其他平台支持信息。