mcpField
R
router-qa

router-qa

github.com/vasilyu1983测试与质量43 次安装
代码仓库

关于 router-qa

面向 QA 问题的路由技能，将测试、可观测性、韧性、调试和文档质量请求分配给 12 个专用技能。它也规定了实现、文档编写和部署工作的交接方式。

主要功能

  1. 01在 12 个 QA 技能间分流
  2. 02涵盖测试、调试与可观测性
  3. 03定义多技能 QA 工作流
  4. 04转交实现与部署任务
  5. 05提供路由矩阵和质量门槛

适用场景

  1. 01选择测试策略或测试技能
  2. 02分流生产环境调试请求
  3. 03规划可观测性或韧性工作
  4. 04评估文档质量覆盖情况

安装

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

$npx skills add https://github.com/vasilyu1983/ai-agents-public --skill router-qa

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

详细介绍

路由器：质量保证

质量工程的主编排器，通过 12 项专门的 QA 技能处理测试、可观测性、韧性、调试和文档质量问题；当请求超出 QA 范围（实现、文档编写、部署）时，会明确交接。

快速决策树

QA QUESTION
    │
    ├─► "What tests do I need?" ──────────► qa-testing-strategy
    │                                        └─► Test pyramid, coverage, risk-based
    │
    ├─► "Write E2E tests" ────────────────► qa-testing-playwright
    │                                        └─► Selectors, page objects, CI/CD
    │
    ├─► "Test iOS app" ───────────────────► qa-testing-ios
    │                                        └─► XCTest, simulators, device matrix
    │
    ├─► "Test mobile app" ────────────────► qa-testing-mobile
    │                                        └─► Cross-platform, Android + iOS
    │
    ├─► "Test Android app" ──────────────► qa-testing-android
    │                                        └─► Espresso, UIAutomator, Compose
    │
    ├─► "Test API contracts" ─────────────► qa-api-testing-contracts
    │                                        └─► OpenAPI, Pact, schema validation
    │
    ├─► "Test LLM agent" ─────────────────► qa-agent-testing
    │                                        └─► Scenarios, scoring, refusals
    │
    ├─► "Debug this issue" ───────────────► qa-debugging
    │                                        └─► Stack traces, logging, profiling
    │
    ├─► "Setup monitoring" ───────────────► qa-observability
    │                                        └─► OpenTelemetry, SLOs, tracing
    │
    ├─► "Handle failures" ────────────────► qa-resilience
    │                                        └─► Circuit breakers, retries, chaos
    │
    ├─► "Refactor safely" ────────────────► qa-refactoring
    │                                        └─► Characterization tests, seams
    │
    └─► "Check docs coverage" ────────────► qa-docs-coverage
                                             └─► Gap analysis, runbook validation

技能注册表（12 项 QA 技能）

测试技能（7 项）
技能用途关键触发词
qa-testing-strategy测试金字塔、基于风险的测试、覆盖率“测试策略”、“需要哪些测试”、“覆盖率”
qa-testing-playwright使用 Playwright 进行 Web 端到端测试“端到端测试”、“Playwright”、“浏览器测试”
qa-testing-ios使用 XCTest/XCUITest 进行 iOS 测试“iOS 测试”、“XCTest”、“模拟器”
qa-testing-android使用 Espresso/UIAutomator 进行 Android 测试“Android 测试”、“Espresso”、“UIAutomator”、“Compose 测试”
qa-testing-mobile跨平台移动端测试“移动端测试”、“跨平台”、“设备矩阵”
qa-api-testing-contractsAPI 架构和契约测试“API 测试”、“契约”、“OpenAPI”、“Pact”
qa-agent-testing大模型 Agent 和角色测试“Agent 测试”、“大模型测试”、“拒绝”、“评分”
质量技能（5 项）
技能用途关键触发词
qa-debugging调试、日志记录、性能分析“调试”、“错误”、“堆栈跟踪”、“性能分析”
qa-observability指标、追踪、日志、SLO“监控”、“追踪”、“SLO”、“OpenTelemetry”
qa-resilience熔断器、重试、混沌工程“熔断器”、“重试”、“混沌工程”、“超时”
qa-refactoring安全重构、技术债务“重构”、“代码异味”、“技术债务”
qa-docs-coverage文档质量门禁“文档覆盖率”、“缺少文档”、“运行手册”

规范注册表（权威来源）

使用 frameworks/shared-skills/skills/router-qa/data/skill-registry.json 作为 QA 技能、触发词、预期输出和路由规则的规范列表。

使用 frameworks/shared-skills/skills/router-qa/data/sources.json 查找可选的网络搜索参考资料（各专门技能会按需维护自己的来源）。

领域检测

领域 1：测试规划

触发词：“需要哪些测试”、“测试策略”、“覆盖率”、“测试金字塔”、“左移”、“基于风险”

