sumo-qa Skill 技能

技能简介

sumo-qa 是一套「资深 QA 纪律」的 MCP 服务器与技能库：先分析仓库，把风险映射到具体测试与证据，再做测试计划与脚手架、强化薄弱测试套件，并在合并前审查 diff。它面向一个现实问题——AI 写的代码越来越多，模型会自信地说「完成」「可以合并」，但自信不等于证据；sumo-qa 要求任何宿主、任何栈上的智能体拿出证据：风险指向具体文件与行、每条风险绑定本轮真实跑过的测试、给出可以直接交给评审人的合并结论。项目自我定位是「顾问而非先知」，最终判断仍归人和团队标准。

核心能力

• 先读仓库再谈风险：sumo-qa analyze 把仓库扫成 .sumo-qa/repo-map.json，风险命名到具体文件与行，而不是「注意边界情况」式的空泛建议。
• 基于 ISTQB 的技术选型：每个风险从内置知识目录（分类、方法、原则、技术）里挑一个真实设计技术，而非凭感觉生成测试；知识目录是可编辑的 Markdown。
• Iron Law 硬门禁：每个技能文件都带 Iron Law 与 HARD-GATE 标注，模型无法用话术绕过——没有可检查的准则不发布计划，TDD 红灯阶段不许写生产代码，宣称可合并前必须本轮重跑测试套件，拒绝「CI 一小时前是绿的」。
• 三层架构：技能层负责流程，MCP 入口层只做文件 IO 与小确定性逻辑（不做推理），渐进式加载器按「路由清单 → 章节 → 模块 → 全文」分片读取，宿主每次只付费路由切片。
• 终端 QA 回路：analyze 建图、status 看图是否过期、report 合成 qa-report.html、check 做 CI 门禁（未过策略退出码 1 且不写文件）。
• 外部技能生命周期：Playwright E2E、无障碍审计、k6 压测等场景经 MCP 四工具完成「搜索 → [y/N] 门禁 → 按 commit 检出安装 → 加载」，宿主从不直接跑 npx。

安装配置

1. 安装：pip install sumo-qa && sumo-qa-install，随后重启宿主或新开会话；sumo-qa-install 会自动配置它检测到的每个 MCP 宿主。
2. 宿主接线：Claude Code 用 --claude-code，VS Code + Copilot 用 --vscode --workspace 写入 .vscode/mcp.json，JetBrains 系列用 --jetbrains 打印可粘贴配置。
3. 验证：sumo-qa-doctor 只读自检，全绿即接线成功，每项失败都会打印对应 Fix: 命令；再对宿主说「load the QA classifications」做端到端确认。
4. 其他宿主：Cursor、Codex、OpenCode、Gemini CLI 等走标准 stdio MCP，按各自文档指向 sumo-qa 脚本绝对路径（官方未逐一端到端验证）。

使用步骤

1. 在目标仓库安装并运行 sumo-qa-doctor，确认宿主已识别技能与工具。
2. 执行 sumo-qa analyze 生成仓库地图，sumo-qa status 查看地图相对 HEAD 是否最新。
3. 在宿主里用自然语言发起工作：「review my changes」「plan QA for this story」「load the QA classifications」，技能按工具描述自动路由，Claude Code 里也可用 /using-sumo-qa 斜杠前缀。
4. 让智能体给出风险台账与测试计划，检查每条风险是否绑定真实执行过的测试证据。
5. 用 sumo-qa report 生成本地 QA 报告页，接入 CI 时以 sumo-qa check 作为就绪门禁。

适用场景

• AI 生成代码的合并审查：diff review 拒绝基于过期 CI 的「可合并」结论，要求本轮重跑并给出风险到测试的可追溯映射。
• TDD 脚手架与测试强化：先锁红灯阶段再写生产代码，针对变异存活者逐个补强测试，期间生产代码保持锁定。
• 测试计划与策略审计：计划带可度量的进入/退出准则，可对整仓审计产出测试策略与就绪记分卡。
• 团队 QA 标准落地：把团队的分类、变更规则、测试数据以 Markdown 知识目录进仓库，CI 可复现、评审可 diff。
• 宿主无关的 QA 咨询：同一套技能与工具在 Claude Code、VS Code、JetBrains 及任何 MCP 宿主上给出同标准输出。

适用人群

对 AI 编程产出负最终责任、需要证据而非保证的开发团队；做合并把关的 Tech Lead 与 QA 工程师；希望把 ISTQB 式测试设计纪律固化进 AI 工作流的质量负责人；在多种 AI 编程宿主间切换、要求各处标准一致的工程师。

工作原理

三层数据流：宿主 LLM 读取技能文件并按 Iron Law 执行，技能引用知识目录中的分类与技术产出输出；MCP 服务器暴露薄工具面（技能工具、知识加载器、能力发现、仓库地图、测试数据等），全部是文件 IO 或小段确定性逻辑，不含推理；渐进式加载器让宿主按需分片取技能。仓库地图由扫描器写入 .sumo-qa/repo-map.json，风险台账、就绪记分卡与门禁证据在此基础上派生：风险行记录证据状态，评分引擎综合风险台账与上下文给出「就绪/阻断/证据不足」结论，门禁验证器会拒绝无支撑的「测试通过」「可合并」声明。终端命令与 MCP 技能共享同一批工件，CI 与会话内看到的是同一份事实。

官方链接

• PyPI 主页：https://pypi.org/project/sumo-qa/
• GitHub 仓库：https://github.com/sumithr/sumo-qa
• 架构文档：https://github.com/sumithr/sumo-qa/blob/main/docs/ARCHITECTURE.md
• 五分钟演示：https://github.com/sumithr/sumo-qa/blob/main/DEMO.md