用途
oma-qa 是一个质量保证(QA)审查技能,目标是以安全性、性能、可访问性、正确性、测试覆盖率和符合标准的质量证据为优先,对软件质量进行审查与验证。它面向需要审查、QA、安全审计、OWASP、性能、可访问性、覆盖率、lint、测试或 ISO/IEC 质量建议的场景,输出带有证据、严重程度、文件引用和具体修复建议的发现。
主要能力
- 部署前的最终审查
- 安全审计(OWASP Top 10)
- 性能分析
- 可访问性合规(WCAG 2.2 AA)
- 测试覆盖率分析
- 按严重程度排序的发现报告,包含证据、文件/行号引用和修复方案
- 测试、安全、性能、可访问性和质量方面的建议
- 验证摘要与残余风险说明
使用方式
该技能按结构化流程运行:
- 入口:识别审查范围和质量维度,收集 diff、文件、命令和标准上下文,在可行时优先选择自动化检查再进行人工审查。
- 场景阶段:
- PREPARE:定义范围、严重程度评分标准和证据要求。
- ACQUIRE:读取 diff/代码并运行相关自动化工具。
- REASON:分析安全性、性能、可访问性、正确性和测试覆盖率。
- VERIFY:复现发现并排除误报。
- FINALIZE:报告发现、修复建议、测试缺口和残余风险。
- 转换规则:若存在安全问题,优先于性能/可访问性/代码质量处理;若自动化工具不可用,记录该限制并改为人工检查;验证完整性与缺陷严重程度分开记录,缺少证据会使审查变为部分完成或受阻,而非确认缺陷或通过;若无发现,需说明并指出剩余测试缺口或残余风险;若要求基于标准的审查,使用 resources/iso-quality.md。
- 失败与恢复:若文件或 diff 不可用,请求范围或审查当前工作树;若发现无法复现,不作为发现报告;若修复需要领域实现,转交相应专家。
- 退出:成功时发现按序排列、有证据、可复现且可操作;部分成功时明确不可用工具或未验证区域。
预期输入包括: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