router-qa

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Router: Quality Assurance

路由器:质量保证

Master orchestrator for quality engineering that routes testing, observability, resilience, debugging, and documentation quality questions through 12 specialized QA skills, with explicit handoffs when the request is outside QA scope (implementation, docs authoring, deployment).

质量工程的主编排器,可将测试、可观测性、韧性、调试和文档质量相关问题路由至12个专业QA技能;当请求超出QA范围(如实现、文档编写、部署)时,会进行明确的移交。

Quick Decision Tree

快速决策树

text
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

text
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

Skill Registry (12 QA Skills)

技能注册表(12个QA技能)

Testing Skills (7)

测试技能(7个)

SkillPurposeKey Triggers
qa-testing-strategy
Test pyramid, risk-based testing, coverage"test strategy", "what tests", "coverage"
qa-testing-playwright
E2E web testing with Playwright"E2E test", "Playwright", "browser test"
qa-testing-ios
iOS testing with XCTest/XCUITest"iOS test", "XCTest", "simulator"
qa-testing-android
Android testing with Espresso/UIAutomator"Android test", "Espresso", "UIAutomator", "Compose test"
qa-testing-mobile
Cross-platform mobile testing"mobile test", "cross-platform", "device matrix"
qa-api-testing-contracts
API schema and contract testing"API test", "contract", "OpenAPI", "Pact"
qa-agent-testing
LLM agent and persona testing"agent test", "LLM test", "refusal", "scoring"
技能用途关键触发词
qa-testing-strategy
测试金字塔、基于风险的测试、测试覆盖"test strategy", "what tests", "coverage"
qa-testing-playwright
使用Playwright进行E2E Web测试"E2E test", "Playwright", "browser test"
qa-testing-ios
使用XCTest/XCUITest进行iOS测试"iOS test", "XCTest", "simulator"
qa-testing-android
使用Espresso/UIAutomator进行Android测试"Android test", "Espresso", "UIAutomator", "Compose test"
qa-testing-mobile
跨平台移动测试"mobile test", "cross-platform", "device matrix"
qa-api-testing-contracts
API schema和契约测试"API test", "contract", "OpenAPI", "Pact"
qa-agent-testing
LLM Agent和角色测试"agent test", "LLM test", "refusal", "scoring"

Quality Skills (5)

质量技能(5个)

SkillPurposeKey Triggers
qa-debugging
Debugging, logging, profiling"debug", "error", "stack trace", "profile"
qa-observability
Metrics, traces, logs, SLOs"monitor", "tracing", "SLO", "OpenTelemetry"
qa-resilience
Circuit breakers, retries, chaos"circuit breaker", "retry", "chaos", "timeout"
qa-refactoring
Safe refactoring, tech debt"refactor", "code smell", "tech debt"
qa-docs-coverage
Documentation quality gates"docs coverage", "undocumented", "runbook"

技能用途关键触发词
qa-debugging
调试、日志、性能分析"debug", "error", "stack trace", "profile"
qa-observability
指标、追踪、日志、SLO"monitor", "tracing", "SLO", "OpenTelemetry"
qa-resilience
断路器、重试、混沌工程"circuit breaker", "retry", "chaos", "timeout"
qa-refactoring
安全重构、技术债务管理"refactor", "code smell", "tech debt"
qa-docs-coverage
文档质量管控"docs coverage", "undocumented", "runbook"

Canonical Registry (Source of Truth)

标准注册表(事实来源)

Use
frameworks/shared-skills/skills/router-qa/data/skill-registry.json
as the canonical list of QA skills, triggers, expected outputs, and routing rules.
Use
frameworks/shared-skills/skills/router-qa/data/sources.json
for optional web-search references (each specialized skill maintains its own sources as needed).

请使用
frameworks/shared-skills/skills/router-qa/data/skill-registry.json
作为QA技能、触发词、预期输出和路由规则的标准列表。
请使用
frameworks/shared-skills/skills/router-qa/data/sources.json
作为可选的网页搜索参考(每个专业技能可根据需要维护自己的来源)。

Domain Detection

领域检测

Domain 1: Test Planning

领域1:测试规划

Triggers: "what tests", "test strategy", "coverage", "test pyramid", "shift-left", "risk-based"
Route to:
qa-testing-strategy
Example questions:
  • "What tests do I need for this API?"
  • "How do I prioritize testing?"
  • "What's the right test coverage target?"
