SuperAPI AI 工具集

jev-assert

测试与质量

查看项目

更新于 10-16 06:49

技能介绍

用途:把自然语言描述的用户可观察 UI 结果,转化为一次可执行的语义判定,并输出供仓库其余部分消费的 verify-behavior 回执。它属于只读验证原语,是 verify-behavior 的语义同类。

主要能力:读取页面捕获的文本状态(无障碍快照或页面文本),向 TypeSafe 的 Jev 模型发出一个窄判断,返回带概率的定型答案(Noul / Choice / Score),最终产出一行回执,例如 tier、tool、target、question、jev 概率和 verdict。五种判定及各自发出条件由 rules/receipt-mapping.md 规定;null(已运行但无支持)与 unobtainable(无法运行)严格区分。Jev 只处理文本,截图不是合法输入。

使用方式:三步工作流各有闸门——步骤 0 来源守卫(期望必须是用户可观察的结果,不能是状态文本的复述)、步骤 1 状态抽取(捕获文本状态)、步骤 2 Jev 调用与映射。调用者提供页面文本状态与期望;可用 --state-file 传入状态文件,省略时从 stdin 读取;--threshold-high 与 --threshold-low 可覆盖默认判定区间。具体调用路径是零依赖脚本: node ${CLAUDE_SKILL_DIR}/scripts/jev-call.mjs --expectation "<expectation>" --state-file <captured-state.txt> --target <page-or-spec-id> API 由 TYPESAFE_API_KEY 环境变量鉴权;未设置密钥或 API 不可达时脚本发出 unobtainable,绝不猜测通过或失败。可运行 node ${CLAUDE_SKILL_DIR}/scripts/jev-call.mjs --self-test 离线验证映射。

适用场景:共享 UI 规格语法中的语义 THEN 断言,例如在 WHEN 点击某按钮后写 THEN semantic: 用户看到订单确认编号。两个 runner(aw-tester 与 aw-tester-chrome)会捕获页面文本、调用本技能并把回执并入规格判定:confirms 通过,contradicts 或 null 失败,ambiguous 或 unobtainable 规格结论不确定,绝不静默通过;ui-verify 复用同一语法。

限制:只发回执不发评分;只接受文本输入;期望不能是复述已读到的状态文本;不可达或缺少密钥只会得到 unobtainable;不在驱动层面区分 Playwright 与 claude-in-chrome;不替代 typesafe@typesafe-ai 技能提供的 API 指南。安装、收费与价格信息暂未提供。