kbo-results

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

KBO Results

KBO Results

What this skill does

技能用途

kbo-game
패키지로 특정 날짜 KBO 경기 정보를 가져와 경기 일정, 스코어, 상태를 요약한다.
通过
kbo-game
包获取指定日期的KBO赛事信息,汇总赛事日程、比分、状态。

When to use

适用场景

  • "오늘 KBO 경기 결과 알려줘"
  • "어제 한화 경기 스코어 보여줘"
  • "2026-04-01 KBO 일정 정리해줘"
  • "告诉我今天KBO的比赛结果"
  • "给我看昨天韩华队的比赛比分"
  • "整理2026-04-01的KBO赛程"

Prerequisites

前置要求

  • Node.js 18+
  • npm install -g kbo-game
  • Node.js 18+
  • npm install -g kbo-game

Inputs

输入参数

  • 날짜:
    YYYY-MM-DD
  • 선택 사항: 특정 팀명
  • 日期:
    YYYY-MM-DD
  • 可选参数:指定球队名称

Workflow

工作流程

0. Install the package globally when missing

0. 缺少包时优先全局安装

npm root -g
아래에
kbo-game
이 없으면 다른 구현으로 우회하지 말고 전역 Node 패키지 설치를 먼저 시도한다.
bash
npm install -g kbo-game
패키지가 없다는 이유로 다른 비공식 scoreboard 소스를 자동 채택하지 않는다.
如果
npm root -g
路径下不存在
kbo-game
,不要改用其他实现,优先尝试安装全局Node包。
bash
npm install -g kbo-game
不得因缺少该包就自动采用其他非官方赛事榜单数据源。

1. Fetch the date

1. 获取指定日期数据

bash
GLOBAL_NPM_ROOT="$(npm root -g)" node --input-type=module - <<'JS'
import path from "node:path";
import { pathToFileURL } from "node:url";

const entry = pathToFileURL(
  path.join(process.env.GLOBAL_NPM_ROOT, "kbo-game", "dist", "index.js"),
).href;
const { getGame } = await import(entry);

const date = "2026-03-25";
const games = await getGame(new Date(`${date}T00:00:00+09:00`));
console.log(JSON.stringify(games, null, 2));
JS
kbo-game@0.0.2
기준 실제 export는
getGame
하나이며, 문자열 날짜(
"2026-03-25"
)를 직접 넘기면 실패한다. 항상
Date
객체로 변환해서 호출한다. 전역 설치를 기본으로 쓰므로 inline snippet에서는 전역 npm root 아래 entry file을 직접 import 한다.
bash
GLOBAL_NPM_ROOT="$(npm root -g)" node --input-type=module - <<'JS'
import path from "node:path";
import { pathToFileURL } from "node:url";

const entry = pathToFileURL(
  path.join(process.env.GLOBAL_NPM_ROOT, "kbo-game", "dist", "index.js"),
).href;
const { getGame } = await import(entry);

const date = "2026-03-25";
const games = await getGame(new Date(`${date}T00:00:00+09:00`));
console.log(JSON.stringify(games, null, 2));
JS
kbo-game@0.0.2
版本为准,实际导出的方法只有
getGame
,直接传入字符串格式的日期(
"2026-03-25"
)会调用失败,必须转换为
Date
对象再调用。默认使用全局安装的包,因此内联代码片段中直接导入全局npm root路径下的入口文件。

2. Normalize for humans

2. 人性化整理数据

원본 데이터를 그대로 던지지 말고 아래 기준으로 정리한다.
  • 홈팀 vs 원정팀
  • 진행 상태 또는 경기 종료 여부
  • 스코어
  • 필요한 경우 특정 팀만 필터링
不要直接返回原始数据,需按照以下规则整理:
  • 主队 vs 客队
  • 比赛进行状态或是否完赛
  • 比分
  • 如有需要,仅过滤出指定球队的赛事

3. Keep the answer compact

3. 保持回答简洁

사용자가 scoreboard를 원하면 경기별 한 줄 요약부터 준다.
如果用户需要赛事榜单,优先提供每场比赛的单行摘要。

Done when

完成判定标准

  • 날짜 기준 전체 경기 요약이 있다
  • 팀 필터 요청이면 해당 팀 경기만 남아 있다
  • raw JSON이 필요하면 별도로 제공할 수 있다
  • 已生成指定日期的全部赛事摘要
  • 如用户要求筛选球队,仅保留对应球队的赛事
  • 若用户需要原始JSON可单独提供

Failure modes

异常情况

  • KBO 사이트 변경으로 패키지 응답이 깨질 수 있다
  • 비시즌 날짜는 빈 결과가 올 수 있다
  • KBO官网改版可能导致包的请求返回异常
  • 非赛季日期查询可能返回空结果

Notes

注意事项

  • 이 스킬은 조회 전용이다
  • 사용자 기준 "오늘/어제" 같은 상대 날짜는 항상 절대 날짜로 변환해서 실행한다
  • 该技能仅用于查询
  • 用户输入的"今天/昨天"这类相对日期,必须转换为绝对日期再执行查询