ai-rotom: Instructions file for Claude Code

ai-rotom

ポケモンチャンピオンズの対戦アドバイザー MCP サーバー。

基本思想

「プログラムは正確なデータを出す。AI はデータを元に考える。」

機能	プログラム（ツール）の責務	AI の責務
ダメージ計算	正確な数値計算（1 対 1 / 全技 / 6v6 の 3 粒度）	結果の解釈・説明
選出アドバイス	タイプ相性・ダメ計・素早さ等のデータ提供	データを総合して選出を判断・提案
パーティ構築	パーティの弱点・攻撃範囲分析	構築案の提案
対策案	対策候補の提示（find_counters）	勝ち筋の説明

技術スタック

• 言語: TypeScript 6（strict）
• ダメージ計算エンジン: @smogon/calc の Gen 0 (Champions)
  • npm registry から取得（packages/mcp-server の dependencies に exact pin）
• 入力検証: Zod
• パッケージ管理: npm workspaces（workspace は packages/mcp-server のみ）
• ビルド: tsdown（ESM bundle、JSON インライン化）
• テスト: Vitest
• Node.js: >= 24

開発コマンド

npm install          # 依存関係インストール
npm run build        # ビルド
npm test             # テスト実行
npm run test:watch   # テスト監視モード

リポジトリ構成

ai-rotom/
├── tsconfig.base.json           # 共通 TypeScript 設定 (paths alias)
├── data/champions/              # マスターデータ (8 ファイル JSON)
│   ├── pokemon.json             # ポケモン (種族値・タイプ・特性等)
│   ├── abilities.json           # 特性
│   ├── items.json               # 持ち物
│   ├── moves.json               # 技
│   ├── learnsets.json           # 習得技
│   ├── natures.json             # 性格
│   ├── types.json               # タイプ (日英マッピング)
│   └── conditions.json          # 天候/フィールド/状態異常/壁
├── shared/                      # 単純ソースディレクトリ (package.json なし)
│   └── src/
│       ├── index.ts
│       ├── constants/           # DEFAULT_LEVEL, MAX_IV, 性格補正倍率 等
│       ├── utils/               # NameResolver
│       ├── schemas/             # Zod 入力スキーマ
│       ├── types/               # PokemonEntry, PokemonEntryProvider 等
│       ├── analysis/            # タイプ相性・実数値・素早さ比較
│       └── calc/                # ダメージ計算エンジン (DI 対応)
└── packages/
    └── mcp-server/              # 唯一の workspace パッケージ
        └── src/
            ├── index.ts         # エントリ (#!/usr/bin/env node)
            ├── server.ts        # MCP サーバー + ツール登録
            ├── instructions.ts  # MCP instructions テキスト
            ├── data-store.ts    # JSON → Map + PokemonEntryProvider 実装
            ├── name-resolvers.ts
            ├── party-store.ts   # ~/.ai-rotom/parties.json の読み書き (atomic)
            └── tools/
                ├── info/        # 情報取得系
                ├── search/      # 逆引き検索系
                ├── calc/        # 計算系
                ├── analysis/    # 分析系
                └── party/       # パーティ永続化 (save/load/list/delete)