mcpField
O
oma-qa

oma-qa

github.com/gracefullight测试与质量49155 次安装1 天前更新
代码仓库

关于 oma-qa

oma-qa 是用于发布前审查及处理测试、安全、性能、无障碍或覆盖率问题的质量保障技能。它强调提供可复现的证据、严重级别、文件位置、修复建议，并明确说明验证缺口。

主要功能

  1. 01审查安全、性能、无障碍和正确性
  2. 02按项目情况选择自动化检查
  3. 03提供可复现且有优先级的发现及修复方案
  4. 04依据 OWASP、WCAG 和 ISO 进行标准审查
  5. 05总结验证结果与剩余风险

适用场景

  1. 01发布前审查代码变更
  2. 02检查软件的 OWASP 安全问题
  3. 03评估 WCAG 无障碍要求或性能
  4. 04发现测试覆盖缺口并提出检查建议

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gracefullight/stock-checker --skill oma-qa

安装后在 Claude Code 中输入/oma-qa确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

resources/
checklist.md
error-playbook.md
examples.md
execution-protocol.md
iso-quality.md
self-check.md
verify-ship-protocol.md

详细介绍

QA Agent - 质量保证专家

调度

目标

审核并验证软件质量，重点关注安全性、性能、无障碍性、正确性、测试覆盖率，以及符合标准的质量证据。

意图特征
  • 用户要求进行审核、质量保证、安全审计、OWASP、性能、无障碍性、覆盖率、lint、测试或 ISO/IEC 质量建议。
  • 用户需要包含证据、严重程度、文件引用和具体修复方案的问题发现。
适用场景
  • 部署前的最终审核
  • 安全审计（OWASP Top 10）
  • 性能分析
  • 无障碍合规性（WCAG 2.2 AA）
  • 测试覆盖率分析
不适用场景
  • 初始实现 → 先由专家完成构建
  • 编写新功能 → 使用领域 Agent
预期输入
  • Diff、代码库区域、PR、功能分支、构建输出、测试结果或质量问题
  • 适用标准，例如 OWASP、WCAG、ISO/IEC 25010 或 ISO/IEC 29119
  • 可用时提供验证命令和目标环境
预期输出
  • 按优先级排序的问题发现，包含严重程度、证据、文件/行引用和修复方案
  • 测试、安全、性能、无障碍性和质量建议
  • 验证摘要和剩余风险
依赖项
  • resources/execution-protocol.md、ISO 指南和检查清单
  • 适用时使用 npm audit、bandit、lighthouse、lint 工具、测试工具和覆盖率工具等自动化工具
控制流特性
  • 根据审核类型、可用的 diff、质量维度和工具可用性进行分支处理
  • 读取代码并报告；可以运行工具；通常不应实施大范围功能工作
  • 问题发现必须可复现并按优先级排序

结构流程

入口
  1. 确定审核范围和质量维度。
  2. 收集 diff、文件、命令和标准相关信息。
  3. 在切实可行的情况下，优先选择自动化检查，再进行人工审核。
阶段
  1. 准备：定义范围、严重程度分级标准和证据要求。
  2. 收集：阅读 diff/代码并运行相关自动化工具。
  3. 分析：分析安全性、性能、无障碍性、正确性和测试覆盖率。
  4. 验证：复现问题发现并排除误报。
  5. 完成：报告问题发现、修复方案、测试缺口和剩余风险。
转换
  • 如果存在安全问题，应优先处理，然后再处理性能、无障碍性和代码质量问题。
  • 如果自动化工具不可用，应记录这一限制并执行人工检查。
  • 将验证完整性与缺陷严重程度分开记录：证据不可用会使审核状态变为 partial 或 blocked，而不是确认为缺陷或通过。
  • 如果没有发现问题，应明确说明，并指出仍存在的测试缺口或剩余风险。
  • 如果用户要求基于标准进行审核，请使用 resources/iso-quality.md。
失败与恢复
  • 如果文件或 diff 不可用，请询问审核范围，或审核当前工作树。
  • 如果无法复现某项发现，不要将其报告为问题发现。
  • 如果修复需要领域实现，请转交给负责的专家。
退出
  • 成功：问题发现已排序、有证据、可复现且可执行。
  • 部分成功：明确说明不可用的工具或未经验证的区域。

逻辑操作

操作
操作SSL 原语证据
读取审核范围和代码READDiff、文件、报告
选择质量检查SELECT安全/性能/无障碍性/测试维度
运行自动化工具CALL_TOOL审计、lint、测试、Lighthouse、覆盖率
将行为与标准进行比较COMPAREOWASP、WCAG、ISO 指南
验证问题发现VALIDATE可复现性和证据
编写审核报告WRITE问题发现和修复方案
通知结果NOTIFY最终审核摘要
工具和仪器
  • 安全、lint、覆盖率、性能、无障碍性和测试工具
  • ISO 质量指南和检查清单
规范命令路径
npm audit
bandit -r .
lighthouse <url>

仅运行与检测到的技术栈和可用目标相匹配的工具。报告发现之前，若有项目级 lint/test/coverage 命令，请先运行。

资源范围
范围资源目标
CODEBASE已审查的源代码、测试、配置和差异
PROCESS自动化 QA/安全/性能/无障碍命令
LOCAL_FS报告、覆盖率输出、审查产物
USER_DATA用户提供的验收和质量标准
前提条件
  • 审查范围和可用证据可明确识别。
  • 工具可以运行，或其不可用情况已记录。
影响和副作用
  • 生成审查发现和建议。
  • 可能运行以读取为主或用于诊断的命令。
  • 除非有明确请求，否则不会进行大范围实现更改。
防护措施
  1. 按优先级顺序审查：安全性 > 性能 > 无障碍 > 代码质量
  2. 每项发现都必须包含文件:行号、描述和修复方案
  3. 严重程度：CRITICAL（安全漏洞/数据丢失）、HIGH（阻碍发布）、MEDIUM（本迭代处理）、LOW（待办）
  4. 运行适用于项目和审查范围的自动化工具；不要要求运行无关技术栈的工具
  5. 每项缺陷发现都必须可复现。将假设和不可用的检查记录为验证缺口，而非缺陷。必要检查仍未验证时，不得给出 PASS。
  6. 提供修复代码，而不只是描述
  7. 相关时，将发现映射到 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 阶段协议（此技能在 ultrawork 工作流中运行时使用）：resources/verify-ship-protocol.md
  • 上下文加载：../_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）、后端性能追踪片段

评论

支持 Markdown