SuperAPI AI 工具集

preview-spec

通用与其它

查看项目

更新于 10-16 01:29

技能介绍

用途:把评审者手动点击预览验证 UI 变更的过程,变成智能体可执行的规范工件。author 操作从已有来源(aw 规划器的 specs.md、/fix-bug 复现工件)或 diff 生成规范,以标记的折叠块注入 PR 正文;run 操作从 PR 正文提取规范,解析预览 URL,通过选定驱动执行并报告判定。

主要能力:规范语法(WHEN/THEN/AND、定位器迷你语法、url:、network:)复用 aw-tester 的 specs.md.template,不另起分支;执行契约由 spec-run-contract.md 定义;两个运行器 aw-tester(Playwright 子智能体)与 aw-tester-chrome(会话内 Chrome)共用同一契约,用 --driver 选择 auto/chrome/playwright;浏览器上下文来自 aw-target.yml;双向经验循环由 aw-tester-lessons 与 preview-spec-lessons 承担。

使用方式:解析 $ARGUMENTS,首个 token 选择操作。author 先读记忆,优先复用已有规范来源,否则读 diff 为每个用户可见行为写一个 ## Spec N: 块,再写入 PR 正文。run 从 <!-- preview-spec:v1 --> 标记间提取规范,解析预览 URL,在 .agent/{branch}/.preview-spec/ 下生成临时 specs.md 与 aw-target.yml 覆盖层,按 --driver 执行并报告 pass/fail/inconclusive。

限制:author 不接触浏览器、不接受 --driver;run 的 URL 解析依赖 GitHub deployments API,在 mcp 路径下必须显式传 --url,否则报告 inconclusive 并停止。不得分叉规范语法、不得为通过而弱化规范、不得在规范或目标文件中存放密钥。运行器只报告不修复。