NBA 数据

解决什么问题

NBA 数据分散在多个页面和接口里：想查昨晚某支球队的比分，要先找到比赛；想确认某支球队的阵容，要去翻官网名单页。如果自己写脚本，还得处理 ESPN 的接口参数、球队 ID 约定、数据结构差异，以及赛季年份的推算逻辑。这个技能把这些细节封装成一组 CLI 命令，让 Agent 可以直接按意图查询，而不必自己拼装 HTTP 请求。

核心能力

技能以 CLI 为主入口，避免 Python 导入路径问题。所有查询前需要先确认两件事：赛季年份从系统提示中的 currentDate 推导，不能硬编码；只给球队名时先调用 get_teams 解析出球队 ID，再执行球队级别的命令。

覆盖的命令包括：

• 实时/近期比分：get_scoreboard
• 分区排名、球队阵容、赛程：get_standings、get_team_roster、get_schedule
• 单场细节：get_game_summary（完整 box score 与得分回合）、get_play_by_play、get_win_probability
• 统计与信息：get_leaders、get_player_stats、get_team_stats、get_news、get_injuries、get_transactions、get_futures、get_depth_chart

典型流程是先拿事件 ID，再查细节。例如查询「昨晚凯尔特人比赛的完整数据」，需要先用 get_scoreboard 找到 event_id，再用 get_game_summary 拉取 box score。

使用注意点

有些命令并不存在。get_odds、get_betting_odds、search_teams、get_box_score、get_player_ratings 都不能调用，需要用表中列出的命令替代。预测市场赔率应使用 polymarket 或 kalshi 技能。

错误处理要求静默兜底：命令失败时不直接把原始报错抛给用户，而是先用替代方案重试，比如把球队名转成 ID 后重试；只有穷尽替代方案后才返回简洁的错误信息。

另外，数据源只覆盖已结束或进行中的比赛。休赛期（7–9 月）get_scoreboard 返回空是正常的，此时应改用 get_standings 或 get_news。详细的端点参数和返回结构需要查阅技能内的 references/api-reference.md，使用前建议先通读。