test-metrics-dashboard

テストメトリクスダッシュボード

テスト実行履歴の照会、傾向の特定、実行可能な品質メトリクスの提示を行うデータ分析スキルです。

有効化

/test-metrics-dashboard

主要なメトリクス

テスト健全性メトリクス

メトリクス	計算式	目標	アラート
合格率	合格数 / 合計数	> 95%	< 90%
不安定率	不安定なテスト数 / 合計数	< 5%	> 10%
MTTR	失敗から修正までの平均時間	< 4 hours	> 24 hours
実行時間	テストスイートの合計時間	< 10 min	> 20 min
カバレッジ差分	現在 - 前回	>= 0%	< -2%

データ収集

# Export Jest results to JSON
npx jest --json --outputFile=test-results/$(date +%Y-%m-%d).json

# Parse results for dashboard
jq '{
  date: .startTime,
  total: .numTotalTests,
  passed: .numPassedTests,
  failed: .numFailedTests,
  duration_ms: (.testResults | map(.endTime - .startTime) | add),
  pass_rate: ((.numPassedTests / .numTotalTests) * 100),
  flaky: [.testResults[] | select(.numPendingTests > 0)] | length
}' test-results/$(date +%Y-%m-%d).json

傾向分析

# Compare last 5 runs
for f in $(ls -t test-results/*.json | head -5); do
  jq --arg file "$f" '{
    file: $file,
    pass_rate: ((.numPassedTests / .numTotalTests) * 100 | floor),
    duration_s: ((.testResults | map(.endTime - .startTime) | add) / 1000 | floor)
  }' "$f"
done

失敗数の多いテスト

# Find most frequently failing tests across runs
for f in test-results/*.json; do
  jq -r '.testResults[] | select(.numFailingTests > 0) | .testFilePath' "$f"
done | sort | uniq -c | sort -rn | head -10

実行履歴

ダッシュボードデータを ${CLAUDE_PLUGIN_DATA}/test-metrics.log に保存します。

2026-03-18|95.2|4.1|312|82.5|3

形式：date|pass_rate|flakiness_rate|duration_s|coverage_pct|failed_count

傾向を検出するために履歴を読み込みます：

# Coverage trending down?
tail -5 "${CLAUDE_PLUGIN_DATA}/test-metrics.log" | awk -F'|' '{print $5}' | sort -n | head -1

連携先

以下にデータを提供します：

• /qe-quality-assessment — メトリクスに基づく品質ゲートの判断
• /test-failure-investigator — 失敗数の多いテストを調査
• /coverage-drop-investigator — カバレッジが低下傾向にある場合

注意点

• ベースラインのないメトリクスには意味がありません。傾向を追跡する前にベースラインを設定してください。
• 不安定率は実際より低く報告されます。100回に1回失敗するテストでも、毎週CIを失敗させます。
• テスト数の増加に伴い、実行時間は時間とともに長くなる傾向があります。絶対値ではなく、増加率にアラートを設定してください。
• エージェントは単一の実行結果のメトリクスを「傾向」として報告することがあります。有意な傾向を把握するには、5件以上のデータポイントが必要です。