NFL 数据

解决的数据获取难题

在构建 NFL 分析工具或球迷应用时，开发者常面临三个核心挑战：数据分散在多个非结构化接口中、赛季时间逻辑复杂导致统计偏差、以及第三方 API 依赖引入的密钥管理与稳定性风险。NFL 数据技能通过统一接口层解决这些问题。

核心能力与执行流程

该技能提供 23 个命令接口，覆盖实时比分、联盟排名、球队阵容、比赛摘要、球员统计等全维度数据。关键执行路径分为三步：

1. 赛季年份动态推导：从系统当前日期自动计算有效赛季，避免硬编码导致的统计偏差。例如 2026-02-16 的系统时间会正确关联到 2025-2026 赛季，而 2026-08-01 则指向 2026-2027 赛季。
2. 团队标识解析机制：当用户输入“堪萨斯城酋长队”时，先调用 get_teams 获取标准化团队 ID，再执行 get_team_roster(team_id="12")，避免因名称变体导致的查询失败。
3. 多后端数据融合：基础接口（如 get_scoreboard）依赖 ESPN 数据源，而 get_nflverse_* 系列命令通过 nflverse 数据表提供更结构化的 parquet 数据，支持周维度阵容、球员统计等细粒度分析。

适用边界与工程注意点

该技能不提供赔率类数据接口（需使用 polymarket/kalshi 技能），也不支持模糊搜索命令（应使用 get_teams 而非虚构的 search_teams）。在季后赛场景中，周次编号采用统一规则：外卡周为第 19 周，超级碗固定为第 23 周，与常规赛周次体系不同。

对于未安装 nflverse 扩展的场景，get_nflverse_* 系列命令将不可用，需通过 pip install sports-skills[nfl] 安装 NFL 扩展包。在错误处理方面，技能采用静默重试机制：当团队 ID 查询失败时自动回退到名称解析流程，仅在最终失败时返回干净错误信息。