name: masterdata-csv-validator description: GLOWマスタデータCSVの検証スキル。作成したCSVファイルがDB投入可能か、server/client実装と整合性があるかをテンプレート、DBスキーマと照合してチェックします。マスタデータ、CSV検証、バリデーション、チェックで使用します。

GLOWマスタデータCSV検証スキル

概要

作成したマスタデータCSVファイルがDB投入可能か、server/client実装の想定と整合性があるかを検証します。以下の検証を自動実行：

テンプレート一致: 列順・列名がテンプレートCSVと一致するか（データ投入シートとの整合性）
CSV形式: 改行エスケープ、ダブルクォート等の形式が正しいか（DB投入可能性）
必須カラム: NULL不可カラムに値が設定されているか（DB制約違反防止）
DBスキーマ整合性: 型、enum値がスキーマと一致するか（実装との整合性）

基本的な使い方

単一ファイルの検証

python .claude/skills/masterdata-csv-validator/scripts/validate_all.py \
  --csv path/to/MstEvent.csv

出力例（成功）:

{
  "file": "MstEvent.csv",
  "valid": true,
  "validations": {
    "template": {"valid": true, "issues": []},
    "format": {"valid": true, "issues": []},
    "schema": {"valid": true, "issues": []}
  },
  "summary": {
    "total_issues": 0,
    "critical_issues": 0,
    "warnings": 0
  }
}

出力例（エラー）:

{
  "file": "OprGacha.csv",
  "valid": false,
  "validations": {
    "template": {
      "valid": false,
      "issues": [
        {
          "type": "column_order",
          "expected": ["id", "gacha_id", "name"],
          "actual": ["id", "name", "gacha_id"]
        }
      ]
    },
    "schema": {
      "valid": false,
      "issues": [
        {
          "type": "value_validation_error",
          "row": 8,
          "column": "gacha_type",
          "value": "Ultra",
          "message": "enum値 ['Normal', 'Special', 'Limited'] のいずれかが期待されますが、'Ultra' は許可されていません"
        }
      ]
    }
  },
  "summary": {
    "total_issues": 2,
    "critical_issues": 2,
    "warnings": 0
  }
}

個別の検証スクリプト

特定の検証のみ実行したい場合：

テンプレート検証のみ:

python .claude/skills/masterdata-csv-validator/scripts/validate_template.py \
  --generated path/to/MstEvent.csv \
  --template projects/glow-masterdata/sheet_schema/MstEvent.csv

CSV形式検証のみ:

python .claude/skills/masterdata-csv-validator/scripts/validate_csv_format.py \
  path/to/MstEvent.csv

DBスキーマ検証のみ:

python .claude/skills/masterdata-csv-validator/scripts/validate_schema.py \
  --csv path/to/MstEvent.csv \
  --schema projects/glow-server/api/database/schema/exports/master_tables_schema.json \
  --table mst_events

ワークフロー

Step 1: マスタデータ作成後の検証

マスタデータCSVを作成したら、DB投入前に必ず検証を実行します。

python .claude/skills/masterdata-csv-validator/scripts/validate_all.py \
  --csv path/to/<ファイル名>.csv

Step 2: エラーの確認

検証結果のJSONを確認し、valid: false の場合はエラー箇所を特定します。

重要なフィールド:

valid: 全体の検証結果（true/false）
validations.<種別>.issues: 各検証のエラー詳細
summary.critical_issues: 致命的エラー数
summary.warnings: 警告数

Step 3: エラー修正

エラー種別に応じて修正します。詳細は error-examples.md を参照してください。

主なエラー種別:

column_order: カラム順序不一致 → テンプレートと一致させる
missing_column: カラム欠損 → 不足カラムを追加
extra_column: 余分なカラム → 不要カラムを削除
value_validation_error: 値の検証エラー → 型・enum値を修正
invalid_header: ヘッダー形式エラー → 1-3行目を修正

Step 4: 再検証

修正後、再度検証を実行して valid: true になることを確認します。

複数ファイルの検証

ディレクトリ内の全CSVファイルを一括検証する場合：

for csv in path/to/masterdata/*.csv; do
  echo "Validating $csv..."
  python .claude/skills/masterdata-csv-validator/scripts/validate_all.py \
    --csv "$csv"
done

テーブル名の推測ルール

CSVファイル名から自動的にテーブル名を推測します：

CSVファイル名	推測されるテーブル名
`MstEvent.csv`	`mst_events`
`OprGacha.csv`	`opr_gachas`
`MstUnitI18n.csv`	`mst_units_i18n`

手動でテーブル名を指定する場合は --table オプションを使用します。

検証スクリプト一覧

scripts/validate_all.py（推奨）

統合検証スクリプト。全ての検証を実行して統合レポートを生成します。

scripts/validate_template.py

テンプレートCSVとの照合（列順・列名の一致確認）。

scripts/validate_csv_format.py

CSV形式の正しさを検証（改行エスケープ、ダブルクォート等）。

scripts/validate_schema.py

DBスキーマとの整合性を検証（型、enum値、NULL許可等）。

リファレンス

詳細なルールとエラー修正方法：

検証ルール詳細: validation-rules.md
よくあるエラーと修正方法: error-examples.md

トラブルシューティング

テンプレートファイルが見つからない

エラー:

{
  "warning": "テンプレートファイルが見つかりません: projects/glow-masterdata/sheet_schema/MstEvent.csv",
  "skipped": true
}

対処法:

CSVファイル名がPascalCase + 単数形になっているか確認（例: MstEvent.csv, OprGacha.csv）

テンプレートディレクトリを確認:

ls projects/glow-masterdata/sheet_schema/

スキーマファイルが見つからない