subroh0508

Plan / Epic 確定後の実装着手 → Lint/Test → AI Review → マージ → レトロ起動 → worktree クリーンアップを 10 フェーズ (Phase 0-9) で統合管理するオーケストレーター。 Phase 0 で git worktree を作成し、Phase 9 で削除することで複数 Claude Code セッションの 並行実装を物理分離する。`feature-request` / `bug-fix` / `refactor` / `dependency-upgrade` が起票した Plan / Epic 確定後の実装着手指示を受けたとき、または orchestrator skill が per-task pane に Phase 0-9 自走を委譲したときに本 Skill に従って動作する。

ローカル Claude Code 内でポーリング起動し、gh CLI で merged/closed PR を取得 → 未処理 PR があれば pr-retrospective を起動、Renovate ラベル PR があれば dependency-upgrade を起動するハーネスループ起点 Skill。3 系統の起動経路 (起動時 + CronCreate + ScheduleWakeup) に対応するため .claude/locks/pr-poller.lock で排他制御し、 pending-fetch 項目の再走査と harness-meta 自動起動の閾値判定も担当する。

アーキテクチャ決定の ADR 起票を担当する Skill。起票基準判定 + 採番 + テンプレ起草 + 関連 ADR 双方向リンク + INDEX 更新を実施。起票基準を満たさない決定は rules / epic decisions.md / learning への記録を推奨し、本 Skill は起草で完了する。 議論 / approve / merge は人間レビューに委ねる (Skill は merge を実行しない)。

外部研究 / ベストプラクティス駆動の改善ループを担う Skill。手動起動のみで cron 不採用 (ADR 0026)。 WebSearch / WebFetch + Context7 MCP でホワイトリスト外部情報源を取得し、既存ハーネス (`.claude/skills/` / `.claude/rules/` / `docs/`) と gap 分析を行い、 `docs/harness/evolution-proposals/YYYY-MM-DD.md` を出力する。重要案は `example-skills:skill-creator` 経由で Skill scaffold / Plan / EPIC 起票し、人間 approve を必須とする。

pr-retrospective が生成した learning ファイル群の「🤖 ハーネス改善提案」セクションを 入力に、harness-meta-criteria の採用 / 見送り / 撤去 3 分岐で判定し、採用は改修 PR (rule / Skill / ADR 起票) 起票、見送りは元 learning に「📝 harness-meta フィードバック」 追記、撤去は status removed → 物理削除の 2 段階 PR で実行する内部 KPT 駆動 Skill。 dry-run 必須条件該当時は dry-run 先行。

[archived A3-14 / 2026-05-18] Phase A の A1〜A10 を進める汎用 Skill。専用 Skill 群が A3 で出揃ったため archived 化。新規呼び出し禁止。本ファイルは履歴参照用。

対象 PR の diff / comments / reviews / CI ログ / Skill 実行ログ / 三層指標差分 / 関連 Plan・Epic を収集し、docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を日本語の構造化フォーマットで生成する。 harness/learnings-batch-YYYY-WW ブランチに集約し、週次 (or 件数到達時) に PR として起票する。

