mcpField
Q
qa-expert

qa-expert

github.com/zhaono1テスト・品質85755 回インストール9 週間前に更新
リポジトリ

qa-expert について

QA Expertは、テストや品質ゲートを計画するチーム向けの品質保証スキルです。リスクベースのテスト方針、テスト分類、計画テンプレートに加え、テスト計画やカバレッジ分析のスクリプト例を提供します。

主な機能

  1. 01リスクベースのテストを計画
  2. 02品質ゲートを定義
  3. 03機能・非機能テストを選定
  4. 04テスト計画を作成
  5. 05テストカバレッジを分析

活用シーン

  1. 01機能のテストを計画
  2. 02マージやリリース前の確認項目を設定
  3. 03テストカバレッジと品質指標を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zhaono1/agent-playbook --skill qa-expert

インストール後、Claude Code で/qa-expertを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
gates.md
metrics.md
strategy.md
scripts/
coverage_analysis.py
generate_test_plan.py

詳細

QA エキスパート

包括的なテスト戦略と品質ゲートの策定を支援する品質保証のスペシャリストです。

このスキルが有効になる場合

次のような場合に有効になります。

  • QA 戦略を尋ねる
  • 品質ゲートが必要である
  • テストカバレッジを向上させたい
  • テストアプローチを計画する

品質保証戦略

1. リスクベースのテスト

ビジネスへの影響、発生可能性、変更範囲、および既存の本番環境での実績に基づいて、テストの優先順位を決めます。以下のアプローチは調整用の例であり、普遍的な要件ではありません。

リスクレベルテストアプローチ
重大(金銭、セキュリティ、データ)決定性の高いテストカバレッジを確保し、システムが対応している場合はレジリエンステストを追加します
高(コア機能)E2E、統合、ユニットの全テスト
中(二次的な機能)統合テスト、ユニットテスト
低(エッジ機能)ユニットテストのみ
2. テストポートフォリオ

システムの境界と障害コストに基づいて、テストの組み合わせを選択します。リポジトリのアーキテクチャや既存のテスト戦略が異なる構成を示している場合、固定比率を強制しないでください。

レベル組み合わせの例焦点
E2E10%重要なユーザージャーニー
統合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)
  • デバイステスト(モバイル、デスクトップ、タブレット)
  • OS テスト(Windows、macOS、Linux)
  • バージョンテスト(ブラウザーの N-1 バージョン)
リグレッションテスト
  • 以前のバグが再発しない
  • 新機能が既存機能を壊さない
  • パフォーマンスが低下しない
探索的テスト
  • 予期しない問題を見つける
  • エッジケースをテストする
  • ユーザーエクスペリエンス上の問題を見つける

テスト計画

テスト計画テンプレート
# 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 LOC あたり < 1 件
  • 重大な欠陥:0 件
  • 高優先度の欠陥:0 件
  • 中優先度の欠陥:< 3 件
テストメトリクス
  • テスト合格率:> 95%
  • 不安定なテスト:0 件
  • テスト実行時間:< 10 分

自動化戦略

自動化する場合
  • テストが頻繁に実行される
  • テスト結果が決定的である
  • テストが安定している
  • ROI によって自動化コストが正当化される
自動化しない場合
  • テストに人間の判断が必要である
  • テストが探索的である
  • テストが一度限りである
  • テストが頻繁に変更される

バグ報告テンプレート

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

コメント