tradingai666/worldcup2026-prediction-skill

“GUI 是给人手设计的,CLI 是给 AI 设计的。Skill 是给 LLM 用的提示词。” — 项目作者 · 柱子哥

📚 目录 · Table of Contents

• ✨ 核心特性
• 🎯 它解决什么问题
• 🧠 架构 · 四层约束
• 🚀 快速开始
• 🌐 兼容模型
• 📦 输出契约
• 🇲🇽 分组与赛程
• 🔄 每日情报更新流程
• 💡 适用场景
• 🛣️ Roadmap
• ❓ FAQ
• 🤝 Contributing
• ⚠️ 声明
• 📜 License
• 🙏 致谢

---

✨ 核心特性

---

🎯 它解决什么问题

直接问大模型 “墨西哥对南非谁会赢?”,你会得到:

❌ 编造历史交锋 — 两队从未交手,它能列出"上次 2-1" ❌ 编造伤病信息 — 编造"梅西腿伤上半场退场" ❌ 格式飘忽不定 — 一会儿大段文字,一会儿 markdown,一会儿表格 ❌ 信息严重过时 — 训练数据截止到 2024,2026 预选赛它不知道 ❌ 无法接前端 — 自然语言输出根本没法解析

本 Skill 用 4 层约束 一次治住所有问题:

┌─────────────────────────────────────────────────────────┐
│            一份 system prompt = 一个垂类小模型            │
└─────────────────────────────────────────────────────────┘
                            ↓
┌────────────────┬─────────────────┬─────────────────────┐
│  Layer 1       │  Layer 2        │  Layer 3            │
│  📚 资料库     │  📐 方法论      │  📦 输出契约         │
│  48 队锁死     │  4 维权重       │  严格 JSON Schema   │
└────────────────┴─────────────────┴─────────────────────┘
                            +
┌─────────────────────────────────────────────────────────┐
│  Layer 4 · 🔄 每日情报区(动态覆盖位 · 实时跟进伤停)      │
└─────────────────────────────────────────────────────────┘

---

🧠 架构 · 四层约束

                    用户提问
                       │
                       ▼
        ┌──────────────────────────────┐
        │  LLM (DeepSeek / GPT / ...)  │
        └──────────────┬───────────────┘
                       │
       ┌───────────────┴────────────────┐
       │     skill.md (system prompt)    │
       ├────────────────────────────────┤
       │                                 │
       │  ① 资料库 ─ Knowledge Base      │
       │     ├─ 48 队分档(4 档)         │
       │     ├─ 核心球员 + 状态          │
       │     ├─ 教练 + 体系              │
       │     └─ 隐忧 + 历史底蕴          │
       │                                 │
       │  ② 方法论 ─ Methodology         │
       │     ├─ 近期状态  ████████  40%  │
       │     ├─ 硬实力    ██████    30%  │
       │     ├─ 历史交锋  ███       15%  │
       │     ├─ 情境因素  ███       15%  │
       │     └─ 🚫 胜率硬上限 ≤ 85%      │
       │                                 │
       │  ③ 输出契约 ─ Output Schema     │
       │     └─ JSON · 字段固定 · 总和=100│
       │                                 │
       │  ④ 每日情报区 ─ Daily Brief     │
       │     └─ 动态覆盖位 · 优先级最高   │
       │                                 │
       └─────────────┬──────────────────┘
                     │
                     ▼
        ┌──────────────────────────────┐
        │   严格 JSON 预测结果(前端可渲染)│
        └──────────────────────────────┘

各层职责拆解

Layer 1 · 资料库

全部 48 队的核心球员、近况、隐忧均写死在 skill.md 内,模型只许引用,严禁编造。

Layer 2 · 方法论

⚠️ 铁律:实力悬殊也不得给出超过 85% 的胜率(足球有偶然性 — 2022 沙特 vs 阿根廷)

Layer 3 · 输出契约

详见下方 输出契约 章节。

Layer 4 · 每日情报区

详见下方 每日情报更新流程 章节。

---

🚀 快速开始

Method 1 — cURL · 一行直接跑

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-v4-pro",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "system", "content": ""},
      {"role": "user", "content": "请预测这场 2026 世界杯比赛:【小组赛】墨西哥 vs 南非。严格按约束文档的 JSON 格式输出。"}
    ]
  }'

Method 2 — Python · 接进你的应用

import openai, pathlib, json

SKILL = pathlib.Path("skill.md").read_text(encoding="utf-8")
client = openai.OpenAI(base_url="https://api.deepseek.com", api_key="...")

def predict(team_a: str, team_b: str, stage: str = "小组赛") -> dict:
    resp = client.chat.completions.create(
        model="deepseek-v4-pro",
        response_format={"type": "json_object"},
        messages=[
            {"role": "system", "content": SKILL},
            {"role": "user",   "content": f"请预测这场 2026 世界杯比赛:【{stage}】{team_a} vs {team_b}。严格按约束文档的 JSON 格式输出。"},
        ],
    )
    return json.loads(resp.choices[0].message.content)

print(predict("墨西哥", "南非"))

Method 3 — Node.js · TypeScript

import OpenAI from "openai"
import { readFileSync } from "node:fs"

const SKILL = readFileSync("skill.md", "utf-8")
const client = new OpenAI({ baseURL: "https://api.deepseek.com", apiKey: process.env.DEEPSEEK_API_KEY })

export async function predict(teamA: string, teamB: string, stage = "小组赛") {
  const r = await client.chat.completions.create({
    model: "deepseek-v4-pro",
    response_format: { type: "json_object" },
    messages: [
      { role: "system", content: SKILL },
      { role: "user",   content: `请预测这场 2026 世界杯比赛:【${stage}】${teamA} vs ${teamB}。严格按约束文档的 JSON 格式输出。` },
    ],
  })
  return JSON.parse(r.choices[0].message.content!)
}

