JetQiao/football-prediction-skill

競馬足球智能予測

決定論的スクリプトを使用してデータ正規化、確率モデル、価値計算、バックテスト、HTMLレンダリングを完了します。AIエージェントは、ソース付きの非構造化情報の処理のみを行います。常に自己完結型のHTMLを生成し、返信に完全な試合一覧表を貼り付けないでください。

ワークフローの選択

• ユーザーが特定の日の全競馬試合を分析したい場合：「完全日次フロー」を実行します。
• ユーザーがクイックベースラインのみを必要とする場合、またはネット検索機能がない場合：daily を直接実行し、市場/情報のダウングレードを明示します。
• ユーザーが履歴CSVを提供する場合：backtest を実行します。
• ユーザーがグループ順位やトーナメントについて尋ねる場合：トーナメント推論 を読み、tournament を実行します。
• ユーザーが1試合のみを提供し、それが競馬試合一覧に含まれていない場合：データ契約 に従って入力JSONを構築し、daily --input を実行します。

コマンドエントリポイント

インストール済みのコマンドを優先使用：

football-predict doctor

コマンドが存在しない場合、オープンソースリポジトリのエントリポイントを使用：

npx -y github:JetQiao/football-prediction-skill doctor

以下では football-predict が利用可能なエントリポイントを表します。同じエントリポイントでタスク全体を完了させてください。

完全日次フロー

1. 競馬の販売日を特定します。指定がない場合はユーザーのローカルの今日の日付を使用し、試合開始日と販売日を混同しないでください。
2. 一時作業ディレクトリを作成し、試合一覧を取得します：

football-predict prepare --date YYYY-MM-DD --out /tmp/football-predict-YYYY-MM-DD

3. matches_*.json と intel_queue_*.json を読み取ります。すべてのB級試合についてはモデルベースラインを保持し、キュー内のA級試合に対してのみ深いWeb検索を実行します。
4. 情報フロー に従って検索し、intel.json に書き込みます。試合開始後の記事、試合結果、またはクローズ後にのみ表示されるデータの使用は禁止です。
5. 情報を検証します：

football-predict validate-intel /tmp/football-predict-YYYY-MM-DD/intel.json

6. 最終成果物を生成します：

football-predict daily \
  --date YYYY-MM-DD \
  --input /tmp/football-predict-YYYY-MM-DD/matches_YYYY-MM-DD.json \
  --intel /tmp/football-predict-YYYY-MM-DD/intel.json

7. 返信では、HTMLの絶対パス、試合数、高信頼数、価値シグナル数、および重要なダウングレード警告のみを提供します。確率は約束ではないこと、そして「安定して儲かる」という表現は避けることを注意喚起します。

市場と特徴量の拡張

--features features.json を使用して試合前のElo/xGを注入し、--market market.json を使用して同一予測時点のシャープ/市場オッズを注入します。データソースとダウングレード を読み、ソースの優先順位を確認します。

過去のクローズオッズをそれより前の時点の予測に注入することは決して行わないでください。リアルタイム市場がない場合はダウングレードを許可しますが、レポートに警告を残す必要があります。

バックテスト

football-data.co.uk からユーザーが権利を持つリーグCSVを取得し、ローカルで実行します：

football-predict backtest history.csv --min-train 120 --window 600

Brierスコア、対数損失、および競馬SPベースラインを比較します。同時にサンプルサイズ、ROI、最大ドローダウンを報告します。良好なパフォーマンスを示すリーグや期間だけを選択しないでください。

出力ルール

• prediction_*.json、report_*.html、manifest_*.json を保持します。
• HTMLを主要な成果物とします。オフラインで開くことができ、ネットワークリクエストを送信しないものでなければなりません。
• 情報源、生成時間、実行ID、欠落情報、ダウングレード理由を保持します。
• 賭けの実行、代理操作、収益の約束は行いません。賢明な購入と未成年者による購入禁止を明確に注意喚起します。