| name | verify-showdown-pr |
| description | pokemon-showdown 経路（authoritative）が自動作成した `data:authoritative` ラベルの data 更新 PR の正確性を、 Serebii 速報スクレイパーを流用して照合し PR コメント + exit code（0=一致 / 1=差異）で返す手順 skill。 「showdown の PR を Serebii で照合して」「`data:authoritative` の data 更新 PR を確認して」「この showdown-sync の PR は正しい?」「verify-showdown-pr <PR>」「showdown 経路の YAML 差分を Serebii で裏取りして」と言われたとき、 または showdown-sync.yml が立てた解禁データ PR をマージ前に検証したいときに使う。WebFetch は使わず Serebii スクレイパー（`node scripts/scrape-serebii.ts`）の中間 JSON で照合する。レビュー観点・出力は code-review / redaction に準拠し、機械ゲート（型 / カバレッジ / Biome）は再実装しない。構造データ取得は showdown 経路、 全件名（ja/en）の取り込みは author-static-data の責務で、本 skill は照合専任。 |
| allowed-tools | Bash(gh pr diff:*), Bash(gh pr view:*), Bash(gh pr comment:*), Bash(node scripts/*), Bash(git diff:*), Read, Write |
verify-showdown-pr — showdown 経路の data PR を Serebii で照合する
pokemon-showdown を第一の正（authoritative）にした取得経路（[[data-pipeline]] / ADR 0039）は、
GitHub Actions（showdown-sync.yml）で解禁データ YAML を機械抽出し data:authoritative ラベルの PR を自動作成する。
showdown は Smogon コミュニティの再現データで公式そのものではないため、その PR が公式実態と合うかをマージ前に裏取りする関門が要る。
本 skill は Serebii 速報スクレイパー（ADR 0040）を読み取り専用で流用して PR の差分を照合し、
一致なら承認可・差異なら blocking を PR コメントへ残す手順を定型化する。
取得元の権威序列（showdown=正 > Serebii=速報 > PokeAPI=ja 補完）・データ項目 × 取得元 × SoT の正本は [[data-pipeline]]。
本 SKILL.md は照合手順に専念し、SoT レイアウト・パーサ DOM 契約値・型パターンを二重記述しない（パーサ仕様は
src/codegen/serebii/* のテスト済み純関数が SoT で、本 skill は契約値を持たない）。
なぜこの skill があるか
showdown 経路は構造・解禁・技メタ・メガを単一の機械可読ソースから一括抽出でき網羅性・自動化適性が高い一方、
公式そのものではない（ADR 0039）。誤抽出・mod の取りこぼし・PP 計算ずれ等が混入しうるため、第二の独立ソース
（Serebii・公式更新の反映が早く速報経路へ降格・ADR 0040）で
機械照合して裏取りする。HTML を LLM に丸ごと読ませず Serebii スクレイパーの中間 JSON と exit code で
判定することで、トークン最小・決定論・再現可能に照合する（[[code-review]] の「機械ゲートで捕れない層に専念」と同じ思想で、
ここでの「機械」は Serebii スクレイパー）。
入力 / 出力
- 入力: 照合対象の PR 番号（
data:authoritative ラベルの showdown-sync PR）。対象レギュ id（例 m-a / m-b）は
PR の変更パス（data/champions/<reg>/）から判別する。
- 出力:
- 照合結果の PR コメント（
gh pr comment <N> --body-file）。総括（✅ 一致 / ❌ 差異 N 件）+ 差異を
path:line + 重大度（[[code-review]] フォーマット）で列挙。投稿前に [[redaction]] を適用する。
- exit code 相当の判定: 一致 = 承認可（
0）/ 差異 = blocking（1）。auto-merge ゲート（[[code-review]] の
「CI 緑 + blocking 0」）の blocking 0 条件に接続する。本 skill は判定とコメントまでで、merge は実行しない。
手順
1. PR の変更 YAML を抽出する
gh pr diff <N> で変更ファイルを取り、照合対象のデータセット YAML を抽出する（[[data-pipeline]] の 5 データセット軸に対応）:
data/champions/<reg>/species.yaml（roster）/ species-moves.yaml（per-species 技）/ items.yaml（解禁持ち物）/ mega.yaml（解禁メガ）data/champions/{species,move,item,ability,mega}-specs.yaml（構造・技メタ）data/languages/*.yaml（ja / en）
変更パスから対象レギュ id（<reg>）を確定する。data 以外（src / scripts）の変更が主なら本 skill の対象外で、code-review を案内する。
2. Serebii 中間 JSON を取得する（スクレイパー流用・WebFetch 不使用）
node scripts/scrape-serebii.ts <dataset> <reg>（dataset = species / moves / items / abilities / mega）を
PR の変更データセットぶん実行し、Serebii 中間 JSON を stdout で得る。このスクリプトは取得 → src/codegen/serebii/parse-*
純関数でパース → schema 自己検証までを行い、SoT YAML を書き換えない読み取り専用（書き込みは sync-serebii.ts =
pnpm serebii:* の責務で、照合では使わない）。HTML 本文は読まず stdout の JSON と exit code / stderr の診断だけを見る:
- exit
0 = 健全 / 2 = 取得失敗 / 3 = schema 欠落 / 4 = 件数・健全性違反（ADR 0040）。
- 取得は
data/raw/serebii/（gitignore）へキャッシュされ冪等。moves / abilities は species ステップが書いた
per-reg / specs を対象 id 源にするため、PR ブランチを checkout した作業ツリーで実行する。
scrape-serebii.ts が exit 2/3/4 を返したら Serebii 側の取得失敗で照合不能＝ blocking とせず「照合保留（Serebii 取得失敗）」を
コメントに明記する（showdown PR の否定材料にしない・DOM 揺れは Serebii スクレイパー側で吸収する責務）。
3. 照合する（roster / 技 / 持ち物 / メガ / 技メタ / 名前）
PR の YAML 値と Serebii 中間 JSON を機械的に突き合わせ、差異を列挙する。照合軸:
- roster 総数 / id 集合:
<reg>/species.yaml の解禁種族数・id 集合が Serebii roster と一致するか。
- per-species 技件数:
<reg>/species-moves.yaml の各種族 moves 件数・id 集合が Serebii 種族ページの learnable 技と一致するか。
- 解禁持ち物・メガ membership:
<reg>/items.yaml / <reg>/mega.yaml の id 集合が Serebii items.shtml / 種族ページのメガと一致するか。
- 技メタ:
move-specs.yaml の type / damageClass / power / accuracy / pp / priority。PP は showdown 側が
calculatePP（8/12/16/20）適用済みなので、Serebii の基礎値と直接比較せず換算を踏まえて差異判定する（[[data-pipeline]] の PP 注記）。
- メガ id 正規化: 両経路とも
charizard-mega-x 語順へ収束しているか（Serebii 表示名 Mega Charizard X → kebab・ADR 0040）。
- ja / en:
languages/*.yaml の名前が Serebii 表示名（種族・メガ=カタカナ / 特性・持ち物・技=ひらがな）と整合するか。
ただし languages/mega.yaml の名前は showdown PR には現れない（mega 名は PokeAPI pokemon-form 経路 =
pokeapi-names.yml の別 PR が担う・ADR 0043）。showdown mega PR で照合するのは mega の構造 + membership のみ。
各差異に 重大度（[[code-review]]）を付ける: roster/解禁集合の欠落・余剰や技件数の大きな乖離は blocking、軽微な
名前揺れ・1 件差は non-blocking / nit。差異が 0 なら一致（承認可）。
4. PR コメントへ残す（redaction 適用）
総括（✅ Serebii 照合一致 / ❌ 差異 N 件（blocking M））+ 差異一覧（path:line + 重大度 + 根拠）を /tmp/<prefix>-verify.md に
Write し、投稿前に [[redaction]] を適用してから gh pr comment <N> --body-file <file> で投稿する（[[code-review]] の出力先規約）。
一致でも「✅ 一致」コメントを残す（照合実施の記録）。
Gotchas
- 読み取り専用で照合する: 照合には
node scripts/scrape-serebii.ts（JSON を stdout）を使い、YAML を書き換える
pnpm serebii:*（= sync-serebii.ts）は使わない。作業ツリーを汚さない（汚すと PR diff と混ざる）。
- WebFetch を使わない: 照合は決定論スクレイパー（テスト済み純関数 + 中間 JSON）に宿る。HTML を LLM コンテキストに
載せない（トークン最小・ADR 0040）。DOM 揺れは
src/codegen/serebii/* のパーサ側で吸収し、本 skill は契約値を持たない。
- PP は換算を踏まえて比較: showdown 側は
calculatePP 適用済み（8/12/16/20）。Serebii 基礎値とそのまま比較して
差異と誤判定しない（[[data-pipeline]] の「PP の落とし穴」）。
- Serebii 取得失敗は showdown PR の否定材料にしない:
scrape-serebii.ts の exit 2/3/4 は Serebii 側の問題で
照合保留。showdown PR を blocking にせず保留を明記する（速報経路ゆえ取りこぼしうる・ADR 0040）。
- 判定までが責務・merge しない: auto-merge は [[code-review]] の「CI 緑 + blocking 0」ゲートと
[[implementation-workflow]] の予約で発火する。本 skill はコメント + 判定までで止める。
- 機械ゲート / レビュー観点を再実装しない: 型 / カバレッジ / Biome は
verify / CI、生成データの妥当性は
pokemon-data-reviewer agent、ソース設計レビューは code-review（[[skill-authoring]] / [[code-review]]）。
- cross-agent: 本 skill は npm script +
gh の逐次実行のみで Claude 固有機構（Workflow）を持たない。Codex / 素の CLI
でも gh pr diff → node scripts/scrape-serebii.ts → 照合 → gh pr comment を逐次実行で完結する（[[cross-agent]]）。
関連
- データ取得元・SoT・権威序列の正本: [[data-pipeline]]。
- 決定の「なぜ」: ADR 0039（showdown 第一の正・PokeAPI ja 専任）/
ADR 0040（Serebii 速報降格・スクレイパー刷新）。
- Serebii スクレイパー（照合に流用）:
scripts/scrape-serebii.ts / 純関数 src/codegen/serebii/parse-*。
- showdown 経路（authoritative・照合対象の生成元）:
.github/workflows/showdown-sync.yml / scripts/showdown/* / src/codegen/showdown/*-fields.ts。
- 全件名（ja/en）の取り込み:
author-static-data。
- レビュー基準・出力 / redaction: [[code-review]] / [[redaction]]。
- 生成データ妥当性:
pokemon-data-reviewer agent / 利用者パーティ点検: review-party。
- skill 作成方針・cross-agent: [[skill-authoring]] / [[cross-agent]]。
