---

name: master-data-helper description: Manages MasterMemory master data. MUST use proactively when adding or modifying master tables, creating Domain models for static data, or syncing JSON files. Also triggers on "マスターデータ", "MasterMemory". allowed-tools: Read, Grep, Glob, Edit, Write

Master Data Helper

References

• Domain層仕様: docs/Spec/domain-layer.md
• MasterMemory公式: https://github.com/Cysharp/MasterMemory

File Locations

新規テーブル追加フロー

Step 1: CSVファイル作成

CopyMasterData/CSV/sample_master.csv

Copyid,category,name,description
1,weapon,Sword,A basic sword
2,weapon,Shield,A wooden shield
3,armor,Helmet,Iron helmet

ヘッダー命名規則: snake_case（C#プロパティはPascalCaseに自動変換）

Step 2: テーブルクラス定義

Copy// Assets/Scripts/MasterData/Tables/SampleMaster.cs
[MemoryTable("sample_master")]
public sealed record SampleMaster
{
    [PrimaryKey]
    public int Id { get; init; }

    [SecondaryKey(0)]
    public string Category { get; init; }

    public string Name { get; init; }

    public string Description { get; init; }
}

Step 3: バイナリ生成

Unity Editorメニュー:

CopyTools → MasterData → Generate Binary from CSV

生成先: Assets/StreamingAssets/MasterData/master_data.bytes

Step 4: リポジトリ実装（必要な場合）

Copy// Features/[Feature]/Infrastructure/Repositories/MasterData/SampleMasterRepository.cs
public sealed class SampleMasterRepository : ISampleMasterRepository
{
    private readonly MemoryDatabase _database;

    public SampleMasterRepository(MemoryDatabase database)
    {
        _database = database;
    }

    public SampleMaster FindById(int id)
        => _database.SampleMasterTable.FindById(id);

    public IEnumerable<SampleMaster> FindByCategory(string category)
        => _database.SampleMasterTable.FindByCategory(category);
}

Model Template

Copy[MemoryTable("table-name")]
public sealed record TableName
{
    [PrimaryKey]
    public int Id { get; init; }

    [SecondaryKey(0)]  // インデックス番号で複数キー対応
    public string Category { get; init; }

    public string Name { get; init; }

    // 複合キーの例
    [SecondaryKey(1, keyOrder: 0)]
    public int GroupId { get; init; }

    [SecondaryKey(1, keyOrder: 1)]
    public int SubId { get; init; }
}

Troubleshooting

よくあるエラーと対処

デバッグ用コマンド

Copy# CSVファイル一覧確認
ls MasterData/CSV/

# バイナリ更新日時確認
ls -la Assets/StreamingAssets/MasterData/

Checklist

• CSVファイル作成（ヘッダーはsnake_case）
• テーブルクラス作成（[MemoryTable], [PrimaryKey]）
• バイナリ生成（Tools → MasterData → Generate Binary from CSV）
• 主キーが一意であることを確認
• SecondaryKeyのインデックス番号が正しい
• リポジトリ実装（検索メソッドが必要な場合）
• DIコンテナへの登録