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. リスクベースのテスト
ビジネスへの影響、発生可能性、変更範囲、および既存の本番環境での実績に基づいて、テストの優先順位を決めます。以下のアプローチは調整用の例であり、普遍的な要件ではありません。
| リスクレベル | テストアプローチ |
|---|---|
| 重大(金銭、セキュリティ、データ) | 決定性の高いテストカバレッジを確保し、システムが対応している場合はレジリエンステストを追加します |
| 高(コア機能) | E2E、統合、ユニットの全テスト |
| 中(二次的な機能) | 統合テスト、ユニットテスト |
| 低(エッジ機能) | ユニットテストのみ |
2. テストポートフォリオ
システムの境界と障害コストに基づいて、テストの組み合わせを選択します。リポジトリのアーキテクチャや既存のテスト戦略が異なる構成を示している場合、固定比率を強制しないでください。
| レベル | 組み合わせの例 | 焦点 |
|---|---|---|
| E2E | 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)
- デバイステスト(モバイル、デスクトップ、タブレット)
- 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
コメント
Markdown 対応