查询 F1 赛历、赛果、圈速、轮胎策略与车手/车队数据时…

当用户询问 F1 赛事结果、排位、练习、圈速、车手/车队信息或赛历时，使用 FastF1/sports-skills 查询。

适用场景

解决思路

1. 环境要求：Python 3.10+，安装 `pip install sports-skills`。
2. 查询前先查阅 `references/api-reference.md`，获取端点、ID 约定和数据形状。
3. 优先使用 CLI，避免 Python import 路径问题：`sports-skills f1 get_race_schedule --year=2025`。
4. CLI 示例：`sports-skills f1 get_race_results --year=2025 --event=Monza`。
5. Python SDK 替代：`from sports_skills import f1`。
6. Python SDK 示例：`schedule = f1.get_race_schedule(year=2025)`。
7. Python SDK 示例：`results = f1.get_race_results(year=2025, event="Monza")`。
8. 调用任何数据端点前，验证年份来自 system prompt 的 `currentDate`，绝不硬编码。
9. 在 1 月或 2 月使用 `year = current_year - 1`（季前，新 F1 赛季尚未开始）。
10. 从 system prompt 日期推导当前年份（例如 `currentDate: 2026-02-16` → 当前年份 2026）。
11. 如果用户指定年份，按用户指定年份使用。
12. 如果用户说 "latest"、"recent"、"last season" 或未指定年份：F1 赛季大致为 3 月至 12 月；当前月份为 1 月或 2 月时使用 `year = current_year - 1`；从 3 月起使用当前年份。
13. Race Weekend Analysis：调用 `get_race_schedule --year=<year>` 查找事件名称和日期。
14. Race Weekend Analysis：调用 `get_race_results --year=<year> --event=<name>` 获取最终分类（位置、时间、积分）。
15. Race Weekend Analysis：调用 `get_lap_data --year=<year> --event=<name> --session_type=R` 做逐圈速度分析。
16. Race Weekend Analysis：调用 `get_tire_analysis --year=<year> --event=<name>` 获取策略细分（轮胎配方、stint 长度、退化）。
17. Driver/Team Comparison：调用 `get_championship_standings --year=<year>` 获取冠军背景（积分、胜利、领奖台）。
18. Driver/Team Comparison：调用 `get_team_comparison --year=<year> --team1=<t1> --team2=<t2>` 或 `get_driver_comparison --year=<year> --driver1=<d1> --driver2=<d2>`。
19. Driver/Team Comparison：调用 `get_season_stats --year=<year>` 获取综合表现（最快圈、最高速度）。
20. Season Overview：调用 `get_race_schedule --year=<year>` 获取完整赛历（日期和赛道）。
21. Season Overview：调用 `get_championship_standings --year=<year>` 获取车手和车队积分榜。
22. Season Overview：调用 `get_season_stats --year=<year>` 获取赛季最快圈、最高速度、积分领先者。
23. Season Overview：调用 `get_driver_info --year=<year>` 获取当前发车阵容（车手号码、车队、国籍）。
24. 命令 `get_race_schedule`：完整赛季赛历，含日期和赛道。
25. 命令 `get_race_results`：最终比赛分类（位置、时间、积分）。
26. 命令 `get_session_data`：原始 session 信息（Q、FP1、FP2、FP3、R）。
27. 命令 `get_driver_info`：发车阵容中的车手详情。
28. 命令 `get_team_info`：车队信息及车手阵容。
29. 命令 `get_lap_data`：逐圈计时，含 sector 和轮胎数据。
30. 命令 `get_pit_stops`：进站时长和车队平均值。
31. 命令 `get_speed_data`：速度陷阱和中间速度数据。
32. 命令 `get_championship_standings`：车手和车队冠军积分榜。
33. 命令 `get_season_stats`：赛季综合表现。
34. 命令 `get_team_comparison`：车队头对头：排位、正赛速度、sector。
35. 命令 `get_driver_comparison`：车手头对头：排位 H2H、正赛 H2H、速度差。
36. 命令 `get_tire_analysis`：轮胎策略、stint 长度、退化率。
37. 完整参数列表和返回形状见 `references/api-reference.md`。
38. 示例 F1 赛历：从 `currentDate` 推导年份；调用 `get_race_schedule(year=<derived_year>)`；结果：完整赛历（事件名、日期、赛道）。
39. 示例车手正赛表现：从 `currentDate` 或上下文推导年份；调用 `get_race_results(year=<year>, event="Monza")` 获取最终分类；调用 `get_lap_data(year=<year>, event="Monza", session_type="R", driver="VER")` 获取圈速；结果：名次、与领先者差距、最快圈和轮胎策略。
40. 示例季前查询最新结果：在 2026 年 2 月询问时，当前月份为 February → 赛季未开始 → 使用 `year = 2025`；调用 `get_race_schedule(year=2025)` 找该赛季最后一场；调用 `get_race_results(year=2025, event=<last_event>)` 获取最终比赛结果；结果：2025 年最后一场比赛结果。
41. 不要调用 `get_qualifying` / `get_practice`；它们不存在。用 `get_session_data` 并指定 `session_type="Q"` 表示排位，或 `session_type="FP1"`/`"FP2"`/`"FP3"` 表示练习。
42. 不要调用 `get_standings`；它不存在。用 `get_championship_standings`。
43. 不要调用 `get_results`；它不存在。用 `get_race_results`。
44. 不要调用 `get_calendar`；它不存在。用 `get_race_schedule`。
45. 如果命令不在 Commands 表中，则不存在，不要调用。
46. 错误：事件名未找到。原因：事件名拼写不匹配 FastF1 内部命名。解决：先调用 `get_race_schedule(year=<year>)` 获取准确事件名，再用正确名称重试。
47. 错误：Session 数据为空。原因：session 尚未发生。解决：FastF1 只返回已完成 session 的数据；查看 `get_race_schedule` 了解 session 计划时间。
48. 错误：`get_race_results` 没有返回 `fastest_lap_time`。原因：有些比赛的结果端点不含最快圈数据。解决：使用 `get_lap_data(session_type="R")` 并找所有车手的最小 `lap_time`。
49. 错误：在 1 月或 2 月查询当前年份无数据。原因：新 F1 赛季尚未开始。解决：任何 3 月前查询使用 `year = current_year - 1`；不要在 3 月前查询当前年份。

适用边界 · 注意事项

• 不要用于其他赛车运动（MotoGP、NASCAR、IndyCar、WEC、Formula E）。
• 不要用于 F1 投注赔率或预测；改用 `kalshi` 或 `polymarket`。
• 不要用于 F1 新闻文章；改用 `sports-news`。