关于 qa-expert
QA Expert 是面向需要规划测试和质量门禁团队的质量保证技能。它提供基于风险的测试指导、测试类别、计划模板,以及用于生成测试计划和分析覆盖率的脚本示例。
主要功能
- 01规划基于风险的测试
- 02制定质量门禁
- 03选择功能与非功能测试
- 04编写测试计划
- 05分析测试覆盖率
适用场景
- 01为某项功能规划测试
- 02设置合并或发布前的检查
- 03审视测试覆盖率和质量指标
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ zhaono1/ agent-playbook --skill qa-expert安装后在 Claude Code 中输入/qa-expert确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/gates.mdmetrics.mdstrategy.mdscripts/coverage_analysis.pygenerate_test_plan.py详细介绍
QA 专家
负责制定全面测试策略和质量门禁的质量保障专家。
此技能的激活时机
在以下情况下激活:
- 请求 QA 策略
- 需要质量门禁
- 希望提高测试覆盖率
- 规划测试方法
质量保障策略
1. 基于风险的测试
根据业务影响、发生可能性、变更范围和现有生产环境证据确定测试优先级。以下方法仅供参考,应根据实际情况调整,而非通用要求:
| 风险级别 | 测试方法 |
|---|---|
| 严重(资金、安全、数据) | 强化确定性覆盖;系统支持时增加韧性测试 |
| 高(核心功能) | 完整的端到端、集成和单元测试 |
| 中(次要功能) | 集成测试、单元测试 |
| 低(边缘功能) | 仅单元测试 |
2. 测试组合
根据系统边界和故障成本选择测试组合。如果代码库架构或现有测试策略表明需要采用不同组合,请勿强行套用固定比例。
| 级别 | 示例起始比例 | 重点 |
|---|---|---|
| 端到端 | 10% | 关键用户旅程 |
| 集成 | 30% | API 交互 |
| 单元 | 60% | 业务逻辑、实用工具 |
此表仅供参考。应根据代码库的架构、风险状况、SLO 和现有质量门禁确定实际的测试组合。
3. 质量门禁
提交前
- Lint: npm run lint
- Format check: npm run format:check
- Type check: npm run type-check
- Unit tests: npm run test:unit
合并前
- All tests: npm test
- Coverage threshold: use the repository gate or agree a risk-based target
- Security scan: npm audit
- License check: npm run check:licenses
投产前
- Full test suite: npm run test:all
- E2E tests: npm run test:e2e
- Performance tests: npm run test:perf
- Security audit: npm audit --audit-level high
测试类别
功能测试
目的:验证功能是否符合规范
- 正常路径测试
- 边缘情况测试
- 边界值分析
- 错误处理
非功能测试
性能
- 根据当前 SLO、基线、工作负载和用户旅程推导延迟和吞吐量目标
- 内存使用保持稳定
- 无内存泄漏
安全
- 覆盖 OWASP Top 10
- 渗透测试
- 依赖项漏洞扫描
- 密钥检测
兼容性
- 浏览器测试(Chrome、Firefox、Safari、Edge)
- 设备测试(移动设备、桌面设备、平板电脑)
- 操作系统测试(Windows、macOS、Linux)
- 版本测试(前一个版本的浏览器)
回归测试
- 之前的缺陷不会再次出现
- 新功能不会破坏现有功能
- 性能不会下降
探索性测试
- 发现意外问题
- 测试边缘情况
- 发现用户体验问题
测试计划
测试计划模板
# Test Plan: [Feature Name]
## Overview
[Feature description]
## Scope
[In scope / Out of scope]
## Test Cases
### Functional
- [ ] TC001: [Description]
- [ ] TC002: [Description]
### Integration
- [ ] TC101: [Description]
### E2E
- [ ] TC201: [Description]
## Test Data
[Required test data]
## Environment
[Test environment setup]
## Schedule
[Testing timeline]
## Exit Criteria
[Definition of done]
质量指标
优先使用项目现有的门禁。如果没有,则建立基线并与负责人商定目标;以下数值仅为示例,并非默认验收标准。
代码质量
- 测试覆盖率:> 80%
- 圈复杂度:每个函数 < 10
- 代码重复率:< 5%
- 技术债务比率:< 5%
缺陷指标
- 缺陷密度:每 1000 行代码 < 1 个缺陷
- 严重缺陷:0
- 高优先级缺陷:0
- 中优先级缺陷:< 3
测试指标
- 测试通过率:> 95%
- 不稳定测试:0
- 测试执行时间:< 10 分钟
自动化策略
适合自动化的情况
- 测试经常运行
- 测试结果具有确定性
- 测试稳定
- 投资回报足以抵消自动化成本
不适合自动化的情况
- 测试需要人工判断
- 测试属于探索性测试
- 测试仅运行一次
- 测试内容经常变化
缺陷报告模板
## Bug Summary
[One-line summary]
## Severity
Critical / High / Medium / Low
## Steps to Reproduce
1.
2.
3.
## Expected Behavior
[What should happen]
## Actual Behavior
[What actually happens]
## Environment
- OS:
- Browser:
- Version:
## Attachments
[Screenshots, logs, etc.]
脚本
生成测试计划:
python3 scripts/generate_test_plan.py --name <feature> --output docs/test-plan.md
分析测试覆盖率:
python3 scripts/coverage_analysis.py --name <service-name> --output coverage-analysis.md
参考资料
references/strategy.md- 测试策略references/gates.md- 质量门禁定义references/metrics.md- QA 指标和 KPI
评论
支持 Markdown