全体像
入口は2つのオーケストレーションスキルです。配下のスキルとエージェントは、入口から呼ばれます。
- データ収集
phb-collect-all-baseball-dataがフェーズ0〜4を統括する。 - アプリ開発
phb-app-orchestratorが designer → developer → tester を回す。 - ドキュメント
phb-docs-writerが docs と README を更新する。 - 受け渡し成果物を真実源とし、直接の会話で状態を渡さない。
このページの方針
公開ドキュメントのため、各担当の役割・入出力・成果物までを示します。編集権限の具体的なパスや運用上の内部メモは載せません。
実行環境
このリポジトリのエージェントは OpenCode 上で動きます。モデルは OpenCode Go の deepseek-v4.1-flash-1017 です。
| 項目 | 値 |
|---|---|
| ハーネス | OpenCode |
| プロバイダ | OpenCode Go(opencode-go) |
| モデル | deepseek-v4.1-flash-1017 |
| 設定 | opencode.json の model(opencode-go/deepseek-v4.1-flash) |
| エージェント定義 | .opencode/agents/phb-*.md |
| スキル | .opencode/skills/phb-*/SKILL.md |
各エージェントは個別のモデル指定を持たず、ハーネスの設定モデルで動きます。モデルを変える場合は opencode.json を更新します。エージェントの役割は下の「エージェント一覧」を参照してください。
相関図
ノードまたは下のボタンを選ぶと、その担当が読み込む資料、実行するツール、主な入力、成果物が下に表示されます。点線は起動と戻しの向きです。
相関図の使い方
ノードか上のボタンを選ぶと、担当ごとの読み込み資料・ツール・入出力がここに表示されます。
エージェント一覧
| エージェント | 役割 | 主な入力 | 主な成果物 |
|---|---|---|---|
phb-designer | アプリの設計。spec とデータ切り出し | 要望、data/、既存アプリ | spec.md、apps/*/data/*.json |
phb-developer | 単一HTMLアプリの実装・修正 | spec.md、生成データ、TEST-REPORT | apps/*/index.html |
phb-tester | spec・データ整合・動作の3系統検証 | spec.md、data/、index.html | apps/*/TEST-REPORT.md |
phb-resource-discoverer | 巡回先メディアの発掘・評価 | 対象期間、候補ドメイン | resources.txt、評価レポート |
phb-news-collector | ニュースの探索・日本語要約 | resources.txt、期間 | baseball-news.csv |
phb-player-collector | UAAP・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-writer | docs と README の作成・更新 | 各ページの生成元、変更点 | docs/**、README.md |
スキル一覧
| スキル | 目的 | 主に使う担当 |
|---|---|---|
phb-app-orchestrator | designer → developer → tester の統括 | メイン |
phb-app-design | spec とアプリ内データの設計 | designer |
phb-app-design-rules | アプリ共通のデザイン規約 | designer / developer / tester |
phb-app-develop | 単一HTMLアプリの実装手順 | developer |
phb-app-test | 3系統の検証手順 | tester |
phb-app-pages-deploy | dist 組立と 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 | Clef-flash + 5ルールで巡回先を評価・同期 | resource-discoverer |
phb-validate-baseball-data | データの品質ゲート | collectors / tester |
phb-data | データのスキーマ・注意点の辞書 | 設計・実装・テスト・収集 |
phb-docs | docs の作成・更新・検証・配信 | docs-writer |
phb-github-actions | GitHub Actions の作成・検証(Node runtime) | 実装 / 運用 |
成果物の契約
担当間の受け渡しは、会話ではなく成果物で行います。次のファイルが「真実源」です。
| 成果物 | 作る担当 | 読む担当 | 意味 |
|---|---|---|---|
apps/<name>/spec.md | designer | developer / tester | 目的、データ定義、受け入れ基準 |
apps/<name>/data/*.json | designer | developer / tester | アプリが fetch する生成データ |
apps/<name>/index.html | developer | tester | 唯一の実装ファイル |
apps/<name>/TEST-REPORT.md | tester | orchestrator / developer | 検証結果と修正依頼先 |
data/*.csv / *.md | collectors | validate / designer | 出典つきの一次データ |
docs/data/stats.json | collect / refresh_docs_stats.py | docs/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.py | UTF-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.py | Cloudflare Pages の配信と検証 | deploy |
build_og.py | OGP 画像の生成 | CI / 開発 |
check_video.py | 動画の存在・メタデータ取得 | video-collector |
check_docs.py | docs のリンク・アンカー・ナビ・機微情報の検査 | docs-writer |
refresh_docs_stats.py | 公開docsの件数 JSON の生成 | collect / docs-writer |
check_workflows.py | workflow の 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 が更新 |
| 公開前チェック | 秘密情報・個人情報・生ログ・権限の具体値が混ざっていないか |