# Football Prediction Skill

> 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.

- Skill: `jetqiao/football-prediction-skill` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add jetqiao/football-prediction-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jetqiao/football-prediction-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: jetqiao (https://skillmd.com/u/jetqiao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jetqiao/football-prediction-skill

---


# 竞彩足球智能预测

使用确定性程序完成赛单归一化、事件时间校验、概率模型、价值策略、回测和 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、询问训练或无法晋级：读取 [训练与晋级](references/training.md) 后执行数据体检、回测或训练。
- 用户询问更新 Skill：执行 `football-predict update --check`；需要安装时再执行 `football-predict update`。
- 用户询问小组排名或淘汰赛：读取 [赛事推演](references/tournament.md) 后运行 `tournament`。
- 单场不在竞彩赛单中：按 [数据契约](references/data-contracts.md) 构造输入 JSON，再运行 `daily --input`。

## 命令入口

优先检查已安装命令：

```bash
football-predict doctor
```

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

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

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

## 每日流程

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

```bash
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 级场做深度联网检索，并按 [情报流程](references/intelligence.md) 写入结构化 `facts[]`。不得使用截点后或开赛后的信息。
5. 校验情报：

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

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

```bash
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` 注入独立参考市场。读取 [数据源与降级](references/sources.md) 确认来源和角色。

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

## 回测与模型

先体检数据：

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

生产概率回放：

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

独立价值策略回放：

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

训练 challenger：

```bash
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 绝对路径交付给用户，不要只复述一行指标。

查看模型注册表：

```bash
football-predict models
```

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

每日预测赛后可结算：

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

## 输出规则

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

## 更新

```bash
football-predict update --check
football-predict update
```

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