触发词:"what tests", "test strategy", "coverage", "test pyramid", "shift-left", "risk-based"
路由至
qa-testing-strategy
示例问题
  • "What tests do I need for this API?"
  • "How do I prioritize testing?"
  • "What's the right test coverage target?"

Domain 2: E2E & UI Testing

领域2:E2E与UI测试

Triggers: "E2E", "end-to-end", "Playwright", "browser test", "UI test", "page object", "visual test"
Route to:
qa-testing-playwright
Example questions:
  • "Write Playwright tests for login"
  • "How to handle flaky E2E tests?"
  • "Best practices for page objects?"
触发词:"E2E", "end-to-end", "Playwright", "browser test", "UI test", "page object", "visual test"
路由至
qa-testing-playwright
示例问题
  • "Write Playwright tests for login"
  • "How to handle flaky E2E tests?"
  • "Best practices for page objects?"

Domain 3: Mobile Testing

领域3:移动测试

Triggers: "iOS", "Android", "mobile", "XCTest", "XCUITest", "Espresso", "UIAutomator", "Appium", "simulator", "emulator", "device"
TriggerRoute
iOS-only
qa-testing-ios
Android-only
qa-testing-android
Cross-platform
qa-testing-mobile
Example questions:
  • "Test iOS app on simulator"
  • "Write Espresso tests for Android login"
  • "Test Jetpack Compose UI"
  • "Device matrix for Android testing"
  • "Cross-platform mobile test strategy"
触发词:"iOS", "Android", "mobile", "XCTest", "XCUITest", "Espresso", "UIAutomator", "Appium", "simulator", "emulator", "device"
触发词路由目标
仅iOS
qa-testing-ios
仅Android
qa-testing-android
跨平台
qa-testing-mobile
示例问题
  • "Test iOS app on simulator"
  • "Write Espresso tests for Android login"
  • "Test Jetpack Compose UI"
  • "Device matrix for Android testing"
  • "Cross-platform mobile test strategy"

Domain 4: API & Contract Testing

领域4:API与契约测试

Triggers: "API test", "contract test", "OpenAPI", "GraphQL test", "gRPC", "Pact", "schema validation"
Route to:
qa-api-testing-contracts
Example questions:
  • "Write contract tests for REST API"
  • "Validate OpenAPI schema"
  • "Consumer-driven contract testing"
触发词:"API test", "contract test", "OpenAPI", "GraphQL test", "gRPC", "Pact", "schema validation"
路由至
qa-api-testing-contracts
示例问题
  • "Write contract tests for REST API"
  • "Validate OpenAPI schema"
  • "Consumer-driven contract testing"

Domain 5: Agent Testing

领域5:Agent测试

Triggers: "agent test", "LLM test", "persona", "refusal", "AI safety", "scoring rubric", "test harness"
Route to:
qa-agent-testing
Example questions:
  • "Create test suite for chatbot"
  • "Test LLM refusal boundaries"
  • "Score agent responses"
触发词:"agent test", "LLM test", "persona", "refusal", "AI safety", "scoring rubric", "test harness"
路由至
qa-agent-testing
示例问题
  • "Create test suite for chatbot"
  • "Test LLM refusal boundaries"
  • "Score agent responses"

Domain 6: Debugging

领域6:调试

Triggers: "debug", "error", "bug", "crash", "stack trace", "logging", "profiling", "troubleshoot"
Route to:
qa-debugging
Example questions:
  • "Debug memory leak"
  • "Analyze this stack trace"
  • "Setup structured logging"
触发词:"debug", "error", "bug", "crash", "stack trace", "logging", "profiling", "troubleshoot"
路由至
qa-debugging
示例问题
  • "Debug memory leak"
  • "Analyze this stack trace"
  • "Setup structured logging"

Domain 7: Observability

领域7:可观测性

Triggers: "monitor", "metrics", "tracing", "logging", "SLO", "SLI", "OpenTelemetry", "APM", "alert"
Route to:
qa-observability
Example questions:
  • "Setup OpenTelemetry for Node.js"
  • "Define SLOs for API"
  • "Distributed tracing strategy"
触发词:"monitor", "metrics", "tracing", "logging", "SLO", "SLI", "OpenTelemetry", "APM", "alert"
路由至
qa-observability
示例问题
  • "Setup OpenTelemetry for Node.js"
  • "Define SLOs for API"
  • "Distributed tracing strategy"

Domain 8: Resilience

