技能介绍

要解决的问题

在对话里查 WNBA 数据，看起来只是问一句比分，实际链路并不短：要打开 ESPN 页面、找到对应的端点、确认当前赛季年份、把球队名映射成 ESPN 的 team_id，再把返回的 JSON 整理成能读的比分或榜单。任何一个环节凭记忆硬编码，都可能拿错赛季的数据，或者拿一个已经失效的球队 ID 去请求。这个技能把整套流程收敛成一组语义明确的查询命令，把赛季推导和 ID 解析这类脏活交给技能本身处理。

核心能力与工作方式

底层通过 sports-skills CLI 访问 ESPN 的 WNBA 数据，不需要 API key，也避开了 Python 包导入路径不一致的问题。查询前要先读 references/api-reference.md，里面有端点列表、ID 约定和返回结构；技能说明反复强调先查文档再写查询，就是这个原因。

关键步骤有两条：

赛季推导：年份从 system prompt 的 currentDate 推导，不硬编码。5–10 月赛期用当年；11–4 月休赛期用 current_year - 1。用户显式给出赛季时直接采用。
ID 解析：只给了球队名时，先调 get_teams 拿到 team_id，再使用 get_team_roster、get_team_schedule 这类按球队维度的命令。

命令覆盖面较全：get_scoreboard 拿实时和最近比分，get_standings 拿东西部排名，get_teams 与 get_team_roster 处理球队和阵容，get_schedule 与 get_game_summary 覆盖赛程和单场 box score，get_play_by_play 与 get_win_probability 提供逐回合与胜率曲线，get_leaders、get_team_stats、get_player_stats 对应统计榜，另有 get_news、get_injuries、get_transactions、get_futures 等周边数据。

适用边界与注意点

这个技能只覆盖 ESPN 公开提供的数据。预测市场赔率不在范围内，get_odds 与 get_betting_odds 不存在，需要时另用 polymarket 或 kalshi 类技能；search_teams、get_box_score、get_player_ratings 同样不存在，分别改用 get_teams、get_game_summary、get_player_stats。命令表里没有的，就当作不存在。

容易踩的坑：未开始的比赛没有 box score 数据，get_scoreboard 只覆盖进行中和最近的比赛；11–4 月休赛期 get_scoreboard 返回 0 场，应改用 get_standings 或 get_news；team_id 是 ESPN 的 ID，可能随联盟变动而失效，过期时重新调 get_teams 即可。命令失败时不要把原始报错抛给用户，先用 get_teams 查 ID 再重试，最后才给出一条干净的错误信息。