coverage-guard

カバレッジガードモード

有効にすると、テスト実行後にカバレッジをチェックし、設定したしきい値を下回った場合に警告します。

機能

テストが実行されるたびに（Bash ツール経由で）、カバレッジを config.json のしきい値と比較します。カバレッジが低下した場合に警告します（実行はブロックしません）。

有効化

/coverage-guard

設定

このスキルディレクトリにある config.json を編集して、しきい値を設定します。

{
  "thresholds": {
    "statements": 80,
    "branches": 70,
    "functions": 75,
    "lines": 80
  },
  "coverageCommand": "npx jest --coverage --coverageReporters=json-summary",
  "coverageFile": "coverage/coverage-summary.json"
}

フックの設定

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hook": ".claude/skills/coverage-guard/scripts/check-coverage.sh",
        "condition": "command contains 'jest' OR command contains 'vitest' OR command contains 'npm test'"
      }
    ]
  }
}

適用ロジック

#!/bin/bash
# check-coverage.sh
COVERAGE_FILE="coverage/coverage-summary.json"
THRESHOLD=80

if [ -f "$COVERAGE_FILE" ]; then
  STATEMENTS=$(jq '.total.statements.pct' "$COVERAGE_FILE")
  BRANCHES=$(jq '.total.branches.pct' "$COVERAGE_FILE")

  if (( $(echo "$STATEMENTS < $THRESHOLD" | bc -l) )); then
    echo "WARNING: Statement coverage ($STATEMENTS%) below threshold ($THRESHOLD%)"
    echo "Coverage dropped — check which files lost coverage."
  fi

  if (( $(echo "$BRANCHES < 70" | bc -l) )); then
    echo "WARNING: Branch coverage ($BRANCHES%) below 70%"
  fi
fi

注意点

• カバレッジチェックはテストコマンドの実行後に行われます。テストがクラッシュすると、カバレッジレポートは生成されません。
• Coverage-summary.json をレポーターとして設定する必要があります。Jest のデフォルト設定には含まれていない場合があります。
• しきい値の比較には浮動小数点数を使用します。しきい値が 80% の場合、79.999% は下回ったと判定されます。
• ブランチカバレッジは通常、行カバレッジより10～15％低くなります。それに応じてしきい値を設定してください。