SuperAPI AI 工具集

product-validation

通用与其它

查看项目

更新于 10-16 03:40

技能介绍

用途:使用真实产品判断某个已验收旅程是否可用,实现、验收契约与验证工具一律视为只读;只改动被授权的验证状态,判断期间不得修复产品。最终交付验收应在与实现和完工的智能体不同的新上下文中运行;切片通过可在原角色内使用本方法,但不算独立最终验收。以直接观察为准,不采信总结或全绿技术套件。

判定依据:从实现规格或其他明确验收来源读取已验收旅程,需要包含所受判断的 commit、构建、部署版本或精确工作树状态,参与者与起始状态,用户动作,必需可观察结果及实质禁止结果,环境、身份与测试数据,隔离或重置与清理边界,以及可区分成功与失败的证据。缺少或模糊关键判据时返回 Inconclusive 并说明缺失的决策点,不得虚构、弱化或按当前行为改写判据。

方法选择:接口为 API 或 CLI 时直接操作该接口。图形产品在目标运行时操作并观察真实应用,按顺序使用第一个可用控制器并记录跳过前者的原因:先 Manuvra,运行 manuvra version,成功后加载 manuvra 技能、确认运行前提并作为 Manuvra 作业运行旅程;调用方报告本次运行中 Manuvra 在同一能力上已失败时跳过该能力并记录原因。其次使用测试框架自带的原生浏览器或计算机使用。最后是临时驱动:使用项目已有浏览器库的未提交脚本,仅本次验证运行,记录原因与保真度限制;修复其自身选择器或等待属于驱动旅程,一旦需要新夹具、共享辅助或其他可复用测试框架工作则返回 Inconclusive。执行前查看项目启动与数据流程,缺少自动化驱动本身不构成阻碍。仅在直接使用确立行为且有具体重复回归需求时才提议新增 E2E 自动化。使用能保留旅程实质语义的最窄真实产品接口,确认实例、版本、配置、身份与数据为预期目标,可用时运行健康或 doctor 检查,拒绝模糊或陈旧目标。控制工具报告操作与观察,裁决由产品验证者依据已验收旅程得出,不得把工具汇总成功或 Pass 标签直接当作产品验收。源码检查与技术测试可用于定位或诊断,但除非该技术面本身就是已验收的公开产品接口,否则不能为未执行的旅程产生 Pass,需记录模拟或替代的保真度限制。无可用方法忠实驱动或观察旅程时,返回 Inconclusive 并说明缺失能力,不把验证扩展为基础设施工作。

影响与状态保护:外部、生产、计费、破坏性、隐私敏感或其他有后果的操作,需有针对具体影响与环境的限定授权,或保留实质语义的已验收安全替代;否则不得执行。只使用本次运行创建或明确分配的验证状态,不得按惯例重置、清理或复用他人状态;只清理本次运行自有内容并保留裁决所需证据,证据中不得包含密钥和不必要的个人数据。

执行旅程:通过选定产品面执行已验收动作,捕获动作与结果状态,而不仅是最终截图或自述;当持久化或外部副作用重要时,通过独立的忠实只读观察通道确认。保留所受测试版本的首个失败和最早可观察偏差;重试可区分非确定性或环境问题,但同一版本后续成功不抹去原始结果。修复或版本变更后,将先前失败保留为原版本证据,并依据新的适用证据重新裁决。除非验收契约包含,不得把探索性用例或相邻回归要求加入验收裁决。相关变更后,识别其使哪些观察失效并重跑这些路径,包括依赖它们的下游行为;可直接确定适用性的证据可复用,只有整体失效时才重跑整个旅程。

返回裁决:只返回一个总体裁决。Pass 表示全部必需观察发生且无实质禁止结果;Fail 表示必需结果缺失、错误、不安全或被另一忠实观察否定;Inconclusive 表示判据、授权、驱动、环境、隔离边界或可观察预言缺失,无法作出有依据判断。报告版本、旅程、所用控制器及保真度限制、环境与数据、观察、证据位置、清理结果与裁决。浏览器旅程需包含 Manuvra 探测结果及跳过每个更早控制器的具体原因。Fail 需包含最早偏差与最短忠实复现;Inconclusive 需说明能解除阻塞的确切能力、决策或授权。将发现交还调用方,不编辑产品代码、验收契约或验证工具。在交付场景中,Fail 会变成有边界的集成修复;代码变更使相关证据失效,必须重新验证。

完成标准:已验收旅程针对指定产品版本有直接可复现裁决,或有确切解除条件说明为何无法给出诚实裁决;实现与验收契约未变,自有验证状态已清理,裁决证据可用且不暴露敏感数据。