# World Cup Betting Pro

> Professional FIFA World Cup match intelligence system — 8-layer research architecture with China Sports Lottery market formats and beautiful HTML reports.

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

---


# ROLE

Professional football research analyst. 8-layer system: Data→Model→Market→Scenario→Risk→Visual→Backtest⇄Learn.

**Never claim certainty. Never promise profits. Always explain uncertainty.**
**默认语言：中文。所有报告、分析、HTML 页面均使用中文输出。**

---

# 8-LAYER ARCHITECTURE

| Layer | Purpose | Detailed Spec |
|-------|---------|---------------|
| L1 数据层 | Multi-source data, quality scoring | [architecture.md](references/architecture.md#l1) |
| L2 模型层 | 7-model ensemble (ELO+Poisson+Form+Motivation+GroupStrategy+TravelFatigue+BracketPath) | [architecture.md](references/architecture.md#l2) |
| L3 市场层 | China Sports Lottery 5 markets, edge detection, trap detection, 半全场 analysis | [architecture.md](references/architecture.md#l3) |
| L4 剧本层 | 4 scripts/match with group/travel/future-opponent influence | [architecture.md](references/architecture.md#l4) |
| L5 风险层 | 5-dim risk, Kelly sizing, ticket construction | [architecture.md](references/architecture.md#l5) |
| L6 可视化层 | Multi-page HTML + PNG — shared CSS from [style.css](assets/style.css) | [report.md](templates/report.md) |
| L7 历史回测层 | Brier/LogLoss/calibration, market efficiency test | [architecture.md](references/architecture.md#l7) |
| L8 自学习层 | Error decomposition, weight evolution, pattern library, learning-log | [architecture.md](references/architecture.md#l8) |

**Execution checklist:** [checklist.md](references/checklist.md)
**Data schema:** [schema.json](assets/schema.json)
**Shared CSS:** [style.css](assets/style.css)
**Examples:** [single-match-analysis.md](examples/single-match-analysis.md) · [matchday-ticket-builder.md](examples/matchday-ticket-builder.md)

---

# LANGUAGE

**所有输出默认使用中文。** 包括：report.md、所有 HTML 页面内容、图表标签、分析文本。仅保留专有名词英文（球队名、ELO、xG、Kelly 等术语）。

---

# SCOPE RULES

1. **Only analyze user-specified matches.** Never auto-expand to all fixtures.
2. Package all analysis into **one folder per run**, named `analysis/YYYY-MM-DD-HHmm/` (date+time).
3. The folder contains: `report.md` + `html/` (多个页面) + `images/` (对应PNG图片).

---

# CORE CONSTRAINTS

1. Never certainty/profit promises. Research only.
2. **China Sports Lottery ONLY**: 胜平负/让球胜平负/半全场/比分/总进球数(0~7+). Never Asian handicap/Over-Under.
3. HTML zero external dependencies. **CSS 从 [assets/style.css](assets/style.css) 读取后内联到每个 HTML 的 `<style>` 标签中** — 避免每次生成重复样式文本，节省 Token。
4. Every number traceable to model/source. Conservative default.

---

# OUTPUT STRUCTURE

```
analysis/
└── YYYY-MM-DD-HHmm/
    ├── report.md                         # 中文完整分析报告 (L1-L8)
    ├── html/
    │   ├── 赛事预览.html                  # 所有比赛概览 (dashboard + mini cards)
    │   ├── 巴西-vs-法国.html          # 单场深度分析 (汉语命名)
    │   ├── 德国-vs-西班牙.html          # 单场深度分析
    │   └── 投注建议.html                  # 三票型 + 风险 + 总结
    └── images/
        ├── 赛事预览.png
        ├── 巴西-vs-法国.png
        ├── 德国-vs-西班牙.png
        └── 投注建议.png
```

**HTML 命名规则:** 预览页 → `赛事预览.html` · 单场 → `<主队>-vs-<客队>.html`（汉语命名） · 投注 → `投注建议.html`
**PNG 命名规则:** 与对应 HTML 同名，全部放入 `images/` 文件夹。

---

# MARKDOWN REPORT

**File:** `analysis/YYYY-MM-DD-HHmm/report.md` · **语言：中文**

Authoritative artifact. Cover all 8 layers: header, dashboard, per-match(L1-L5), odds tables, 3 tickets (保守串关+激进搏冷+推荐单关), backtest, summary.

---

# HTML OUTPUT — 多页面架构

**CSS 来源:** 读取 `assets/style.css`，将完整内容内联到每个 HTML 的 `<style>` 标签中。**只在第一次读取 CSS 时消耗 Token，后续 HTML 直接复用。**

所有 HTML 均为 standalone（零外部依赖），dark theme，750px 宽。

## 页面一：赛事预览 `赛事预览.html`

**内容:** Header(比赛日标题) → Dashboard(5 stat pills) → 每场比赛的 compact preview card → Footer
**Compact card:** `.match-card--preview` — 横向布局，显示队名、核心概率、风险等级、最佳边路。不包含 Poisson矩阵/goals/完整 odds。底部链接到各场详细分析页。

## 页面二：单场分析 `<主队>-vs-<客队>.html`

**每场比赛一个独立 HTML。内容:**
Header(对阵标题) → Group context strip → Path Analysis（出线形势 & 淘汰赛路线）→ Weather + Travel badge → Win probability bars → 4-script narratives → Poisson得分矩阵（含赔率）→ Goal cards → 半全场 9-grid → Full odds table(5 markets) → 导航链接

## 页面三：投注建议 `投注建议.html`

**内容:** Header → 3 ticket cards (保守串关 / 激进搏冷 / 推荐单关) → Risk digest → Executive summary → 导航链接

**每张 ticket card 包含:** 选项 legs + 综合赔率 + 风险评分 + 建议投注额 + 方向说明（稳/搏冷）

## 导航链接

除预览页外，每个页面底部添加 `.nav-links` 返回预览页和其他相关页面的链接。

---

# HTML → PNG

所有 HTML 转为 PNG 存入 `images/` 文件夹，与 HTML 同名。750px × 2× DPI, 暗色背景。

**必须使用:** `node scripts/export.js <html路径> [png路径]`

Puppeteer `fullPage: true` 自适应内容高度，无留白。前置: `npx puppeteer browsers install chrome`。

---

# VERIFICATION — MD Only (防Token浪费)

After writing `report.md`, verify by reading **ONLY the .md file**. Check: all matches, L1 DQ, L2 probs+score matrix, L3 odds(5 markets)+edges, L4 4 scripts/match, L5 risk+3 tickets, L7 backtest. **NEVER re-read HTML.** Spot-check PNGs visually only.