SuperAPI AI 工具集

runtime-evidence-and-tracing

测试与质量

查看项目

更新于 10-16 05:45

技能介绍

用途:把交互式或运行时验证与可追溯证据绑定,让“已测试”的说法有运行 ID、请求 ID、日志、截图、交互记录或追踪支撑,并用于诊断生产或测试环境问题。

主要能力:查找请求入口与现有请求/日志/追踪传播点;设计运行 ID、请求 ID、产物包与采集命令;确认调用面能否生成或传播 X-Request-ID 与 X-Harness-Run-ID;设计 artifacts/runs/<run_id>/ 目录,含 manifest、summary、logs、network、screenshots、trace 文件;定义采集顺序(启动、按需认证、操作、等待、读取产物、归因);定义阻塞分类:代码回归、环境不可用、外部依赖不可用、数据缺失、不可评估;说明 PR 或台账如何引用产物而不提交大型临时文件。

使用方式:先找请求入口与现有传播点,再设计 ID、产物包与采集命令,最后输出证据契约与验证路径,含回退与阻塞分类。缺少证据面时参考 references/build-when-missing.md;共享术语见 ../../references/harness-patterns.md;运行时配置与脱敏策略见 references/runtime-profile-policy.md。

适用场景:用户要求连接、诊断或设计交互式验证、运行时验证、请求 ID、追踪、日志、指标或产物;需从观察行为追溯到运行时证据;含外部依赖的流程需归类为代码失败、依赖阻塞、环境问题或数据问题。

限制与检查:请求 ID 与运行 ID 需在调用方、服务、任务与外部依赖证据间可检索;产物目录需含 manifest、summary 与可复现命令;截图、控制台、网络、日志与指标需覆盖失败边界;外部依赖或环境阻塞不得报告为产品质量失败;产物不得含令牌、手机号、真实密钥或敏感载荷。常见错误包括只留截图无请求 ID、仅单层追踪、把外部账号或配额问题当作产品质量失败、提交大型产物而非引用路径与摘要。