技能介绍

解决什么问题

做网球相关的 Agent 应用时，数据获取通常很琐碎：ATP 和 WTA 是两套独立体系，赛程、排名、球员 ID 互不通用；不同数据源的接口规范也不一致，写查询前要先翻文档确认字段。这个技能把常见的网球数据查询收敛成一组命令行调用，让 Agent 在对话中直接拿到结构化的赛事、排名与球员信息，而不用自己对接多个 API。

核心能力

技能提供四个命令，覆盖大多数查询场景：

get_scoreboard：获取某个巡回赛正在进行或最近结束的赛事比分，结果按轮次组织。
get_rankings：查询 ATP 或 WTA 球员排名，可指定返回数量。
get_calendar：返回完整赛季的赛事日历，可按年份过滤。
get_player_info：查询单个球员的资料。

使用前有两个硬性约定。第一，--tour 参数没有默认值，ATP（男子）和 WTA（女子）必须显式指定；如果用户没说清，应当追问或分别查两次。第二，年份必须从系统提示中的 currentDate 推导，不能硬编码，否则赛程类查询很容易拿到过期数据。

查询前建议先阅读 references/api-reference.md，其中定义了端点、ID 规范和返回数据结构。技能优先走 CLI 而非 Python 导入，以避免模块路径问题。

注意点与适用边界

这个技能不提供全部网球数据，未列入命令表的调用一律不存在。例如 get_draw（签表）、get_head_to_head（交手记录）、get_matches 和 get_standings 都没有实现；查比分要用 get_scoreboard，排名只能用 get_rankings。

运行时还会遇到几类正常现象：get_scoreboard 返回空，通常是本周没有赛事安排，可用 get_calendar 确认下一站比赛时间；排名在每周一更新，更新窗口内可能短暂为空，命令会自动重试上一周数据；比分按盘或场结束时更新，不是逐分实时，需要定期刷新；球员资料查询失败多半是 player ID 不对，可以先从排名列表里拿到正确 ID。