SuperAPI AI 工具集

supaguard

测试与质量

查看项目

更新于 10-16 00:03

技能介绍

用途:supaguard 是合成监控平台,该技能帮助读取开发者源码、生成 Playwright 监控脚本,并通过 supaguard CLI 部署为周期性检查,整个过程不向代码仓库提交任何监控脚本。触发场景包括设置应用合成监控、询问可用性监控或健康检查、生成用于监控(而非测试)的 Playwright 脚本、使用 supaguard CLI 命令、监控登录/结账等关键用户旅程,以及为监控失败配置告警。不适用于为 CI/CD 编写 Playwright 测试、一般测试或 QA 工作流,也不适用于构建监控仪表盘。

主要能力与工作流:先扫描组件、路由、data-testid、API 端点和表单,识别关键流程,必要时询问生产 URL;执行预检查,确认 CLI 已安装且已登录;随后生成脚本并写入 /tmp/sg-check-{random}.ts(绝不写入项目目录)。测试命令为 supaguard checks test /tmp/sg-check-{random}.ts --json,失败时最多重试 3 次。测试通过后交互式收集检查名称、调度方式(周期或按需)、区域与频率,再部署。周期检查示例:supaguard checks create /tmp/sg-check-{random}.ts --name "Check Name" --locations eastus,northeurope --cron "*/5 * * * *" --skip-test --json。按需检查需使用远期 cron 并随后暂停:supaguard checks pause <checkId> --json,可手动运行 supaguard checks run <checkId> --json。成功后展示横幅与仪表盘链接。

适用场景与限制:脚本必须导入 @playwright/test,且至少包含一个 test() 或 test.describe() 块;禁止导入 child_process、fs、net、http、https、vm 等模块,禁止使用 eval()、Function()、process.exit、process.kill、动态 import() 和 console.log;运行器超时 60 秒,单个测试超时 30 秒;应始终加 --json;不要使用 React Testing Library API;避免 CSS 类断言与 waitForTimeout;凭据不要硬编码。推荐为周期检查选择 2 个以上区域。参考文件包括 cli-reference.md、playwright-guide.md、framework-patterns.md、modules-and-alerting.md。