MLB 数据
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指南,将 @user_3c6cb52e/mlb-data-o0qa 安装到当前 AI 助手中。
技能介绍
问题:MLB 数据散落在多个入口
让 Agent 查 MLB 数据常遇三类问题:一是比分、排名、阵容、伤病、交易分布在不同页面,来回切换才能拼出完整信息;二是赛季逻辑复杂,MLB 跨年运行,休赛期比分会空,队名到 ID 的映射也不能跳过;三是查询入口不稳定,硬编码赛季年份或直接传队名常导致空结果或报错。sports-skills CLI 把这层差异收敛成一组固定命令,但 Agent 仍需自己判断何时查什么、选哪个赛季。
技能如何工作
核心是把「想查什么」映射到固定命令:get_scoreboard、get_standings、get_teams、get_team_roster、get_team_schedule、get_game_summary、get_leaders、get_news、get_play_by_play、get_win_probability、get_schedule、get_injuries、get_transactions、get_depth_chart、get_team_stats、get_player_stats。
关键步骤:
- 从当前日期推导赛季年份:MLB 赛季从 3 月底持续到 10 月;1-3 月应取上一个完整赛季,4 月起用当前自然年;用户明确指定赛季时直接采用
- 队名先转 ID:只给队名时先
get_teams解析 ID,再查阵容、赛程或伤病 - 比分查完拿 event_id:要比赛详情时先
get_scoreboard找event_id,再交给get_game_summary或get_play_by_play - 避开不存在的命令:
get_odds、get_search_teams、get_box_score、get_player_ratings均不存在,应改用get_standings、get_teams、get_game_summary、get_player_stats
适用边界
- 休赛期数据有限:11 月到次年 3 月,
get_scoreboard常返回 0 场,应改用get_standings、get_news、get_transactions - 不含赔率:博彩与预测市场数据不可用,需另接 polymarket 或 kalshi 类技能
- 未来比赛无详细数据:
get_game_summary、get_play_by_play、get_win_probability仅对已完成或进行中的比赛有效,未来赛程用get_schedule - 队 ID 可能过期:ESPN 的 ID 若失效,需重新
get_teams获取最新的 30 队列表 - 失败不要抛裸错误:命令失败时应先静默重试或换用 ID 查询,再给出简洁提示
使用场景
- 比赛进行时,需要按当前日期拉取 MLB 实时比分,并查看每局得分和比赛状态。
- 讨论分区排名时,要根据系统当前日期确定赛季年份,再查指定联盟分区的胜场差。
- 写球队分析前,需要先解析队名对应的 ID,再拉取完整阵容、深度图或球队统计。
- 核对昨晚比赛时,要先从比分接口拿到 event_id,再查完整比赛详情或逐球记录。
适合人员
- 体育数据工程师,需要用 CLI 稳定获取 MLB 结构化数据并接入内部系统。
- 比赛内容编辑,要在赛前查阵容伤病、赛后快速核对比分和比赛详情。
- 球队分析爱好者,会按赛季年份查询排名、球员统计和深度图来写观察。
- Agent 开发者,要把 MLB 查询封装进助手但不想处理队名到 ID 的映射细节。