| name | author-static-data |
| description | reg 非依存の**全件名辞書**（`data/languages/*.yaml`）を PokeAPI 由来の全件名（ja/en）で満たす手順 skill。 「全件名を languages へ入れて」「名前辞書を埋めて」「ja/en 名が欠けている種族 / 持ち物 / 技 / 特性 / タイプ / メガを 埋めて」「PokeAPI の names / form_names を全件取り込んで」「pokeapi-names workflow を回して languages を更新して」 「languages の空骨格を scaffold して」「メガ名を PokeAPI で埋めて」「author-static-data <id...>」と言われた とき、または showdown 経路で解禁データを入れた後に名前が空のエントリを補うときに使う。取得 + 整形 + 書き込み + PR は **GitHub Actions `pokeapi-names.yml`**（全件列挙）が行い、本 skill はその dispatch → 生成 PR のドライブ → PokeAPI 非存在分の手作業著述（メガストーン名は命名慣例 / **Champions オリジナル特性・技名は Bulbapedia** 出典）→ verify → merge をドライブする。メガ名は PokeAPI `pokemon-form` の form_names（is_mega 判別）から取る 6 種目（ADR 0043）。構造データ（種族値 / タイプ / 特性 id / 図鑑番号 / category）の取得は pokemon-showdown 経路（`showdown:*`）、Champions 解禁データ（roster / 技 / メガ構造）の取得は Serebii 速報 / showdown 経路の責務で、こちらは **reg 非依存の名前辞書**のみを担う。生成 / 検証は `generate:data` / `verify` に委譲し機械ゲートは再実装しない。 |
| allowed-tools | Bash(pnpm *), Bash(node scripts/*), Bash(node src/cli/*), Bash(gh *), Read, Write, Edit |
author-static-data — reg 非依存の全件名辞書（languages）を整備する
data/languages/*.yaml（名前 SoT・ゲーム非依存）を PokeAPI 由来の全件名（ja/en）で満たす skill。
author-regulation-data（reg 依存の解禁データ）と対になり、こちらは reg 非依存の「名前辞書」を担当する。
languages は未解禁を含む全件名辞書で（ADR 0041）、species / moves / abilities / types / mega を
PokeAPI から全件取得する。mega は pokemon-form の form_names（is_mega で判別）から ja/en を両取りする 6 種目
（従来の en=showdown / ja=手作業は撤回・ADR 0043）。items だけは list 全件でなく item-category whitelist の
union で列挙し対戦持ち物 ~270 件に絞る（ADR 0042・詳細は [[data-pipeline]]）。
データ構造・SoT の正本は [[data-pipeline]]（specs / languages / 取得 → 転記 → 合成 / 名前の取得元分担表）。
languages を全件名辞書化し generate を superset 判定へ緩める「なぜ」は
ADR 0041、3 軸直交・名前 SoT を languages へ一本化
する「なぜ」は ADR 0035。日本語名 ja の取得元を
PokeAPI names にする「なぜ」は ADR 0032。
本 SKILL.md は取り込み手順に専念し、SoT / 数式 / 型パターンを二重記述しない。
なぜこの skill があるか
名前は取得元で分担する（取得元・更新頻度・情報源が異なるため・[[data-pipeline]]）: species / items /
moves / abilities / types の ja/en は PokeAPI names から、mega の ja/en は PokeAPI pokemon-form の
form_names（is_mega で判別・ADR 0043）から全件取得する（すべて本 skill・reg 非依存）。全件名を人手で 1 件ずつ
入れると漏れ・非決定になるため、取得 + 整形 + 書き込み + PR は GitHub Actions pokeapi-names.yml（全件列挙・
showdown-sync.yml / serebii-bulletin.yml と同型）に機械化し、本 skill はその dispatch と生成 PR のドライブ
（PokeAPI 非存在の手作業 gap = メガストーン等の差分チェック含む）に専念する。
入力 / 出力
- 入力: 全件名辞書を満たしたい / 名前が空のエントリを補いたい要求。多くは showdown / Serebii 経路で解禁
データ（specs / per-reg / en）を入れた後に
languages/*.yaml の名前が空で残ったエントリ、または全件投入。
- 出力:
data/languages/{species,items,moves,abilities,types,mega}.yaml への PokeAPI 由来**全件名（ja/en）**の
append/既存尊重転記（pokeapi-names.yml が実行・mega は pokemon-form form_names 経路・ADR 0043）。- PokeAPI 非存在の手作業カバー箇所の著述: メガストーン item 名（命名慣例 + Serebii Champions ページで en 照合）と
Champions オリジナル特性/技名（
isNonstandard: "Future"・Bulbapedia を ja/en 出典に著述・手順 3）。
data/languages/*.yaml の空骨格 scaffold（data/ 完全削除からの復元時・mega.yaml 含む 6 ファイル）。pnpm generate:data / pnpm verify が緑（生成段 tsc が spec の名前欠落・ja/en 欠けを弾く・余剰名は許容・ADR 0041）。
手順
1. workflow を dispatch する（全件取得 → 転記 → PR）
gh workflow run pokeapi-names.yml（workflow_dispatch・regulation 入力なし＝名前は reg 非依存）で、
PokeAPI list endpoint の全件列挙（総数 count と受信 id 数の一致を fail-fast し全件受信を保証する = 差分・
冪等判定の前提。200 応答でも limit cap で results が不足しうるため件数照合を初版から入れる。ただし items は
list 全件でなく item-category whitelist の union で列挙し、category endpoint は count/limit ページングを持たないため
件数照合でなく各 cat 404 でない + union 空でないを fail-fast にする。mega は pokemon-form list を全件列挙して
is_mega 候補 slug に絞り、各 form の form_names から ja/en を取る 6 種目・ADR 0043）→
fetch:ja-names（未記録 / 欠落 id のみ best-effort 取得・差分・冪等）→
sync:ja-names（raw → languages へ ja/en を append/既存尊重転記）→ check:yaml-style / generate:data /
pnpm verify → data:names ラベルの languages 更新 PR 作成、までを CI 上で回す。以降の再実行は差分（未記録
id）だけを追加する。ローカルで確認するなら pnpm fetch:ja-names → pnpm sync:ja-names を逐次実行する（同一挙動）。
2. 生成 PR をドライブする
立った PR を gh pr view で確認し、CI（pnpm verify）が緑・差分が意図どおり（未解禁名の追加のみ）かをレビュー
する。生成データの妥当性（名前の正しさ）は pokemon-data-reviewer agent に委ねる（本 skill は機械ゲートを再実装
しない・[[skill-authoring]]）。
3. PokeAPI 非存在の手作業カバー箇所を出典から著述する（gap 照合）
メガ名（ja/en）は PokeAPI pokemon-form の form_names から全件埋まる（手順 1・手作業不要・ADR 0043）。一方
PokeAPI に無い Champions 固有の名前（メガストーン item 名 / Champions オリジナル特性・技名）は全件取得の対象外で、
出典から手作業で著述する導線が要る。取得元は category で分かれる（下表）。いずれも ja を発明せず出典で裏取りし
（推測 ja は data 信頼性を壊す・[[data-pipeline]]）、該当 languages ファイルへ block スタイル（check:yaml-style
通過・flow 禁止）・ソート位置・append/既存尊重（既存値は上書きしない）で書き足す。
| category | PokeAPI | Serebii ja | 出典（手作業著述） |
|---|
| メガストーン item 名 | item スタブのみ・names 空 | itemdex Japanese Name 欄も空 | 命名慣例（ベース種族カタカナ + ナイト・末尾長音ー/撥音ンは1字落とし・X/Y は全角Ｘ／Ｙ・例外 チリーン→チリーンナイト） |
| Champions オリジナル特性/技名 | 非存在（isNonstandard: "Future"） | newabilities/megaabilities/moves ページは en のみで ja 空 | Bulbapedia（<Name> (Ability) / <Name> (Move) ページが en + 日本語名を両取り可） |
欠落の一括把握（generate:data は最初の欠落名で throw するため diff で一括する）: specs の id 集合と languages の
id 集合を直接 diff する。例（特性）= ability-specs.yaml（seq）の各値 vs languages/abilities.yaml（map）の
キー集合。技は move-specs.yaml（map）vs languages/moves.yaml。差集合が手作業著述の対象 id。
Champions オリジナル特性/技名の手順:
- 欠落 id を把握（上記 diff）。Champions オリジナル特性は base showdown の
isNonstandard: "Future" 群
（例: eelevate / fire-mane / dragonize / mega-sol 等。集合は showdown 更新で増減しうるので diff で都度確認）。
- 出典 = Bulbapedia の
<Name> (Ability) / <Name> (Move) ページで en + 日本語名を確認する（Serebii の Champions
特性ページは en のみで ja が空ゆえ ja 源にしない）。en は showdown の .name と一致するはず。
- id 導出 =
kebabId(name)（showdown 表示名 → 小文字 kebab・src/codegen/showdown/ids.ts。例
Fire Mane → fire-mane / Eelevate → eelevate）。この id で languages に無ければ新規著述する。
- 著述例:
eelevate = うなぎのぼり（メガエレキブル）/ fire-mane = ほのおのたてがみ（メガピロオル）。
メガストーン item 名の照合先として pokeapi-names.yml の生成 PR body に Serebii Champions ページ 5 本が提示される
（items / moves / pokemon / megaabilities / newabilities.shtml）。ストーン名の en 照合や解禁の目視確認に使う
（ストーン ja は上表のとおり命名慣例で著述）。
いずれも追加後 pnpm generate:data → pnpm verify で緑（欠落解消）を確認する。
4. data/ 完全削除からの復元（scaffold 不要・plan 11 P2/P4）
data/languages/ が無い状態からでも scaffold / seed は不要。sync:ja-names（materialize.ts）が欠損ファイル /
null map を block YAMLMap 新規作成で埋め（純関数 getOrCreateBlockMap）、fetch:ja-names の readLangMap も
欠損を空マップ扱いで吸収する。よって手順 1 の workflow（または ローカル fetch:ja-names → sync:ja-names）を
そのまま回すだけで 6 ファイル（species 〜 types + mega・pokemon-form form_names 経路・ADR 0043）が全件で
埋まる。distinct-forms（rotom-wash / raichu-alola / basculegion-female 等・pokemon-species list に個別 id が
無いタイプ / 種族値差のある form）は fetch-pokeapi.ts の fetchDistinctForms が varieties を辿って含有判定合成し
species raw へ合成する（P4・[[data-pipeline]]）。rules.yaml / type-specs.yaml（data/champions）は本 skill の
対象外の静的コミットで、削除時は別途手作業復元する（[[data-pipeline]]）。
5. generate:data / verify で緑を確認する（委譲）
pnpm generate:data（specs / languages / per-reg YAML → TS 変換・合成・raw 非依存・spec の名前欠落は
生成段エラー・余剰名は許容・ADR 0041）で緑を確認する。検証まで通すなら verify
（pnpm verify）。機械ゲートは再実装せず委譲する（[[skill-authoring]]）。
Gotchas
- from-scratch 復元は scaffold/seed 不要・generate を先に（plan 11 P1/P2/P4）:
data/languages/* を完全削除
しても sync:ja-names が欠損ファイルから block map を新規作成し（getOrCreateBlockMap）、distinct-forms
（rotom-wash / basculegion-female 等）は fetchDistinctForms が varieties から含有判定合成する。workflow は
generate:data を check:yaml-style の前に走らせる（check:yaml-style は CLI 経由で
src/generated/languages/*.ts を import するため、生成 ts 撤去状態では generate を先にしないと起動不可）。詳細は
[[data-pipeline]]。
- 責務は reg 非依存の名前辞書のみ: 本 skill は名前 SoT（languages）の全件名（ja/en）だけを担う。構造データ
（種族値 / タイプ / 特性 id / 図鑑番号 / category）と en の正は pokemon-showdown 経路（
showdown:*）、
Champions 解禁（roster / 技 / メガ構造 + linking）は Serebii 速報 / showdown 経路の責務（[[data-pipeline]]）。
**mega の名前だけは本 skill（PokeAPI form_names・ADR 0043）**が担う。
- append/既存尊重を壊さない:
sync:ja-names は未設定フィールドのみ埋め、既存の en（showdown 正）/ 著述値を
上書きしない。conflict が出たら値の出自を確認して解消する（生成物を直さず languages を直す）。手作業 gap 補填も
既存値を上書きしない。
- mega も PokeAPI 対象（6 種目）:
languages/mega.yaml の ja/en は workflow が pokemon-form の form_names
（is_mega で判別）から全件埋める（従来の en=showdown / ja=手作業は撤回・ADR 0043）。PokeAPI slug は pokeform の
mega id 規約と一致するため id 正規化は不要。*-mega-z 等の未実装 form は orphan 名として入るが superset で無害
（生成データレビューで確認）。手作業が残るのはメガストーン item 名など PokeAPI 非存在の名前のみ（手順 3）。
- PokeAPI が ja を持たない id は捏造せず skip: list に含まれても ja 未収録の id（GO 専用特性
is_main_series:false / Legends Arceus 未ローカライズ球 la*-ball / 未ローカライズ新特性 等）は NameEntry の
ja/en 必須と衝突するため append せず skip（推測 ja を発明しない = data 信頼性を守る・sync:ja-names は
skippedCount を warn で可視化する）。spec が参照して ja が要る id だけ手作業 ja で補う。
- 「全件」の基準は PokeAPI list 列挙 + distinct-forms（items を除く）: 全件辞書の母集合は PokeAPI の list endpoint
列挙に加え、各 species の varieties から機械列挙した distinct-forms（
rotom-wash / basculegion-female 等・タイプ /
種族値が base と異なる form・P4）を含む。live count（例 species 1025）と languages 件数（distinct-forms 約87件を足して
1100 超）が食い違うのは仕様どおりで、「壊れたデータ」ではない（★XxxNNN 等の未翻訳カタログコードも PokeAPI の実データで正）。items の母集合は list 全件でなく item-category whitelist の union（対戦
持ち物 ~270 件・ADR 0042）で、ボール / 回復薬 / TM / 料理素材等が意図的に落ちるのは仕様どおり（whitelist カテゴリの
正本は [[data-pipeline]]）。
- 全件辞書は superset を許容: languages は spec を持たない未解禁名（orphan）も持つ（reg 非依存の全件辞書・
ADR 0041）。generate は「spec に名前がある / ja・en 完備」だけを保護し、余剰 languages 名は 0 終了で許容する。
逆に spec に対応する名前が欠ける / ja・en 欠けは非0終了で弾く。
- 生成物を手編集しない:
src/generated/** は触らず languages を直して再生成する（[[data-pipeline]]）。
- 機械ゲートを再実装しない: 検証は
generate:data / verify、生成データの妥当性は pokemon-data-reviewer
agent（[[skill-authoring]]）。
- cross-agent: workflow dispatch は
gh workflow run、ローカルは fetch:ja-names → sync:ja-names の逐次実行で
完結する。Claude 固有機構（Workflow）を持たず Codex / 素の CLI でも同手順で回る（[[cross-agent]]）。
関連
- データ構造・SoT 正本: [[data-pipeline]]（名前の取得元分担表・全件名辞書 / generate superset）。
- 決定の「なぜ」: ADR 0041（languages 全件名辞書・
generate superset・PokeAPI 名前取得 workflow）/ ADR 0043
（mega 名を PokeAPI pokemon-form form_names へ一本化・6 種目）/
ADR 0035
（構造 = specs / 名前 = languages の 3 軸直交）/
ADR 0032（日本語名 ja は PokeAPI names）。
- 名前取得 workflow:
.github/workflows/pokeapi-names.yml。
- 構造 / 解禁データ取得:
showdown:species / showdown:moves / showdown:items / showdown:abilities / showdown:mega。
- 検証 / 生成:
verify / pnpm generate:data。
- 生成データ妥当性:
pokemon-data-reviewer agent。
- skill 作成方針・cross-agent: [[skill-authoring]] / [[cross-agent]]。
