查询 ATP/WTA 网球比分、排名、赛历…

需要 ATP/WTA 网球赛事比分、排名、赛历、球员资料或新闻时，通过 sports-skills CLI 调用 ESPN 公共端点获取，无需 API key。

适用场景

解决思路

1. 在编写查询前，查阅 `references/api-reference.md`，获取端点、ID 约定和数据结构。
2. 优先使用 CLI，以避免 Python import path 问题：`sports-skills tennis`。
3. 调用任何数据端点前，确认已指定 `tour` 参数（`atp` 或 `wta`）；该参数没有默认值。
4. 调用任何数据端点前，从系统提示的 `currentDate` 推导年份；绝不硬编码年份。
5. 大多数命令需要 `--tour=atp` 或 `--tour=wta`；ATP 表示男子职业网球巡回赛，WTA 表示女子职业网球巡回赛。
6. 如果用户未指定巡回赛，询问用户选择哪个，或调用命令两次以同时展示 ATP 和 WTA。
7. 使用 `get_scoreboard` 获取某巡回赛的直播/近期赛事比分。
8. 使用 `get_rankings` 获取 ATP 或 WTA 球员排名。
9. 使用 `get_calendar` 获取完整赛季赛事日历。
10. 使用 `get_player_info` 获取单个网球球员资料。
11. 使用 `get_news` 获取网球新闻文章。
12. 完整参数列表和返回结构查阅 `references/api-reference.md`。
13. 直播赛事检查流程：1. 调用 `get_scoreboard --tour=<atp|wta>`；2. 按轮次展示当前比赛；3. 如需球员信息，使用 `get_player_info --player_id=<id>`。
14. 排名查询流程：1. 调用 `get_rankings --tour=<atp|wta> --limit=20`；2. 展示排名、积分和趋势。
15. 赛季日历流程：1. 调用 `get_calendar --tour=<atp|wta> --year=<year>`；2. 过滤特定赛事。
16. 示例：ATP 直播比赛，调用 `get_scoreboard(tour="atp")`，得到按轮次组织的当前赛事比赛、比分和状态。
17. 示例：WTA 排名，调用 `get_rankings(tour="wta", limit=20)`，得到前 20 名 WTA 球员的排名、姓名、积分和趋势。
18. 示例：查询法网日期，从 `currentDate` 推导年份；调用 `get_calendar(tour="atp", year=<derived_year>)`；在结果中搜索 "Roland Garros"（法网官方名称）；得到法网日期、地点 Paris 和场地 clay。
19. 不要调用不存在的命令：`get_matches`（用 `get_scoreboard` 获取当前比赛比分）；`get_draw`（该 API 不提供赛事签表数据）；`get_head_to_head`（该 API 不提供交手记录）；`get_standings`（网球使用 `get_rankings`，不是 standings）。
20. 如果命令不在 Commands 表中，则不存在，不要调用。
21. 故障排除 `get_scoreboard` 返回无比赛：原因网球赛事有特定赛周，可能本周无赛事；解决：调用 `get_calendar(tour=...)` 查找下一场赛事时间。
22. 故障排除 排名为空：原因排名每周一更新，可能有短暂更新窗口；解决：命令会自动重试前几周；若仍为空，几分钟后重试。
23. 故障排除 球员资料失败：原因球员 ID 不正确；解决：用 `get_rankings` 从当前排名列表找球员 ID，或通过 ESPN 网球 URL 验证。
24. 故障排除 比分似乎延迟或不实时更新：原因比分在每盘/每场比赛完成后更新，而非逐分更新；解决：这是预期行为；定期刷新 `get_scoreboard` 获取更新后的盘分。

适用边界 · 注意事项

• 用户询问其他运动（足球、NFL、NBA、WNBA、NHL、MLB、高尔夫、板球、大学橄榄球、大学篮球、F1）时，不要用本技能；改用对应的 sports skills。
• 用户需要博彩赔率时，不要用本技能；使用 polymarket 或 kalshi。用户需要新闻时，使用 sports-news。
• 用户需要逐分实时数据时，不要用本技能；比分在每盘/每场比赛完成后更新。