路由至：qa-testing-strategy

示例问题：

  • “这个 API 需要哪些测试？”
  • “如何确定测试优先级？”
  • “合适的测试覆盖率目标是多少？”
领域 2：端到端与 UI 测试

触发词：“E2E”、“端到端”、“Playwright”、“浏览器测试”、“UI 测试”、“页面对象”、“视觉测试”

路由至：qa-testing-playwright

示例问题：

  • “为登录编写 Playwright 测试”
  • “如何处理不稳定的端到端测试？”
  • “页面对象的最佳实践是什么？”
领域 3：移动端测试

触发词：“iOS”、“Android”、“移动端”、“XCTest”、“XCUITest”、“Espresso”、“UIAutomator”、“Appium”、“模拟器”、“仿真器”、“设备”

触发词路由
仅 iOSqa-testing-ios
仅 Androidqa-testing-android
跨平台qa-testing-mobile

示例问题：

  • “在模拟器上测试 iOS 应用”
  • “为 Android 登录编写 Espresso 测试”
  • “测试 Jetpack Compose UI”
  • “用于 Android 测试的设备矩阵”
  • “跨平台移动端测试策略”
领域 4：API 与契约测试

触发词：“API 测试”、“契约测试”、“OpenAPI”、“GraphQL 测试”、“gRPC”、“Pact”、“架构验证”

路由至：qa-api-testing-contracts

示例问题：

  • “为 REST API 编写契约测试”
  • “验证 OpenAPI 架构”
  • “消费者驱动的契约测试”
领域 5：Agent 测试

触发词：“Agent 测试”、“大模型测试”、“角色”、“拒绝”、“AI 安全”、“评分标准”、“测试框架”

路由至：qa-agent-testing

示例问题：

  • “为聊天机器人创建测试套件”
  • “测试大模型拒绝边界”
  • “评估 Agent 的回答”
领域 6：调试

触发词：“debug”、“error”、“bug”、“crash”、“stack trace”、“logging”、“profiling”、“troubleshoot”

路由到：qa-debugging

示例问题：

  • “调试内存泄漏”
  • “分析这段 stack trace”
  • “设置结构化日志记录”
领域 7：可观测性

触发词：“monitor”、“metrics”、“tracing”、“logging”、“SLO”、“SLI”、“OpenTelemetry”、“APM”、“alert”

路由到：qa-observability

示例问题：

  • “为 Node.js 设置 OpenTelemetry”
  • “为 API 定义 SLO”
  • “分布式追踪策略”
领域 8：弹性

触发词：“circuit breaker”、“retry”、“timeout”、“backoff”、“chaos”、“fault injection”、“degradation”、“health check”

路由到：qa-resilience

示例问题：

  • “实现熔断器”
  • “外部 API 的重试策略”
  • “设置混沌工程”
领域 9：重构

触发词：“refactor”、“code smell”、“tech debt”、“legacy code”、“characterization test”、“strangler fig”

路由到：qa-refactoring

示例问题：

  • “安全地重构这段遗留代码”
  • “在重构前添加测试”
  • “管理技术债务”
领域 10：文档质量

触发词：“docs coverage”、“undocumented”、“runbook”、“API docs audit”、“stale docs”

如果用户询问 CLAUDE.md/AGENTS.md/项目记忆/大型代码库设置：路由到 agents-project-memory（辅助技能：qa-docs-coverage、docs-codebase）

示例问题：

  • “审查文档覆盖率”
  • “查找未记录的 API”
  • “验证运行手册”
  • “为大型代码库设置 CLAUDE.md”
  • “为跨平台支持创建 AGENTS.md”

工作流模式

模式 1：测试优先开发
START
  │
  ▼
qa-testing-strategy ────────► Define test pyramid
  │
  ├─► Unit tests ──────────► Write inline
  ├─► Integration tests ───► Write with mocks
  └─► E2E tests ───────────► qa-testing-playwright
  │
  ▼
qa-api-testing-contracts ──► Contract tests (if API)
  │
  ▼
TESTS COMPLETE
模式 2：Bug 调查
BUG REPORTED
  │
  ▼
qa-debugging ──────────────► Analyze logs, traces, stack
  │
  ├─► Need more visibility? → qa-observability
  ├─► Failure mode issue? ──→ qa-resilience
  └─► Code quality issue? ──→ qa-refactoring
  │
  ▼
ROOT CAUSE IDENTIFIED
  │
  ▼
qa-testing-strategy ───────► Add regression test
  │
  ▼
BUG FIXED + COVERED
模式 3：生产环境加固
PRE-PRODUCTION
  │
  ▼
qa-resilience ─────────────► Error handling, retries
  │
  ▼
qa-observability ──────────► Metrics, tracing, SLOs
  │
  ▼
