SuperAPI AI 工具集

oma-qa

测试与质量

查看项目

更新于 10-15 18:31

技能介绍

用途

oma-qa 是一个质量保证(QA)审查技能,目标是以安全性、性能、可访问性、正确性、测试覆盖率和符合标准的质量证据为优先,对软件质量进行审查与验证。它面向需要审查、QA、安全审计、OWASP、性能、可访问性、覆盖率、lint、测试或 ISO/IEC 质量建议的场景,输出带有证据、严重程度、文件引用和具体修复建议的发现。

主要能力

  • 部署前的最终审查
  • 安全审计(OWASP Top 10)
  • 性能分析
  • 可访问性合规(WCAG 2.2 AA)
  • 测试覆盖率分析
  • 按严重程度排序的发现报告,包含证据、文件/行号引用和修复方案
  • 测试、安全、性能、可访问性和质量方面的建议
  • 验证摘要与残余风险说明

使用方式

该技能按结构化流程运行:

  1. 入口:识别审查范围和质量维度,收集 diff、文件、命令和标准上下文,在可行时优先选择自动化检查再进行人工审查。
  2. 场景阶段:
    • PREPARE:定义范围、严重程度评分标准和证据要求。
    • ACQUIRE:读取 diff/代码并运行相关自动化工具。
    • REASON:分析安全性、性能、可访问性、正确性和测试覆盖率。
    • VERIFY:复现发现并排除误报。
    • FINALIZE:报告发现、修复建议、测试缺口和残余风险。
  3. 转换规则:若存在安全问题,优先于性能/可访问性/代码质量处理;若自动化工具不可用,记录该限制并改为人工检查;验证完整性与缺陷严重程度分开记录,缺少证据会使审查变为部分完成或受阻,而非确认缺陷或通过;若无发现,需说明并指出剩余测试缺口或残余风险;若要求基于标准的审查,使用 resources/iso-quality.md。
  4. 失败与恢复:若文件或 diff 不可用,请求范围或审查当前工作树;若发现无法复现,不作为发现报告;若修复需要领域实现,转交相应专家。
  5. 退出:成功时发现按序排列、有证据、可复现且可操作;部分成功时明确不可用工具或未验证区域。

预期输入包括:diff、代码库区域、PR、功能分支、构建输出、测试结果或质量关注点;适用的标准如 OWASP、WCAG、ISO/IEC 25010 或 ISO/IEC 29119;以及可用的验证命令和目标环境。

预期输出包括:按严重程度排序的发现,含证据、文件/行号引用和修复;测试、安全、性能、可访问性和质量建议;验证摘要和残余风险。

依赖项包括:resources/execution-protocol.md、ISO 指南和检查清单;适用时的自动化工具,如 npm audit、bandit、lighthouse、linters、测试和覆盖率工具。

规范命令路径示例:

npm audit
bandit -r .
lighthouse <url>

仅运行与检测到的技术栈和可用目标匹配的工具。在报告发现前,若可用,添加项目的 lint/test/coverage 命令。

适用场景

  • 部署前的最终审查
  • 安全审计(OWASP Top 10)
  • 性能分析
  • 可访问性合规(WCAG 2.2 AA)
  • 测试覆盖率分析

限制

  • 不用于初始实现,应先由专家构建
  • 不用于编写新功能,应使用领域智能体
  • 读取代码并报告;可运行工具;通常不应实现广泛的功能工作
  • 发现必须可复现并排定优先级
  • 审查优先级顺序:安全 > 性能 > 可访问性 > 代码质量
  • 每个发现必须包含 file:line、描述和修复
  • 严重程度分级:CRITICAL(安全漏洞/数据丢失)、HIGH(阻碍发布)、MEDIUM(本冲刺)、LOW(待办)
  • 仅运行适用于项目和审查范围的自动化工具,不要求无关技术栈工具
  • 每个缺陷发现必须可复现;假设和不可用检查记录为验证缺口,而非缺陷;在必需检查未验证时不得发出 PASS
  • 提供修复代码,而不仅是描述
  • 相关时,将发现映射到 ISO/IEC 25010 质量特性,并提出符合 ISO/IEC 29119 的测试改进

参考资源

  • 执行步骤:resources/execution-protocol.md
  • ISO 质量指南:resources/iso-quality.md
  • QA 检查清单:resources/checklist.md
  • 错误恢复:resources/error-playbook.md
  • Ultrawork VERIFY/SHIP 阶段协议:resources/verify-ship-protocol.md(当此技能在 ultrawork 工作流内运行时使用)
  • 上下文加载:../_shared/core/context-loading.md
  • 上下文预算:../_shared/core/context-budget.md
  • 运行时经验:../_shared/core/session-metrics.md
  • 代码智能:../_shared/core/code-intelligence.md
  • 可观测性交接:../oma-observability/SKILL.md §Integrations — canary RUM(Core Web Vitals)、后端性能 span