plan.md と docs/epics/EPIC-NNN-*/ を入力に docs/harness/roadmap.md (全体) と docs/epics/<id>/roadmap.md (Epic 別) を生成・更新する。進捗・完了根拠・Open Questions・ 障壁・着手順変更履歴を一元管理し、並行実装容易性に基づく「次の推奨着手 (top-N)」を出力する。 plan.md / Epic 本体への逆同期はしない (片方向ミラー、R-34)。Plan は 1 PR 完結のため対象外。 epic-author の Epic 起票直後、implementation-workflow Phase 8 (Merge 直後)、 pr-poller の pending-fetch 再走査、または「ロードマップ更新」「次の推奨着手を出して」 「障壁記録」「保留事項追加」等の手動指示で起動される。

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` に委譲し機械ゲートは再実装しない。

指定レギュレーション <reg> の解禁データ（roster / 技 / 持ち物 / メガ）を pokemon-showdown 経路から取得して 全量投入する per-reg オーケストレーション skill。「レギュレーション <reg> の解禁データを取得して」 「M-A / M-B を全量投入して」「per-reg 解禁データを埋めて」「author-regulation-data <reg>」「data/ を削除した 状態から reg を復元して」「showdown-sync を回して解禁データを入れて」と言われたとき、または reg 単位の解禁 データを完全削除・部分欠損・完成済みのいずれからでも冪等に収束させたいときに使う。前提ゲート （author-static-data の全件名辞書 + rules.yaml / type-specs.yaml 存在）→ per-reg reset → showdown-sync.yml dispatch → verify-showdown-pr 照合 → check:regulation → generate:data → pokemon-data-reviewer 依頼 → per-reg 静的著述（index.yaml の period + languages/regulations.yaml エントリ）を既存経路へ委譲してオーケストレーション する。取得実体・機械ゲートは再実装しない。新規 id の名前欠落は author-static-data へ委譲し、reg 非依存の全件名 辞書そのものは author-static-data の責務。

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 は照合専任。

`src/**`・`scripts/**` 等のライブラリ本体・データパイプラインを変更した PR / diff を、マージ前に 意味的レビューする。「コードをレビューして」「この PR を見て」「diff をレビュー」「マージ前に確認して」 「src の変更をレビュー」と言われたとき、または PR open 後にソース変更が含まれるときに使う。Google 12 観点 + AI 生成コード固有観点 + pokeform 規約で指摘する。機械ゲート（型 / カバレッジ / Biome）は再実行しない。 `.claude/rules`・`.claude/skills`・`AGENTS.md`・`CLAUDE.md`・`.githooks`・`docs/` 等のハーネス資産の 変更は `harness-review` を使う（こちらは src/scripts 専用）。

`.claude/rules`・`.claude/skills`・`.agents/skills`・`AGENTS.md`・`CLAUDE.md`・`.githooks`・ `.claude/settings.json`・`docs/roadmap`・`docs/adr`・`docs/harness` 等のハーネス資産（エージェント指示）を 変更した PR をマージ前にレビューする。「ハーネスの変更をレビューして」「rule / skill を見て」「AGENTS.md を レビュー」「この skill の trigger は妥当?」と言われたとき、または PR open 後にハーネス資産の変更が含まれる ときに使う。description trigger 精度 / クロスエージェント整合 / SoT 一貫性 / paths スコープ / redaction / ゲート二重化を指摘する。`src/**`・`scripts/**` のソース変更は `code-review` を使う（こちらはハーネス専用）。

育成済み個体の YAML を雛形から起こし、`check:individual`（覚えない技 / 使えない特性 / 性格 up=down / ポイント 66・各32）で tsc 検証して仕上げる手順 skill。「個体を作りたい」「ポケモンの育成データを書いて」 「この個体 YAML を検証して」「author-individual <species>」「team/individuals に個体を追加して」 「覚えない技が無いか確認して」と言われたとき、または個体ファイルを新規作成 / 修正してブラッシュアップ したいときに使う。対象レギュレーションを `regulations: [<id>...]` で宣言し、種族に応じて特性・技・持ち物を per-reg 種族 dex の許容値に絞り、合計66 を満たす雛形を提示してから `check:individual` で弾く。パーティ全体の 整合・弱点点検は `review-party` を使う。

指定したフェーズの phase doc を読み、依存・必要な rule / skill・受け入れ基準を整理して着手準備を整える（準備のみで実装はしない）。 「フェーズ N に着手する」「Phase N を始めたい」「次のフェーズの準備をして」「start-phase N」 「このフェーズの前提と受け入れ基準を教えて」と言われたとき、新しい実装単位に取りかかる最初に使う。 worktree 作成〜実装〜検証〜PR〜マージ〜レトロまで端から端まで駆動したいときは implementation-workflow を使う （本 skill はそのワークフローの着手準備ステップに相当する単発用途で、駆動は implementation-workflow の責務）。 実装の入口を定型化し、依存漏れ・受け入れ基準の見落としを防ぐ。

新しい ADR（アーキテクチャ決定記録）を docs/adr/ に採番して作成する。技術選定・パターン採用・不可逆なトレードオフを伴う決定をしたとき、あるいは既存 ADR を覆す（supersede する）ときに使う。ユーザーが「ADR を書きたい / 残したい」「この決定を記録して」「○○の ADR を起こして」と言ったり、明示せずともアーキ決定を確定させた文脈で必ず使う。

Dependabot PRの影響調査を完全自動化する。npm（sass / @marp-team/marp-cli / vitepress 他）と github-actions の両方のエコシステムで、リリースノート要約・該当コードの特定・ローカル検証（CSSビルドdiff、Marpレンダリング、docs:build）・PRへの構造化コメント投稿・無影響時の自動Approveまでを一気通貫で実行する。「dependabot」「依存関係更新」「PR影響調査」「マイナー/メジャー更新の影響を確認して」「このdependabot通していい？」と言われたら必ず使う。マージは絶対に行わない。

Release Command

Detect modified SCSS files and update corresponding documentation (demo, CLAUDE.md, README)

Detect newly added SCSS files and create/update corresponding documentation (demo, CLAUDE.md, README)