领域8:韧性

Triggers: "circuit breaker", "retry", "timeout", "backoff", "chaos", "fault injection", "degradation", "health check"
Route to:
qa-resilience
Example questions:
  • "Implement circuit breaker"
  • "Retry strategy for external APIs"
  • "Setup chaos engineering"
触发词:"circuit breaker", "retry", "timeout", "backoff", "chaos", "fault injection", "degradation", "health check"
路由至
qa-resilience
示例问题
  • "Implement circuit breaker"
  • "Retry strategy for external APIs"
  • "Setup chaos engineering"

Domain 9: Refactoring

领域9:重构

Triggers: "refactor", "code smell", "tech debt", "legacy code", "characterization test", "strangler fig"
Route to:
qa-refactoring
Example questions:
  • "Refactor this legacy code safely"
  • "Add tests before refactoring"
  • "Manage technical debt"
触发词:"refactor", "code smell", "tech debt", "legacy code", "characterization test", "strangler fig"
路由至
qa-refactoring
示例问题
  • "Refactor this legacy code safely"
  • "Add tests before refactoring"
  • "Manage technical debt"

Domain 10: Documentation Quality

领域10:文档质量

Triggers: "docs coverage", "undocumented", "runbook", "API docs audit", "stale docs"
Route to:
qa-docs-coverage
If the user asks about CLAUDE.md/AGENTS.md/project memory/large codebase setup: route to
claude-code-project-memory
(supporting:
qa-docs-coverage
,
docs-codebase
)
Example questions:
  • "Audit documentation coverage"
  • "Find undocumented APIs"
  • "Validate runbooks"
  • "Set up CLAUDE.md for large codebase"
  • "Create AGENTS.md for cross-platform support"

触发词:"docs coverage", "undocumented", "runbook", "API docs audit", "stale docs"
路由至
qa-docs-coverage
如果用户询问CLAUDE.md/AGENTS.md/项目记忆/大型代码库设置:路由至
claude-code-project-memory
(支持:
qa-docs-coverage
,
docs-codebase
示例问题
  • "Audit documentation coverage"
  • "Find undocumented APIs"
  • "Validate runbooks"
  • "Set up CLAUDE.md for large codebase"
  • "Create AGENTS.md for cross-platform support"

Workflow Patterns

工作流模式

Pattern 1: Test-First Development

模式1:测试先行开发

text
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
text
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

Pattern 2: Bug Investigation

模式2:Bug调查

text
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
text
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

Pattern 3: Production Hardening

模式3:生产环境强化

text
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)
text
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)

Pattern 4: Legacy Modernization

模式4:遗留系统现代化

text
LEGACY CODEBASE
qa-refactoring ────────────► Characterization tests
qa-testing-strategy ───────► Add missing test coverage
qa-refactoring ────────────► Incremental refactoring
qa-docs-coverage ──────────► Document updated code
MODERNIZED
text
LEGACY CODEBASE
qa-refactoring ────────────► Characterization tests
qa-testing-strategy ───────► Add missing test coverage
qa-refactoring ────────────► Incremental refactoring
qa-docs-coverage ──────────► Document updated code
MODERNIZED

Pattern 5: LLM Agent Quality

模式5:LLM Agent质量

text
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
text
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

Pattern 6: Large Codebase Documentation (100K-1M LOC)

模式6:大型代码库文档(100K-1M LOC)

text
LARGE CODEBASE
claude-code-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

text
LARGE CODEBASE
claude-code-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

Skill Chains

技能链

Chain: Complete QA Setup

链:完整QA设置

qa-testing-strategy → qa-testing-playwright → qa-api-testing-contracts
qa-resilience → qa-observability → qa-debugging
qa-refactoring → qa-docs-coverage
qa-testing-strategy → qa-testing-playwright → qa-api-testing-contracts
qa-resilience → qa-observability → qa-debugging
qa-refactoring → qa-docs-coverage

Chain: Incident Response

链:事件响应

qa-debugging → qa-observability → qa-resilience → qa-refactoring
qa-debugging → qa-observability → qa-resilience → qa-refactoring

Chain: Mobile App Testing

链:移动应用测试

qa-testing-strategy → qa-testing-mobile → qa-testing-ios (if iOS) → qa-testing-android (if Android)

qa-testing-strategy → qa-testing-mobile → qa-testing-ios (if iOS) → qa-testing-android (if Android)

Quality Gates

质量门禁

