Philippine Baseball Platform Docs
メニュー

担当AIとスキル

作業は「入口のスキル → 担当エージェント」の形で進みます。agents 同士が直接対話することはなく、spec.md、data/、TEST-REPORT.md といった成果物を介して受け渡します。

最終更新 2026-11-22権限の具体値はこのページに載せません

全体像

入口は2つのオーケストレーションスキルです。配下のスキルとエージェントは、入口から呼ばれます。

  1. データ収集phb-collect-all-baseball-data がフェーズ0〜4を統括する。
  2. アプリ開発phb-app-orchestrator が designer → developer → tester を回す。
  3. ドキュメントphb-docs-writer が docs と README を更新する。
  4. 受け渡し成果物を真実源とし、直接の会話で状態を渡さない。
このページの方針

公開ドキュメントのため、各担当の役割・入出力・成果物までを示します。編集権限の具体的なパスや運用上の内部メモは載せません。

相関図

ノードまたは下のボタンを選ぶと、その担当が読み込む資料、実行するツール、主な入力、成果物が下に表示されます。点線は起動と戻しの向きです。

エージェントの流れ(担当と入口スキルは下のボタン、またはノードのクリックで表示) ユーザー要望 → SKILL / 入口 phb-app-orchestrator 設計 → 実装 → テスト ユーザー要望 → SKILL / 入口 phb-collect-all- baseball-data フェーズ0〜4 アプリ開発 / スキル: app-orchestrator, app-design, app-design-rules, app-develop, app-test, app-pages-deploy 収集 / スキル: collect-all, collect-news, collect-players, collect-game-videos, collect-national-rosters, discover, validate, data AGENT phb-designer spec.md + data 切り出し AGENT phb-developer index.html 実装・修正 AGENT phb-tester 3系統検証 → TEST-REPORT.md spec.md + data index.html FAIL は developer / designer へ戻す AGENT phb-resource-discoverer フェーズ0 resources.txt 最新化 news-collector ニュース横断探索 player-collector UAAP / LBP / 代表選手 roster-collector 代表ロースター video-collector 試合動画探索・4分類 フェーズ1: 4コレクタを並行起動 成果物の契約: data/ 7ファイル → validate → apps/<name>/data/*.json 再生成 → reports/runs 記録 収集の完了報告と stats JSON は、メインのオーケストレーターにだけ返る。 入口のオーケストレーションスキルとエージェントだけを描く。他のスキルはボタンとクリックで表示する。

相関図の使い方

ノードか上のボタンを選ぶと、担当ごとの読み込み資料・ツール・入出力がここに表示されます。

エージェント一覧

エージェント役割主な入力主な成果物
phb-designerアプリの設計。spec とデータ切り出し要望、data/、既存アプリspec.md、apps/*/data/*.json
phb-developer単一HTMLアプリの実装・修正spec.md、生成データ、TEST-REPORTapps/*/index.html
phb-testerspec・データ整合・動作の3系統検証spec.md、data/、index.htmlapps/*/TEST-REPORT.md
phb-resource-discoverer巡回先メディアの発掘・評価対象期間、候補ドメインresources.txt、評価レポート
phb-news-collectorニュースの探索・日本語要約resources.txt、期間baseball-news.csv
phb-player-collectorUAAP・LBP・代表選手の大学歴resources.txt、年・シーズン選手3CSV
phb-roster-collector代表ロースターの抽出resources.txt、年範囲national-team-rosters.csv
phb-video-collector試合動画の探索・4分類resources.txt、期間baseball-game-videos.md
phb-docs-writerdocs と README の作成・更新各ページの生成元、変更点docs/**、README.md

スキル一覧

スキル目的主に使う担当
phb-app-orchestratordesigner → developer → tester の統括メイン
phb-app-designspec とアプリ内データの設計designer
phb-app-design-rulesアプリ共通のデザイン規約designer / developer / tester
phb-app-develop単一HTMLアプリの実装手順developer
phb-app-test3系統の検証手順tester
phb-app-pages-deploydist 組立と Cloudflare Pages 配信developer / tester
phb-collect-all-baseball-data収集フェーズ0〜4の統括メイン
phb-collect-baseball-newsニュース収集と要約news-collector
phb-collect-baseball-players選手情報と大学歴の収集player-collector
phb-collect-national-rosters代表ロースターの収集roster-collector
phb-collect-game-videos試合動画の収集と4分類video-collector
phb-discover-baseball-resources巡回先の発掘・評価・同期resource-discoverer
phb-validate-baseball-dataデータの品質ゲートcollectors / tester
phb-dataデータのスキーマ・注意点の辞書設計・実装・テスト・収集
phb-docsdocs の作成・更新・検証・配信docs-writer
phb-github-actionsGitHub Actions の作成・検証(Node runtime)実装 / 運用

成果物の契約

担当間の受け渡しは、会話ではなく成果物で行います。次のファイルが「真実源」です。

成果物作る担当読む担当意味
apps/<name>/spec.mddesignerdeveloper / tester目的、データ定義、受け入れ基準
apps/<name>/data/*.jsondesignerdeveloper / testerアプリが fetch する生成データ
apps/<name>/index.htmldevelopertester唯一の実装ファイル
apps/<name>/TEST-REPORT.mdtesterorchestrator / developer検証結果と修正依頼先
data/*.csv / *.mdcollectorsvalidate / designer出典つきの一次データ
docs/data/stats.jsoncollect / refresh_docs_stats.pydocs/stats.js公開docsの件数
reports/runs/*オーケストレーター運用者実行サマリーと前回比

権限と禁止事項

  • data/ を編集できるのは収集担当だけです。他の担当は読み取りのみです。
  • developer は spec.md、TEST-REPORT.md、生成済み data/ を編集しません。
  • tester が書くのは TEST-REPORT.md だけです。実装や spec は直しません。
  • docs-writer が書くのは docs/** と README.md だけです。アプリとデータは読み取りのみです。
  • docs/data/stats.json は refresh_docs_stats.py の生成物です。手で編集しません。
  • .env は読まない・コミットしない。秘密情報はドキュメントにも載せません。
  • commit と push は、ユーザーの明示的な指示があるときだけ行います。

スクリプト

スクリプト用途主な実行者
validate.pyUTF-8・必須列・URL・日付・出典ドメインの検証collectors / tester
build-data.pyアプリ用 JSON の生成(冪等)designer / CI
spot_check.py元データとアプリ JSON のスポット照合tester
self_check.py起動・HTTP 200・構文・停止の一括確認developer
assemble_dist.py配布ディレクトリの許可リスト組立と検査deploy / CI
deploy_pages.pyCloudflare Pages の配信と検証deploy
build_og.pyOGP 画像の生成CI / 開発
check_video.py動画の存在・メタデータ取得video-collector
check_docs.pydocs のリンク・アンカー・ナビ・機微情報の検査docs-writer
refresh_docs_stats.py公開docsの件数 JSON の生成collect / docs-writer
check_workflows.pyworkflow の deprecated Node runtime 検査実装 / 運用

ドキュメントの担当

このサイトは phb-docs-writer が phb-docs スキルに従って更新します。アプリ用の designer / developer / tester とは分離しており、アプリやデータには書き込みません。

項目内容
更新できる範囲docs/** と README.md
読み取り専用apps/**、data/**、.opencode/**
自己検証check_docs.py、ローカル表示、Cloudflare Pages の 200 / 404
件数docs/data/stats.json を stats.js が反映。collect 後に refresh_docs_stats.py が更新
公開前チェック秘密情報・個人情報・生ログ・権限の具体値が混ざっていないか