football-prediction-skill

name

football-prediction-skill

description

Generate explainable China Sports Lottery football predictions with event-time snapshots, T-24h/T-6h/T-90m/closing model horizons, separate directional and value states, strict reference/target market isolation, sourced pre-match intelligence, hierarchical Dixon-Coles probabilities, multi-window model validation, rolling backtests, tournament simulations, and self-contained dark HTML reports. Use for 竞彩足球、足球预测、竞彩赛单、胜平负概率、让球分析、比分预测、赔率价值、串关研究、赛前情报、足球回测、模型训练、训练无法晋级、football-data CSV、模型更新、小组排名、淘汰赛对阵、football prediction or Sporttery analysis.

竞彩足球智能预测

使用确定性程序完成赛单归一化、事件时间校验、概率模型、价值策略、回测和 HTML 渲染。智能体只负责查找并抽取有来源的赛前事实。始终把自包含 HTML 作为主要交付物。

核心约束

• 固定预测截点 as_of；只允许 observed_at <= as_of < kickoff_at 的数据进入模型。
• 预测必须归属 t24h / t6h / t90m / closing；只有同时点模型可复用市场融合与校准。
• 明确区分 reference_market、target_market 和 benchmark_market。
• 不得用目标竞彩价格生成概率后，再用同一价格证明存在价值。
• 方向判断与价格价值必须分开输出；有有效概率时输出 strong / moderate / slight，只有中性占位先验才输出 unavailable。
• 只有独立概率、校准状态和价格优势都通过门槛时，才输出 candidate。
• 缺少独立概率或目标价格参与概率形成时，价值输出 unverified，不得因此隐藏方向。
• 正向价格差尚未过门槛时输出 watch，没有正向优势时输出 no_edge，目标价格缺失时输出 unavailable。
• 不执行下注，不承诺命中率或盈利，不使用“稳、必选、稳赚”等措辞。

选择工作流

• 分析某日竞彩：执行“每日流程”。
• 用户提供历史 CSV、询问训练或无法晋级：读取 训练与晋级 后执行数据体检、回测或训练。
• 用户询问更新 Skill：执行 football-predict update --check；需要安装时再执行 football-predict update。
• 用户询问小组排名或淘汰赛：读取 赛事推演 后运行 tournament。
• 单场不在竞彩赛单中：按 数据契约 构造输入 JSON，再运行 daily --input。

命令入口

优先检查已安装命令：

football-predict doctor

命令不存在时使用仓库入口：

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

下文统一以 football-predict 表示当前可用入口。

每日流程

1. 确定竞彩销售日期和预测截点。未指定时使用用户本地当前时间；历史日期必须使用明确赛前截点或让 CLI 选择最早开赛前 90 分钟。
2. 获取赛单并写入不可变快照：

football-predict sync \
  --date YYYY-MM-DD \
  --as-of "YYYY-MM-DDTHH:MM:SS+08:00" \
  --out /tmp/football-predict-YYYY-MM-DD

3. 核对源场次数与解析场次数。HAD 未开售、仅 HHAD 在售或玩法暂未开放的比赛也必须保留。
4. 读取 intel_queue_*.json。只对 A 级场做深度联网检索，并按 情报流程 写入结构化 facts[]。不得使用截点后或开赛后的信息。
5. 校验情报：

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

6. 使用相同 as_of 生成报告：

football-predict daily \
  --date YYYY-MM-DD \
  --as-of "YYYY-MM-DDTHH:MM:SS+08:00" \
  --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 注入独立参考市场。读取 数据源与降级 确认来源和角色。

• 官方竞彩 HAD/HHAD/SP 默认是 target_market。
• 用户传入或 The Odds API 的独立市场默认是 reference_market。
• football-data 历史赔率默认是 benchmark_market。
• 只有竞彩自身多玩法时，可以展示“目标市场共识”方向，但价值必须标记为 unverified，并禁止独立价值候选。

回测与模型

先体检数据：

football-predict inspect-data season-1.csv season-2.csv season-3.csv

生产概率回放：

football-predict backtest season-1.csv season-2.csv season-3.csv \
  --pipeline production --no-open

独立价值策略回放：

football-predict backtest history.csv --pipeline independent-value --no-open

训练 challenger：

football-predict train season-1.csv season-2.csv season-3.csv \
  --competition 英超 \
  --alias "Premier League" \
  --no-open

训练产物包含模型、dataset_profile.json 和 training_report.html。优先把 HTML 绝对路径交付给用户，不要只复述一行指标。

查看模型注册表：

football-predict models

只有多窗口样本外样本量、市场覆盖、Brier、Log-loss、RPS、ECE 和稳定性门槛全部通过的模型才能使用 --promote 晋级。未通过时保留为 challenger，不得因为单段 ROI 漂亮而强行作为生产结论。football-data 历史赔率只能验证 closing；非收盘时点缺少同截点基线时不得晋级。

每日预测赛后可结算：

football-predict evaluate-daily prediction_YYYY-MM-DD.json results.json

输出规则

• 保留 prediction_*.json、report_*.html、manifest_*.json 和快照 ID。
• HTML 必须单文件、离线可用且不发网络请求。
• 报告保留 as_of、来源、模型版本、训练截止、校准状态、数据缺失、方向依据和价值状态原因。
• 不在回复中粘贴完整赛单表；HTML 是主要交付物。

更新

football-predict update --check
football-predict update

更新后告诉用户新建一个 Codex/Claude Code 任务加载新版 Skill，不要求先卸载或手工重装。