技能介绍

要解决的问题

足球数据分散在多个免费数据源里：ESPN 有赛程和比分，Understat 有 xG，FPL 有伤停和赛季榜单，ClubElo 有 Elo 评分和赛果预测，Transfermarkt 有身价和转会历史。开发者要自己写对接代码、处理不同 ID 体系、忍受覆盖范围不一致。这个技能把上述源封装成一组命令，让 Agent 直接用自然语言查询，不必关心底层接口差异。

工作原理

核心是一组 CLI 命令（也提供 Python SDK，但官方推荐走 CLI 以避免 import 路径问题），无需 API key。任何数据查询前都要先做三件事：

用 get_current_season 获取当前赛季 ID，不要硬编码年份。赛季格式是 {league-slug}-{year}，如 premier-league-2025 表示 25-26 赛季；MLS 是特例，跨年在单一自然年内进行。
用 search_team 把球队名解析成数字 team_id，H2H、强度和预测这三类调用必须传 ID——名称有歧义时（比如两个 "Paris" 俱乐部）会解析到错误的球队。
写查询前先查 references/api-reference.md 确认端点覆盖范围。

能力上分三层：ESPN 是骨架，覆盖所有联赛的积分榜、赛程、阵容、统计和时间线；Understat 只给五大联赛提供 xG；FPL 只支持英超的赛季榜单和伤停；ClubElo 给欧洲俱乐部（含俄罗斯）提供强度和约一周窗口内的赛果预测。组合使用时，相互独立的调用可以并行执行；某一块没覆盖就静默跳过，把有数据的部分交付出去，不要被一个缺失的源阻塞整条回答。

边界与注意点

覆盖范围不均匀：xG 仅五大联赛（俄超已被 Understat 放弃），赛季榜单和伤停仅限英超。查询未覆盖的端点会返回空 payload 加说明信息，而不是报错——读到后回退即可。
ESPN 始终是比分权威，不要让富数据源覆盖 ESPN 的比分。
ClubElo 在夏休期可能查不到俱乐部强度，传一个赛季内的日期（如 date="2026-03-01"）可以绕开。
get_match_forecast 只在赛日前约一周内有效，空窗期返回空是正常的，不是故障。
H2H 只统计同级别联赛的交锋，杯赛或跨级别相遇不计入。
命令列表是封闭的：get_standings、get_live_scores 这类名字不存在，不应调用。