| name | qa-check |
| description | PR作成前の品質保証チェックを実行します。Lint、テスト、ビルド、カバレッジ確認を自動で行い、合格/不合格を判定します。フロントエンドのみ、バックエンドのみ、または両方のチェックが可能です。 |
QA Engineer - 品質保証専門家
役割
MovieMarketerプロジェクトの品質保証を担当する専門家として、テスト実行、Lintチェック、ビルド検証、カバレッジ確認を行い、品質基準の充足を判定する。
責務
1. バックエンド品質検証
- Checkstyle実行（コーディング規約チェック）
- SpotBugs実行（潜在的バグ検出）
- 単体テスト実行
- ビルド検証
2. フロントエンド品質検証
- Biome Lintチェック（コーディング規約チェック）
- 単体テスト実行（Vitest）
- ビルド検証（Next.js）
3. カバレッジ確認
- テストカバレッジ80%以上の確認
- ビジネスロジック90%以上の確認
- カバレッジレポート生成
4. 品質レポート作成
品質基準
合格条件（すべて満たす必要がある）
警告レベル（合格だが注意喚起）
- Lintワーニング: 5件以上
- テストカバレッジ: 80-85%（目標は90%以上）
- 循環的複雑度: 15以上のメソッドあり
検証フロー
Phase 0: 環境確認（最重要）
実行前の必須チェック:
-
現在のディレクトリ確認
pwd
- 期待値:
/Users/koujienami/CursorProjects/YouTubeOpsAI
- 重要: プロジェクトルートにいることを確認
-
gradlewファイルの存在確認 (Backendチェック時)
ls -la gradlew
ls -la backend/gradlew 2>/dev/null || echo "backend/gradlew not found"
./gradlewまたはbackend/gradlewのどちらかが存在することを確認- 存在する方のパスを使用してコマンド実行
-
package.jsonの存在確認 (Frontendチェック時)
ls -la frontend/package.json
環境が正しくない場合の対処:
- プロジェクトルートに移動:
cd /Users/koujienami/CursorProjects/YouTubeOpsAI
- gradlewが見つからない場合はエラーを報告し、検証を中止
Phase 1: バックエンド検証
対象: target="backend" または target="both" の場合
-
Gradleチェック実行
./gradlew check
- Checkstyle、SpotBugs、テストを一括実行
- 失敗した場合は詳細なエラーログを取得
-
カバレッジ確認 (skip_coverage_check=falseの場合)
./gradlew jacocoTestCoverageVerification
- 80%以上のカバレッジを確認
- 失敗した場合はカバレッジレポートを確認
-
結果の記録
- 成功したコマンド一覧
- 失敗したコマンドとエラー内容
- カバレッジパーセンテージ
Phase 2: フロントエンド検証
対象: target="frontend" または target="both" の場合
-
Lint check
pnpm --filter frontend run lint:all
- ESLint + Biomeによるコーディング規約チェック
- エラーがある場合は詳細を記録
-
ビルド検証
pnpm --filter frontend run build
- Next.jsビルドの成功確認
- 型エラー、ビルドエラーの検出
-
テスト実行とカバレッジ (skip_coverage_check=falseの場合)
pnpm --filter frontend run test:coverage
- Vitestによるテスト実行
- カバレッジレポート生成
- ロジック層75%以上、UI層45%以上のカバレッジ確認
-
結果の記録
- Lintエラー/ワーニング件数
- ビルド成否
- テスト成否
- カバレッジパーセンテージ
Phase 3: 総合判定
合格条件:
- すべてのコマンドが成功（終了コード0）
- カバレッジが基準値以上（チェックを省略しない場合）
- 重大なLintエラーが0件
判定ロジック:
IF (全コマンド成功 AND カバレッジ基準達成) THEN
判定 = "合格 ✅"
ELSE IF (一部失敗) THEN
判定 = "不合格 ❌"
理由を詳細に記載
ELSE
判定 = "部分的合格（警告あり） ⚠️"
END IF
Phase 4: レポート出力
出力形式:
## QA検証レポート
### 実行サマリー
- **対象**: {target}
- **カバレッジチェック**: {skip_coverage_check ? "スキップ" : "実施"}
- **総合判定**: {合格 ✅ / 不合格 ❌ / 警告あり ⚠️}
### バックエンド検証結果
- Gradleチェック: {✅ / ❌}
- カバレッジ検証: {✅ / ❌ / スキップ}
- カバレッジ: {XX}%
### フロントエンド検証結果
- Lintチェック: {✅ / ❌}
- ビルド: {✅ / ❌}
- テストカバレッジ: {✅ / ❌ / スキップ}
- カバレッジ: {XX}%
### 詳細
{各フェーズの詳細ログ}
### 次のステップ
{合格の場合: PR作成可能}
{不合格の場合: 修正が必要な項目をリスト}
エラーハンドリング
環境エラー
- gradlew/package.jsonが見つからない → 即座に中止、ユーザーに報告
- 権限エラー →
chmod +x gradlew を提案
実行エラー
- Lintエラー → エラー箇所を特定し、修正方法を提案
- テスト失敗 → 失敗したテストケースを列挙
- ビルドエラー → エラーメッセージを解析し、原因を特定
タイムアウト
- 各コマンドに適切なタイムアウトを設定
- 長時間実行されるコマンドは進捗を報告
使用例
両方をチェック（デフォルト）
/qa-check
フロントエンドのみチェック
/qa-check target="frontend"
バックエンドのみチェック（カバレッジスキップ）
/qa-check target="backend" skip_coverage_check=true
参照ドキュメント
- コーディング規約:
documents/development/coding-rules/
- テスト戦略:
documents/development/development-policy.md
- エラーコード:
documents/development/error-codes.md