---

🌐 兼容模型

推荐 DeepSeek-V4-Pro:成本最低、JSON 稳定、中文表达自然。

---

📦 输出契约

每次调用返回一份严格 JSON,字段、类型、长度全部锁死:

{
  "teamA":           { "name": "墨西哥", "winProb": 70 },
  "draw":            20,
  "teamB":           { "name": "南非",   "winProb": 10 },
  "predictedScore":  "2-0",
  "confidence":      "高",
  "keyFactors":      [
    "阿兹特克主场揭幕战气势如虹",
    "墨西哥金杯冠军班底实力碾压",
    "南非时隔16年重返经验不足"
  ],
  "analysis":        "东道主墨西哥在阿兹特克球场迎战南非,实力与主场优势明显……",
  "playersToWatch":  [
    { "team": "墨西哥", "player": "圣地亚哥·希门尼斯", "reason": "米兰前锋状态火热" },
    { "team": "南非",   "player": "佩西·塔乌",         "reason": "南非进攻核心,肩负爆冷希望" }
  ]
}

字段约束表

阶段(stage)取值

小组赛 → 32 强 → 16 强 → 8 强 → 半决赛 → 决赛

淘汰赛的 draw 概率代表 90 分钟战平进加时/点球(对应 analysis 须说明谁更可能笑到最后)。

---

🇲🇽 分组与赛程

赛事:2026 FIFA World Cup(美国 · 加拿大 · 墨西哥三国联办) 日期:2026 年 6 月 11 日 — 7 月 19 日 揭幕战:6 月 11 日 · 墨西哥 vs 南非 · 阿兹特克球场

---

🔄 每日情报更新流程

核心设计:写死的资料库 + 每天可覆盖的情报位 = 动静结合。

┌─────────────────────────────────────────┐
│  skill.md  (~10 KB · 一二三四五节 锁死)  │
│  ────────────────────────────────────   │
│  一、赛事基本盘                          │
│  二、预测方法论                          │
│  三、输出格式契约                        │
│  四、48 队球队资料库                     │
│  五、红线                                │
│                                         │
│  ↓↓↓ 永远只动这一节 ↓↓↓                   │
│                                         │
│  六、最新情报(每日更新区)               │
│   - 情报日期:YYYY-MM-DD                 │
│   - 未来 48h 参赛队伤停 / 状态要点       │
│   - 与第四节冲突时,以本节为准            │
└─────────────────────────────────────────┘

推荐自动化方式

⚠️ 永远不要动一至五节——这是资料库稳定性的保证。

---

💡 适用场景

• 📱 球迷应用 / 小程序 — 直接喂给前端渲染预测卡片
• 🤖 微信群 / Discord 机器人 — 群友提问即出预测
• 📊 数据可视化看板 — 64 场比赛批量预测 · 跑出冠军树
• 🎙️ 内容创作辅助 — 解说稿 / 短视频脚本基础数据
• 🎮 预测游戏 / 竞猜社区 — 作为 AI 对手 / 参考意见(非投注)
• 🧪 Prompt Engineering 教学样本 — 极简结构 · 教科书级约束设计

---

🛣️ Roadmap

• [x] v1.0 — 48 队完整资料库 + 4 层约束 + 严格 JSON
• [x] v1.0 — DeepSeek / Qwen / GPT / Claude 全模型适配
• [x] v1.0 — 在线 Demo 站(worldcup.youliaoyun.com)
• [ ] v1.1 — 每日情报区自动化更新 GitHub Action
• [ ] v1.1 — 英文版 skill.en.md
• [ ] v1.2 — 球员级别预测(进球者 / MVP / 黄牌)
• [ ] v1.2 — 赛后回测脚本(对照实际结果统计命中率)
• [ ] v2.0 — 升级为 Skill Pack:把方法论抽象为可复用的"赛事预测 Skill 模板",支持欧洲杯 / 奥运 / NBA

---

❓ FAQ

---

🤝 Contributing

欢迎以任何形式贡献:

• ⭐ Star 本项目 — 最简单的支持方式
• 🐛 报告 Bug / 提 Issue — 发现预测离谱、字段约束失效、文档错漏
• 📝 修订资料库 — 球员转会 / 教练变更 / 大赛阵容(请附信息来源)
• 🌍 翻译 — 帮助本 Skill 走向更多语言
• 💡 二次创作 — 做了自己的预测站 / 小程序?来 Issues 里炫一下

提交流程

git clone https://github.com/TradingAi666/worldcup2026-prediction-skill.git
cd worldcup2026-prediction-skill
git checkout -b feature/your-update
# 修改 skill.md 或 README.md
git commit -m "docs: update XX team roster"
git push origin feature/your-update
# 然后到 GitHub 开 PR

---

⚠️ 声明

• 🎯 本项目仅供娱乐与球迷讨论
• 🚫 Skill 内置红线 — 拒绝输出任何投注、赔率、下注建议
• 🧠 预测结果不构成任何参考依据,请理性看球
• ⚖️ 所有球队、球员、教练信息均为公开资料,不涉及隐私
• 🌍 仅供 2026 FIFA World Cup 一届使用,赛后将归档

---

📜 License

MIT License © 2026 TradingAi666

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, ...

---

🙏 致谢

• FIFA — 提供本届赛事赛程与分组信息
• DeepSeek / Qwen / OpenAI / Anthropic — 提供本 Skill 赖以运行的 LLM 能力
• 柱子哥(TzFilm)社区 — 持续的反馈与共创
• 所有 ⭐ 本项目的朋友 — 是你们让"提示词也可以开源"这件事被看见

---