Pre-Release Checklist

发布前检查清单

GateSkillCriteria
Test coverage
qa-testing-strategy
Coverage targets aligned to risk and critical paths
E2E passing
qa-testing-playwright
Critical paths green
API contracts
qa-api-testing-contracts
Schema validation passing
Error handling
qa-resilience
Circuit breakers configured
Monitoring
qa-observability
SLOs defined, alerts set
Docs
qa-docs-coverage
API + README complete
门禁技能标准
测试覆盖
qa-testing-strategy
覆盖目标与风险和关键路径对齐
E2E测试通过
qa-testing-playwright
关键路径测试通过
API契约
qa-api-testing-contracts
Schema验证通过
错误处理
qa-resilience
已配置断路器
监控
qa-observability
已定义SLO,设置告警
文档
qa-docs-coverage
API + README完整

Post-Incident Checklist

事件后检查清单

GateSkillAction
Root cause
qa-debugging
Document findings
Regression test
qa-testing-strategy
Add test for failure mode
Prevention
qa-resilience
Add/tune circuit breaker
Visibility
qa-observability
Add missing traces/alerts

门禁技能操作
根本原因
qa-debugging
记录调查结果
回归测试
qa-testing-strategy
针对故障模式添加测试
预防措施
qa-resilience
添加/调整断路器
可见性
qa-observability
添加缺失的追踪/告警

Routing Matrix

路由矩阵

User IntentPrimary SkillSupporting Skills
Plan tests
qa-testing-strategy
qa-testing-playwright
,
qa-api-testing-contracts
Write E2E
qa-testing-playwright
qa-testing-strategy
Test mobile
qa-testing-mobile
,
qa-testing-ios
, or
qa-testing-android
qa-testing-strategy
Test API
qa-api-testing-contracts
qa-testing-strategy
Test agent
qa-agent-testing
qa-testing-strategy
Debug issue
qa-debugging
qa-observability
,
qa-resilience
Setup monitoring
qa-observability
qa-debugging
Add resilience
qa-resilience
qa-observability
Refactor code
qa-refactoring
qa-testing-strategy
Audit docs
qa-docs-coverage
docs-codebase
Large codebase setup
claude-code-project-memory
qa-docs-coverage
,
docs-codebase

用户意图主技能支持技能
规划测试
qa-testing-strategy
qa-testing-playwright
,
qa-api-testing-contracts
编写E2E测试
qa-testing-playwright
qa-testing-strategy
移动应用测试
qa-testing-mobile
,
qa-testing-ios
qa-testing-android
qa-testing-strategy
API测试
qa-api-testing-contracts
qa-testing-strategy
Agent测试
qa-agent-testing
qa-testing-strategy
调试问题
qa-debugging
qa-observability
,
qa-resilience
设置监控
qa-observability
qa-debugging
添加韧性
qa-resilience
qa-observability
重构代码
qa-refactoring
qa-testing-strategy
审计文档
qa-docs-coverage
docs-codebase
大型代码库设置
claude-code-project-memory
qa-docs-coverage
,
docs-codebase

Cross-Router Handoffs

相关路由器

To router-engineering

When user needs implementation:
  • "Build the feature" → Route to
    software-backend
    or
    software-frontend
  • "Implement the fix" → Route to relevant engineering skill
路由器关系
router-operations
父路由器;包含QA + DevOps + git
router-engineering
实现任务的移交目标
router-startup
业务/产品问题的移交目标

To router-operations

When user needs deployment/infra:
  • "Deploy to production" → Route to
    ops-devops-platform
  • "Setup CI/CD" → Route to
    ops-devops-platform

From router-operations

When operations router detects QA needs:
  • "Test strategy" → Route here
  • "Debug production issue" → Route here
  • "Add resilience" → Route here

Quick Reference Commands

NeedDo This
Test strategy
qa-testing-strategy
E2E tests
qa-testing-playwright
iOS tests
qa-testing-ios
Android tests
qa-testing-android
Mobile tests
qa-testing-mobile
API tests
qa-api-testing-contracts
Agent tests
qa-agent-testing
Debug issue
qa-debugging
Monitoring
qa-observability
Resilience
qa-resilience
Refactoring
qa-refactoring
Doc quality
qa-docs-coverage

Related Routers

RouterRelationship
router-operations
Parent router; includes QA + DevOps + git
router-engineering
Handoff target for implementation tasks
router-startup
Handoff target for business/product questions