高尔夫赛事数据

为什么需要它

把高尔夫赛事数据接进 Agent 或自动化脚本，麻烦的地方不在于"没有数据"，而在于它的数据模型和多数体育 API 完全不同：

• 高尔夫没有"比赛"，只有"锦标赛"：每场赛事通常打 4 轮（周四到周日），排行榜上是 72～147 名个人球员，不是两支球队。
• 成绩是相对杆数，不是积分：-17、E（平标准杆）、+2 这类字符串，直接做数值计算很容易踩坑。
• 每周基本只有一场赛事：赛程稀疏，查询时经常遇到"当前没有进行中的赛事"。
• 没有积分榜接口：FedEx Cup 排名不在这套 API 的覆盖范围内。

这个技能把上述细节封装成一组 CLI 命令，调用方不必自己处理赛事周期、球员 ID 获取和错误兜底。

它是怎么工作的

核心是六个命令，覆盖最常见的查询场景：

• get_leaderboard：当前赛事排行榜，含每位球员的逐轮成绩拆解
• get_schedule：完整赛季赛程，返回赛事名称、日期和举办球场
• get_player_info / get_player_overview：球员基础资料，以及赛季统计、世界排名和近期战绩
• get_scorecard：单球员逐洞记分卡，含每洞杆数和相对标准杆
• get_news：高尔夫新闻文章

调用前有两条必须遵守的约定：

1. --tour 参数没有默认值。每条命令都要显式指定 pga、lpga 或 eur（DP World Tour）。用户没有说明时默认 pga，提到"女子高尔夫"或 LPGA 时用 lpga，提到欧洲锦标赛时用 eur。
2. 球员 ID 不允许猜测。ID 只能从 get_leaderboard 的结果中获取，或从 ESPN 高尔夫 URL 中解析（espn.com/golf/player/_/id/<id>/<name>）。

推荐直接走 CLI 而不是 Python 库，因为 CLI 避开了 Python import 路径问题；环境需要 Python 3.10+，但不需要任何 API key。出错时不要把原始错误直接抛给用户：当前没有赛事就提示查赛程，球员 ID 不对就建议用排行榜找回。

边界与坑

• 不存在的命令不要调用：没有 get_rankings（FedEx Cup / 世界排名不提供）、get_odds（赔率需另用 polymarket 或 kalshi 类技能）、get_tournament_results，也没有球员搜索命令。不在命令表里的东西就当作不存在。
• 赛事间歇期数据为空：锦标赛之间排行榜可能没有进行中的赛事；开赛前或轮次未结束时，逐轮成绩字段会是空的，需要根据赛事状态判断。
• 查不到就换路径：球员 ID 查询失败时，先从当前赛事排行榜里找该球员，而不是反复重试同一个 ID。