SuperAPI AI 工具集

qa-testing

测试与质量

查看项目

更新于 10-15 14:56

技能介绍

QA Testing 用于在宣布页面、功能或站点已交付之前,验证其是否正常工作。该技能与技术栈无关,通过控制台代码片段驱动,以提升速度。官方说明指出,它比 accessibility-audit 更快(后者深入 WCAG),也比 performance-optimization 更快(后者深入 Core Web Vitals)。一般 QA 使用本技能;深度审计使用对应的专门技能。

【何时使用】 每次部署后(smoke 测试);启动新页面或功能后(standard 审计);重大发布前(full 发布矩阵);排查“看起来不对”的报告;上线前验证站点或板块。

【何时不使用】 深度可访问性合规工作(使用 accessibility-audit)。深度性能调查(使用 performance-optimization)。代码审查或调试(使用 code-review-web)。网站初始设置或技术 SEO 基线(使用 seo-technical)。

【所需输入】 待测页面的 URL 或站点;所需 QA 层级(smoke、standard 或 full);浏览器开发者工具访问权限;除标准层级外需要检查的任何特定关注点。

【三个层级框架】 QA 随风险等级而扩展,根据情境选择合适层级。

Tier 1 Smoke:每次部署后运行,约 2 分钟,仅检查关键信号。通过标准:标题存在且 30 到 60 个字符;canonical 指向生产域名(绝不能是 staging 或 preview URL);恰好一个 H1;零个缺失 alt 属性的图片。装饰性图片使用空 alt="" 是正确标记,可通过;只有属性缺失才失败;零个破损图片;每个 schema 块均可解析。如果任何一项失败,在修复 smoke 问题之前,不要继续进行更深入的测试。

Tier 2 Standard:新页面或功能使用,约 10 分钟,覆盖页面基础、可访问性和结构。在 smoke 基础上增加:元描述 120 到 160 个字符;og:image、og:title、twitter:card 存在;H2 存在且具有描述性;所有带 target="_blank" 的外部链接都有 rel="noopener";页面声明语言(<html> 上的 lang 属性);存在 favicon。Standard 额外要求:在 375px、768px 和 1440px 下进行视觉审查。Standard 有意跳过 1024px;Full 层级会连同模板的响应式检查清单一起涵盖它。同时测试主要用户流程。

Tier 3 Full:重大发布、上线前使用,约 30 分钟以上,全面覆盖所有维度。维度包括:smoke 和 standard 全部通过;可访问性基础(运行浏览器审计工具,如 Lighthouse,得分高于 90);性能基础(报告模板 Performance 清单中的每个阈值,包括 INP);移动端响应式(报告模板响应式清单中的每个视口);跨浏览器(在 Chrome、Safari、Firefox 中测试,如受众相关也包括 Edge);表单(所有表单成功提交并正确验证);内部链接(无破损内部链接,随机抽样 20 个);外部链接(全部返回 200,抽样 10 个);Sitemap(返回 200,仅列出 canonical URL);robots.txt(允许生产爬虫,如适用则阻止 staging);安全响应头(存在 HSTS、X-Frame-Options、X-Content-Type-Options);HTTPS(所有资源通过 HTTPS 加载,无混合内容);404 处理(404 页面返回 HTTP 404,而非软 200);Schema 验证(所有 schema 在 Rich Results Test 中验证通过);分析(关键用户操作上的事件按预期触发);缓存行为(缓存头适合页面类型)。

对于响应头,运行 fetch(window.location.origin, { method: 'HEAD' }) 并检查 strict-transport-security、x-frame-options、x-content-type-options。

【特定 QA 代码片段】 资料提供了图片审计、标题层级检查、对比度抽查、表单审计(按表单)、外部链接审计等具体代码片段。

【工作流】

  1. 选择层级。日常部署用 Smoke,新工作用 Standard,发布用 Full。2. 运行代码片段。粘贴相应控制台代码片段,审查输出。3. 记录失败项。每个失败项要么在交付前修复,要么作为已知问题记录。4. Standard 层级补充:在 375px、768px 和 1440px 下视觉审查;测试主要用户流程。5. Full 层级补充:跨浏览器测试、Lighthouse 审计、schema 验证、安全响应头、404 处理。6. 记录。完整审计使用 references/qa-report-template.md 中的模板。

【失败模式】 在“小型”部署上跳过 smoke 测试;运行了片段但不阅读输出;仅做视觉 QA;单浏览器测试;没有移动端 QA;只给通过/失败而不给补救。

【输出格式】 Smoke 测试:控制台输出即报告。Standard 和 Full 审计:在 qa-report-[date].md 生成 markdown 报告,使用 references/qa-report-template.md 中的模板。

【如果所需数据不可用】 该技能的输出依赖于它无法自行生成的数据、测量结果或工具结果。当所需的输入、工具或数据源不可用或无法验证时,获准的输出是带缺口说明的交付物:需要什么、实际获得或验证了什么、输出的哪些部分受影响。编造、估计或插值所需数字来完成交付物绝不获准。说明缺口就是完整答案。

【参考文件】 references/qa-report-template.md:用于 standard 和 full 审计的 Markdown 报告模板。