worldcup-2026-predictor

• data/results.json
• references/divination.md
• references/hexagrams.json
• references/html_report.md
• references/intelligence.md
• references/model.md
• references/output_format.md
• references/teams.json
• scripts/divination.py
• scripts/predict.py

SKILL.md

---
name: worldcup-2026-predictor
description: Predict and simulate 2026 FIFA World Cup (USA/Canada/Mexico) matches, groups, champion odds, and knockout brackets after the AI Agent collects and saves current data and pre-match intelligence snapshots, then present the result as a local HTML report. Use when the user asks to predict "X vs Y", scorelines, group advancement, "谁会赢/谁会夺冠", tournament simulations, bracket paths, football randomness/upset scenarios, HTML prediction reports, or for-entertainment 算卦/玄学 predictions. Supports Agent-supplied live data, Agent-supplied team news/intelligence, Agent-supplied divination context, editable team ratings, stage-aware real-result locking, best-third-place advancement, built-in upset variance, local HTML report generation, and optional I Ching/Five Elements/zodiac/numerology output.
---

# 2026 世界杯预测 ⚽🔮

对 2026 美加墨世界杯做离线概率预测：单场比分、小组晋级、夺冠概率、淘汰赛路径。
默认使用**理性模型**（Elo → 波动修正泊松比分 → 蒙特卡洛）；用户明确要求时才叠加**玄学趣味模式**。

本 skill 非 FIFA 官方项目，不与 FIFA 存在隶属、认可或赞助关系。输出只用于概率分析和娱乐，不构成官方赛程、赛果或确定性判断。

## 使用脚本

从当前 skill 根目录运行脚本，不要假设固定安装路径。下例用 `$SKILL_DIR` 表示 `worldcup-2026-predictor` 目录：

### 理性预测（默认）
```bash
python3 "$SKILL_DIR/scripts/predict.py" match 阿根廷 巴西 --seed 7
python3 "$SKILL_DIR/scripts/predict.py" match 阿根廷 巴西 --knockout --seed 7
python3 "$SKILL_DIR/scripts/predict.py" group C --sims 5000
python3 "$SKILL_DIR/scripts/predict.py" champion --sims 10000 --seed 7
python3 "$SKILL_DIR/scripts/predict.py" route 阿根廷 --sims 5000 --seed 7
python3 "$SKILL_DIR/scripts/predict.py" bracket --seed 7
python3 "$SKILL_DIR/scripts/predict.py" match 阿根廷 巴西 --json
```

- 球队名支持代码（`ARG`）、英文（`Argentina`）或中文（`阿根廷`）。
- 如果是小组赛/联赛/积分赛，保留胜/平/负三种结果并预测比分；如果是淘汰赛，使用 `--knockout`，输出晋级倾向、常规时间比分和点球决胜路径。
- `group` 输出晋级 32 强概率，已纳入 8 个最佳第三名。
- `route` 输出某队完整晋级路线概率、每轮到达概率和常见潜在对手。
- `champion`/`group` 可调 `--sims`；`--seed` 用于复现；单场加 `--neutral` 可去掉东道主加成。
- 所有理性命令支持 `--json`，用于让 Agent 稳定生成 HTML 报告，不需要解析中文文本。
- 足球偶然性已默认进入模型：泊松比分抽样 + 单场状态冲击 + 胜平负概率收缩，不需要额外参数。
- `bracket` 输出一次抽样的每轮淘汰赛路径，当前使用简化蛇形种子对阵，非 FIFA 官方槽位映射。
- 预测脚本不联网抓数据；若存在 `data/live/teams.json`、`data/live/results.json` 或 `data/live/intelligence.json`，会优先读取这些由 Agent 保存的快照。

### 玄学模式（需用户主动开启）
```bash
python3 "$SKILL_DIR/scripts/divination.py" 阿根廷 巴西
python3 "$SKILL_DIR/scripts/divination.py" 阿根廷 巴西 --factor
python3 "$SKILL_DIR/scripts/divination.py" 阿根廷 巴西 --json
```
三种玩法（按用户意图选）：**纯玄学** / **科学+玄学并列** / **玄学加权**（把 `--factor` 叠加到泊松胜率，得"开过光的概率"）。详见 `references/divination.md`。
玄学脚本可读取 `data/live/divination_context.json` 中由 Agent 保存的起卦背景，例如比赛时间、地点、问题、颜色象意和资料来源；这些资料只用于确定起卦语境，不证明玄学可靠。

