レッスン8
一括作成と改善
CSVファイルを使った効率的なカード一括生成と、品質向上のための改善プロセスを学びます。
学習目標
- CSVを使った一括カード生成のワークフローを理解する
- 生成されたカードの品質を評価し、改善点を特定する
- polishGameEffectTextの仕組みを理解し、効果テキストを洗練する
CSV一括作成の概要
数十枚のカードを個別に作成するのは時間がかかります。CSV（カンマ区切り値）ファイルを使うことで、 複数のカードデータを一度に管理し、効率的に生成できます。
CSVファイルとは
CSVは、表形式のデータをテキストファイルで保存する形式です。 ExcelやGoogleスプレッドシートで編集でき、データの一括管理に適しています。
分類,物質名,引火点,発火点,比重,蒸気比重,指定数量,水溶性,消火方法 第1石油類,ガソリン,-40,約300,0.65-0.75,3-4,200,非水溶,泡/粉末/CO2 第2石油類,灯油,40以上,220,0.8,4.5,1000,非水溶,泡/粉末/CO2 アルコール類,エタノール,13,363,0.79,1.6,400,水溶,耐アルコール泡/霧状水
効率性
一度に数十枚、数百枚のカードデータを準備し、まとめて生成できます。
一貫性
データ形式が統一されているため、ミスが少なく、品質が安定します。
修正容易性
スプレッドシートで一括編集できるため、パラメータ調整が簡単です。
CSVテンプレートの形式
カード生成ツールに対応したCSVファイルには、以下のカラム（列）を含める必要があります。
| カラム名 | 説明 | 例 |
|---|---|---|
| 分類 | 第4類の7分類名 | 第1石油類、アルコール類 |
| 物質名 | 危険物の名称 | ガソリン、エタノール |
| 引火点 | 引火点（度C） | -40、13、40以上 |
| 発火点 | 発火点（度C） | 約300、363 |
| 比重 | 液体の比重（水=1） | 0.65-0.75、0.79 |
| 蒸気比重 | 蒸気の比重（空気=1） | 3-4、1.6 |
| 指定数量 | 指定数量（L） | 200、400、1000 |
| 水溶性 | 水溶性/非水溶性 | 水溶、非水溶 |
| 消火方法 | 有効な消火方法 | 泡/粉末/CO2 |
データ入力のポイント
- •引火点・発火点の数値は教科書やMSDSで確認してから入力する
- •数値データ（引火点、比重、蒸気比重）は必ず半角数字で入力
- •分類名は正式名称で統一する（「第1石油類」と「1石」を混在させない）
- •水溶性/非水溶性は消火方法と整合性があるか必ず確認
データ入力ワークフロー
スプレッドシート作成
GoogleスプレッドシートまたはExcelで、CSVテンプレートに沿ったシートを作成します。 見出し行に「category, name, attack, defense, effect, illustration_url」を記入。
カードデータ入力
各行にカード情報を入力します。チーム内で分担して効率化しましょう。
特殊引火物, ジエチルエーテル, -45, 160, 0.71, 2.6, 50, 非水溶, 泡/粉末/CO2
CSV形式でエクスポート
「ファイル」→「ダウンロード」→「カンマ区切り値（.csv）」を選択してエクスポートします。 文字コードはUTF-8を選択してください。
カードジェネレーターにアップロード
card-generatorツールのCSVアップロード機能を使い、作成したCSVファイルを読み込ませます。 システムが自動的にすべてのカードを生成します。
生成結果の確認と修正
生成されたカードをプレビューで確認し、問題があればCSVを修正して再アップロードします。 この反復プロセスで品質を向上させていきます。
カード改善プロセス
一括生成後、以下の観点からカードをレビューし、改善を繰り返しましょう。
正確性のチェック
- 危険物の分類や特性が正しく反映されているか
- 効果テキストが実際の危険物取扱の知識と一致しているか
- 数値パラメータが妥当な範囲に収まっているか
ゲームバランスの調整
- 特定のカードが強すぎたり弱すぎたりしないか
- カテゴリ間のバランスが取れているか
- すべてのカードに存在意義があるか（使われないカードがないか）
効果テキストの洗練
polishGameEffectTextという機能が、学生が入力した効果テキストを整頓します。 これにより、表現が統一され、プレイヤーにとって理解しやすいテキストになります。
変換例:
入力: 危険物を大量に運搬できる
出力: 【運搬能力】危険物を大量に運搬できる。この効果は自ターンに1度だけ使用可能。
視覚的一貫性
- イラストのスタイルが統一されているか
- カテゴリごとの色分けが一貫しているか
- フォントサイズや配置に統一感があるか
品質チェックリスト
生成されたカードセット全体をチームでレビューする際に、以下のチェックリストを活用しましょう。
専門知識チェック
デザイン・ゲームバランスチェック
チームレビュー演習
グループ内で以下の手順に従ってカードセットをレビューし、改善案を出し合いましょう。
ステップ1: 個別レビュー（10分）
各メンバーが独立して全カードを確認し、気づいた問題点をメモします。
ステップ2: 問題点の共有（15分）
各メンバーが見つけた問題点を共有し、ホワイトボードやスプレッドシートにリストアップします。
ステップ3: 優先順位付け（10分）
問題点を「重要度」と「修正の難易度」で評価し、どれから取り組むか優先順位を決めます。
ステップ4: 改善案の検討（20分）
優先度の高い問題について、具体的な改善案を議論します。数値調整、テキスト修正、イラスト再生成などの対応を決定します。
ステップ5: 修正と再生成
CSVファイルを修正し、再度カードを生成します。この反復プロセスを経て、高品質なカードセットを完成させます。