Optional typed decisions

AI 可以判断,
不能越权。

gf 用 Jev 处理语义不确定性,用确定性规则控制真实操作。

Jev 类型化决策信号经过多层校验后输出受约束结果
Jev 提供语义信号,gf 保留授权边界。

四种问题,四种明确边界

不用自由文本猜答案。每个问题先定义类型,再验证响应。

Noul

yes / no / unknown

适合阻塞、风险和合规边界判断。未知是合法答案,不强迫模型猜测。

Choice

closed set

模型只能在给定候选中选择,适合 Issue 类型、工作流模式和失败分类。

Score

ordered scale

在有序尺度上给出结果,适合优先级、质量和风险等级评估。

Batch

mixed questions

一次提交多种问题,返回与原问题集合严格对应的类型化响应。

先定义不能做什么

Jev 是建议层,不是权限层。工作流的安全属性在服务不可用时仍然成立。

显式启用

默认构建不含 Jev 适配器,运行时还需设置 GF_DECISION_PROVIDER=jev。

只读建议

Jev 响应不授权写操作,也不会绕过原有合同门禁和人工确认。

边界校验

请求大小、问题数量、选项范围、响应结构和超时都有硬限制。

安全降级

凭据缺失、超时或服务不可用时,调用方继续确定性规则或人工审查。

可离线复现

保存类型化响应后可离线评估、校准阈值并比较基线。

三条命令,显式接入

适配器不会随默认二进制静默启用。构建、凭据和运行时开关都需要明确动作。

安装适配器

已安装用户从 crates.io 重装,并显式启用可选的 gitflow-jev feature。

❯cargo install gitflow-cli --features gitflow-jev --force

仓库开发者也可运行 cargo build -p gitflow-cli --features gitflow-jev 从源码构建。

配置 TypeSafe Key

跨平台方式是由环境或密钥管理器注入 TYPESAFE_API_KEY。macOS 还可使用下方 Keychain 项作为环境变量缺失时的后备。

❯security add-generic-password -a "$USER" -s ai.typesafe.api-key -U -w

已有旧条目的用户可运行迁移命令,复制到新的共享服务名:

❯security add-generic-password -a "$USER" -s ai.typesafe.api-key -U -w "$(security find-generic-password -a "$USER" -s gitflow-cli-typesafe -w)"

显式调用

设置 provider 后,通过标准输入或 --input 传入请求。

❯GF_DECISION_PROVIDER=jev gf decide batch --input decision.json

TYPESAFE_API_KEY 优先于 Keychain;两者都与 gf auth 的 Git 平台凭据相互独立。不要把密钥字面量放进命令参数、请求文件、仓库或聊天记录。

Jev 已进入这些工程节点

只在规则难以覆盖语义时补充信号,不改变原命令的权限模型。

Issue 需求质量预检查与分流
PR 语义预检查与审查提示
CI 失败分类与流水线分析
Issue / PR 自然语言查询补全
工作流模式、上下文与进度建议
Skill 选择与语义回归评估

先离线验证,再决定是否上线

使用保存的响应评估准确率,按问题和数据切片校准阈值,再比较候选模型与基线。

阅读离线评估文档 →
gf decide eval \
  --fixtures tests/fixtures/decision/mixed-v1.json \
  --responses .cache/decision/saved.json

gf decide calibrate \
  --report .cache/decision/report.json \
  --question kind \
  --target-accuracy 0.99
Jev FAQ

关于 Jev 的常见问题

明确它是什么、如何接入,以及它不会获得哪些权限。

Jev 是什么?

Jev 是 gf 可选的 TypeSafe AI 决策适配器。它把语义判断约束为 Noul、Choice、Score 和 Batch 等类型化结果,供工程工作流读取和校验。

Jev 会直接修改 Issue、PR 或代码吗?

不会。Jev 在 gf 中只提供只读建议,不授予写权限,也不能绕过确定性规则、合同门禁或人工确认。

如何在 gf 中启用 Jev?

已安装用户运行 cargo install gitflow-cli --features gitflow-jev --force,仓库开发者也可在源码构建时启用 gitflow-jev feature。随后通过环境或密钥管理器注入 TYPESAFE_API_KEY,并在调用时显式设置 GF_DECISION_PROVIDER=jev。macOS Keychain 仅在环境变量缺失时作为后备;TypeSafe 凭据与 gf auth 凭据相互独立。

Jev 服务不可用时会阻塞工作流吗?

不会破坏原有安全边界。凭据缺失、超时或服务不可用时,调用方可以降级到确定性规则或人工审查。

把语义判断接进可审计的工程循环。