qa-testing-strategy ───────► Smoke + E2E tests
  │
  ▼
PRODUCTION READY
  │
  ▼
qa-resilience ─────────────► Chaos experiments (post-launch)
模式 4：遗留系统现代化
LEGACY CODEBASE
  │
  ▼
qa-refactoring ────────────► Characterization tests
  │
  ▼
qa-testing-strategy ───────► Add missing test coverage
  │
  ▼
qa-refactoring ────────────► Incremental refactoring
  │
  ▼
qa-docs-coverage ──────────► Document updated code
  │
  ▼
MODERNIZED
模式 5：大模型 Agent 质量
AGENT DEVELOPMENT
  │
  ▼
qa-agent-testing ──────────► Define test scenarios
  │
  ├─► Must-ace tasks ──────► Core functionality
  ├─► Refusal tests ───────► Safety boundaries
  └─► Scoring rubric ──────► Quality metrics
  │
  ▼
qa-observability ──────────► Token usage, latency metrics
  │
  ▼
VALIDATED AGENT
模式 6：大型代码库文档（100K-1M LOC）
LARGE CODEBASE
  │
  ▼
agents-project-memory ► Hierarchical CLAUDE.md setup
  │                          (root + subdirectory docs)
  ├─► Root CLAUDE.md ────────► Architecture, conventions
  ├─► Subdirectory docs ─────► Module-specific context
  ├─► AGENTS.md symlink ─────► Cross-platform support
  │
  ▼
qa-docs-coverage ──────────► Audit existing documentation
  │
  ▼
docs-codebase ─────────────► Fill critical gaps
  │
  ▼
LLM-READY CODEBASE

技能链

链：完整 QA 设置
qa-testing-strategy → qa-testing-playwright → qa-api-testing-contracts
     ↓
qa-resilience → qa-observability → qa-debugging
     ↓
qa-refactoring → qa-docs-coverage
链：事件响应
qa-debugging → qa-observability → qa-resilience → qa-refactoring
链：移动应用测试
qa-testing-strategy → qa-testing-mobile → qa-testing-ios (if iOS) → qa-testing-android (if Android)

质量门禁

发布前检查清单
门禁技能标准
测试覆盖率qa-testing-strategy覆盖率目标与风险和关键路径相匹配
E2E 通过qa-testing-playwright关键路径全部通过
API 契约qa-api-testing-contracts架构验证通过
错误处理qa-resilience已配置熔断器
监控qa-observability已定义 SLO，已设置告警
文档qa-docs-coverageAPI 和 README 完整
事件后检查清单
门禁技能操作
根本原因qa-debugging记录调查结果
回归测试qa-testing-strategy针对故障模式添加测试
预防qa-resilience添加/调整熔断器
可见性qa-observability添加缺失的追踪/告警

路由矩阵

用户意图主要技能辅助技能
规划测试qa-testing-strategyqa-testing-playwright、qa-api-testing-contracts
编写 E2E 测试qa-testing-playwrightqa-testing-strategy
测试移动应用qa-testing-mobile、qa-testing-ios 或 qa-testing-androidqa-testing-strategy
测试 APIqa-api-testing-contractsqa-testing-strategy
测试 Agentqa-agent-testingqa-testing-strategy
调试问题qa-debuggingqa-observability、qa-resilience
设置监控qa-observabilityqa-debugging
增强弹性qa-resilienceqa-observability
重构代码qa-refactoringqa-testing-strategy
审查文档qa-docs-coveragedocs-codebase
设置大型代码库agents-project-memoryqa-docs-coverage、docs-codebase

跨路由器交接

到 router-engineering

当用户需要实现时：

  • “构建此功能” → 路由到 software-backend 或 software-frontend
  • “实现此修复” → 路由到相关工程技能
到 router-operations

当用户需要部署／基础设施支持时：

  • “部署到生产环境” → 路由到 ops-devops-platform
  • “设置 CI/CD” → 路由到 ops-devops-platform
来自 router-operations

当运维路由器检测到 QA 需求时：

  • “测试策略” → 路由到此处
  • “调试生产问题” → 路由到此处
  • “增强韧性” → 路由到此处

快速参考命令

需求操作
测试策略→ qa-testing-strategy
E2E 测试→ qa-testing-playwright
iOS 测试→ qa-testing-ios
Android 测试→ qa-testing-android
移动端测试→ qa-testing-mobile
API 测试→ qa-api-testing-contracts
Agent 测试→ qa-agent-testing
调试问题→ qa-debugging
监控→ qa-observability
韧性→ qa-resilience
重构→ qa-refactoring
文档质量→ qa-docs-coverage

相关路由器

路由器关系
router-operations父级路由器；涵盖 QA、DevOps 和 git
router-engineering实现任务的交接目标
router-startup商业／产品问题的交接目标

评论

支持 Markdown