SuperAPI AI 工具集

verify

测试与质量

查看项目

更新于 10-15 23:42

技能介绍

用途 verify 用于验证一次改动在运行时是否真的工作。它不依赖通过的单元测试,而是运行真实应用、亲自观察结果,例如页面是否渲染、按钮是否提交、接口是否返回正确结构、任务是否完成。它是 /test 的运行时对应物:/test 编写长期运行的断言,verify 则由工程师在评审前打开应用确认功能为真。

主要能力

  1. 从 git 变更中梳理出可观察行为的清单;若存在治理用的 ADR,则锚定到其验收标准。
  2. 按项目自身方式启动应用,优先复用项目已有的启动脚本或技能。
  3. 对改动流程进行实际操作并观察结果,包括 UI 截图、API 响应体、CLI 输出、任务日志。
  4. 按行为与验收标准报告通过或失败、异常情况,并指出哪些内容应交给 /test 变成永久断言。
  5. 支持两种模式:功能模式确认新增或变更行为;重构/回归模式通过前后对比证明行为未变(会使用 git worktree 或 git stash --include-untracked)。
  6. 若存在带编号验收标准的 ADR,额外进行规格一致性判定,逐条给出 met、specced-but-missing、specced-but-not-applied 或 blocked,只要有一项缺失或未生效,总体判定即为 FAIL。
  7. 根据功能所属构建方式校准工作含义,避免对原型提出过高的真实后端要求,也避免放过理应验证的路径。

使用方式 通常在 /develop 之后运行 /verify。它会自行从 git 确定范围、推断启动方式、运行并观察,只有在无法确定如何启动或该执行哪个流程时才会询问。它不会修改应用代码,发现问题只报告并指向 /debug 或 /develop。它不拥有持久文件,只输出聊天结果,截图和日志保存在临时区域。

适用场景 需要在评审前确认改动真实可用时;需要对照 ADR 验收标准验证契约一致性时;进行行为保持不变的重构并需要前后差异对比时;项目没有测试运行器,需要靠观测输出兜底时。

限制 不修复代码、不编写测试、不写上下文文件。跨平台适用于 macOS、Linux、Windows 上的任意 Agent Skills 客户端,但驱动浏览器和截图依赖客户端能力,若客户端不支持,则需描述手动步骤让工程师自行运行并回报。具体启动命令、凭据、种子数据等若资料未提供,需在执行时向工程师确认。