## 工作流程
1. 判定用户要单场、小组、夺冠榜、淘汰赛路径，或是否明确要求玄学。
2. 理性预测前由 Agent 主动查找官方或可靠来源，收集当前小组、赛程、已完赛比分、可用评级和比赛阶段；不要把数据源硬编码进脚本。如果用户只给出“谁 vs 谁”，先搜索确认这是小组/积分赛、淘汰赛、友谊赛还是其他赛制，再选择命令。若搜索后仍无法确认赛制，必须先问用户。
3. 将理性基础数据保存为本地快照：`data/live/teams.json` 使用 `references/teams.json` 的结构，必须包含完整 48 队、A-L 12 组且每组 4 队；`data/live/results.json` 使用 `data/results.json` 的结构，并在 `_meta` 记录来源 URL、采集时间和说明。
4. 如果是当前理性单场预测，继续从多个方面收集两队赛前情报：伤停/停赛、预计首发、近期状态、赛程体能、场地天气、战术对位、比赛动机、赔率或评级变化。按 `references/intelligence.md` 保存 `data/live/intelligence.json`，并保留来源、采集时间、置信度、冲突说明和赛制/阶段。
5. 调用脚本，脚本会优先读取 `data/live/` 快照；若没有 live 快照，则回退到样例数据。`intelligence.json` 是可选快照：团队级 `elo_delta` 会影响所有理性模拟，指定对阵的 `goal_delta` 当前只影响 `match A B` 单场命令。
6. 如果用户明确要求玄学，Agent 可以收集比赛日期、开球时间、举办城市、场地、双方颜色/象征和用户问题，按 `references/divination.md` 保存 `data/live/divination_context.json`；不要把伤停、阵容、赔率等理性情报当作玄学可靠性的证据。
7. 保留脚本的中文概率表格和“预测原因”说明，或优先使用 `--json` 的结构化结果生成 HTML；单场预测要概括关键情报依据和不确定点。如果用户强调足球偶然性，说明模型默认已考虑冷门路径。
8. 按 `references/html_report.md` 由 Agent 直接生成自包含 HTML 报告，保存到 `reports/`，并自动用默认浏览器打开；不要调用额外 HTML 生成脚本。HTML 必须显示“为什么这样预测”的原因区。若包含玄学预测，还必须清楚展示本卦、变卦、变爻、五行/生肖/命理依据、气运因子和断语原因。
9. 涉及整届模拟时优先用 `--sims 10000`；需要快速反馈可降到 `2000`；需要复现时加 `--seed`。

## 重要约束
- 不得暗示这是 FIFA 官方工具；不要使用 FIFA 官方 logo、赛事视觉、字体或其他受保护品牌资产。
- 只说**概率**，不说"必胜/一定"；区分"理性"与"玄学"两类来源。
- 所有最终结果都要提醒用户：预测结果仅供参考，请理性观赛。
- 单场输出必须突出概率最高的赛果方向作为主预测结果；其他比分可以展示概率，但只能作为比分分布参考，不得同时包装成另一套主预测。
- 积分赛/小组赛允许胜、平、负三种结果；淘汰赛最终只有晋级方，若常规时间平局倾向最高，需要额外给出加时/点球决胜说明和点球比分预测。
- 预测出线时要给出小组排名、晋级概率、前二概率、小组第一概率和最佳第三路径；预测晋级路线时要给出完整可能路径、每轮概率和关键风险。
- 明确足球单场随机性很高；强队高概率不等于稳胜，低概率队也有冷门路径。
- `references/teams.json` 是可编辑离线样例快照；如果用户要求当前预测，先写入 `data/live/` 快照，不要把旧样例数据包装成实时预测。
- 参赛队伍必须完整：48 队、12 组、每组 4 队。脚本会校验此条件，不得用残缺快照继续预测。
- 赛前情报是 Agent 采集后的有界修正，不是确定性结论；来源不足或相互冲突时，要降低置信度并说明不确定性。
- 如果无法获得足够新的赛前情报，要明确说明数据不足，只能基于已有快照或样例做离线演示，不得伪装成当前实时分析。
- 玄学起卦背景只用于娱乐语境和日期/方位/象意输入，不得包装成真实可信的预测依据；与理性情报并列时必须分区展示。
- HTML 报告是最终展示形态：首屏必须构建球场场景，用真实球场/转播比分牌风格展示预测比分，并提供详细概率、情报、战术、场景推演和来源说明。报告应自包含、响应式、可扫描，并明确概率不是确定性结论。不得使用 FIFA 官方 logo、赛事视觉、字体或其他受保护品牌资产。
- 玄学 HTML 不能只给一句结论；必须解释卦象如何得出、各玄学维度如何影响判断，并与理性预测分区展示。
- `data/live/results.json` 与 `data/results.json` 都会按阶段锁定真实比分；同两队在不同阶段再次交手时，不会复用旧阶段比分。
- 玄学不得包装成理性模型、实时情报或可信因果依据。

## 参考文档（按需阅读）
- `references/model.md` — 理性模型数学原理与已知简化
- `references/intelligence.md` — 赛前情报采集维度、JSON 快照格式与修正规则
- `references/divination.md` — 玄学四术算法与三种呈现/加权方式
- `references/output_format.md` — 输出规范与调用速查
- `references/html_report.md` — HTML 报告内容结构、视觉要求与自动打开规则
- `references/teams.json` — 48队评级/分组/颜色（可编辑）
- `data/results.json` — 真实赛果（滚动追加）