lck-analytics

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

LCK Results + Advanced Analysis

LCK赛事结果 + 高级分析

What this skill does

本Skill的功能

이 스킬은 LCK 조회/분석 전용이다.

특정 날짜 LCK 경기 결과 조회
특정 팀 alias 정규화 후 필터링
현재 스플릿 순위 조회
진행 중 경기 live stats 조회
live timeline 기반 turning point 분석
Oracle's Elixir 스타일 historical row / CSV 기반
- 팀 파워 레이팅
- 챔피언 matchup / synergy 분석
- patch meta 요약
날짜별 match analysis 생성

本Skill专用于LCK数据查询与分析。

查询特定日期的LCK赛事结果
特定战队别名归一化后筛选
查询当前赛季分赛排名
查询进行中赛事的实时数据
基于实时时间线的转折点分析
基于Oracle's Elixir风格的历史行数据/CSV
- 战队战力评分
- 英雄对位/协同效果分析
- 版本生态总结
生成按日期划分的赛事分析

Origin / attribution

来源/归属

이 스킬은

jerjangmin

님이 만든 원본

lck-analytics

skill pack을 k-skill 저장소 안으로 옮기고, 이 저장소의 npm workspace / Changesets 배포 방식에 맞게 정리한 버전이다.

本Skill是将

jerjangmin

开发的原始

lck-analytics

Skill包迁移到k-skill仓库，并适配该仓库的npm workspace / Changesets发布流程整理后的版本。

When to use

使用场景

"오늘 LCK 경기 결과 알려줘"
"2026-04-01 한화 경기 결과랑 순위 보여줘"
"지금 T1 경기 킬/골드/오브젝트 요약해줘"
"이 경기 turning point가 뭐였어?"
"이 밴픽에서 어느 쪽 조합이 더 좋았는지 설명해줘"
"현재 패치에서 어떤 챔피언이 메타 픽인지 보여줘"
"LCK 팀 파워 레이팅 보여줘"

"告诉我今天LCK的赛事结果"
"给我看2026-04-01韩华的赛事结果和排名"
"总结现在T1比赛的击杀/经济/资源获取情况"
"这场比赛的转折点是什么？"
"说明下这次禁选里哪边的阵容更好？"
"给我看下当前版本哪些英雄是版本热门选择"
"给我看下LCK战队战力评分"

Prerequisites

前置要求

Node.js 18+
```
npm install -g lck-analytics
```

패키지가 없으면 다른 방법으로 우회하지 말고 먼저 전역 설치를 시도한다.

bash

npm install -g lck-analytics

Node.js 18+
```
npm install -g lck-analytics
```

如果没有该包，请勿采用其他方式绕过，请先尝试全局安装。

bash

npm install -g lck-analytics

Inputs

输入参数

기본 입력

基础输入

날짜:
```
YYYY-MM-DD
```
선택 사항: 팀명, 과거 팀명, 한글/영문 약칭 alias

日期：
```
YYYY-MM-DD
```
可选项：战队名、曾用战队名、中韩英文缩写别名

고급 분석 입력

高级分析输入

Oracle's Elixir 스타일 CSV 문자열 또는 row 배열
game id / match id
live window/details payload 또는 실시간 fetch 권한
patch version

Oracle's Elixir风格CSV字符串或行数组
game id / match id
实时窗口/详情 payload 或实时拉取权限
补丁版本

Team alias normalization

战队别名归一化

다음 이름들은 같은 canonical team 으로 인식한다.

```
DN SOOPers
```
```
DN FREECS
```
```
광동 프릭스
```
```
Afreeca Freecs
```

추가로

T1

SKT T1

담원

Dplus KIA

브리온

한화

젠지

피어엑스

등도 alias 정규화를 지원한다.

以下名称会被识别为同一标准战队：

```
DN SOOPers
```
```
DN FREECS
```
```
광동 프릭스
```
```
Afreeca Freecs
```

此外还支持

T1

、

SKT T1

、

담원

、

Dplus KIA

、

브리온

、

한화

、

젠지

、

피어엑스

等名称的别名归一化。

Official surfaces

官方数据源

이 스킬은 Riot 공식 / 공식 웹앱 표면을 우선 사용한다.

일정/결과:
```
getSchedule
```
토너먼트 목록:
```
getTournamentsForLeague
```
순위:
```
getStandings
```
이벤트 상세:
```
getEventDetails
```

라이브 window:

https://feed.lolesports.com/livestats/v1/window/{gameId}

라이브 details:

https://feed.lolesports.com/livestats/v1/details/{gameId}

historical 고급 분석은 Oracle's Elixir 스타일 데이터 입력을 사용한다.

本Skill优先使用Riot官方/官方WebApp接口：

赛程/结果：
```
getSchedule
```
赛事列表：
```
getTournamentsForLeague
```
排名：
```
getStandings
```
赛事详情：
```
getEventDetails
```

实时窗口：

https://feed.lolesports.com/livestats/v1/window/{gameId}

实时详情：

https://feed.lolesports.com/livestats/v1/details/{gameId}

历史高级分析使用Oracle's Elixir风格的数据输入。

Workflow

工作流程

Included lightweight local pipeline

内置轻量本地流水线

이 k-skill 팩에는 경량 로컬 파일 기반 파이프라인 스크립트가 포함된다.

```
scripts/sync-oracle.js
```
: Oracle-style CSV → historical cache JSON
```
scripts/build-match-report.js
```
: 날짜별 match analysis 생성
```
scripts/analyze-live-game.js
```
: game analysis 생성
기본 cache 위치:
```
.openclaw-lck-cache/
```

本k-skill包包含基于轻量本地文件的流水线脚本：

```
scripts/sync-oracle.js
```
: Oracle风格CSV → 历史缓存JSON
```
scripts/build-match-report.js
```
: 生成按日期划分的赛事分析
```
scripts/analyze-live-game.js
```
: 生成赛事分析
默认缓存位置：
```
.openclaw-lck-cache/
```

1. Basic scoreboard / standings query

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, "lck-analytics", "src", "index.js"),
).href;
const { getLckSummary } = await import(entry);

const summary = await getLckSummary("2026-04-01", {
  team: "한화",
  includeStandings: true,
});

console.log(JSON.stringify(summary, null, 2));
JS

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, "lck-analytics", "src", "index.js"),
).href;
const { getLckSummary } = await import(entry);

const summary = await getLckSummary("2026-04-01", {
  team: "한화",
  includeStandings: true,
});

console.log(JSON.stringify(summary, null, 2));
JS

2. Historical analytics from Oracle-style CSV

2. 基于Oracle风格CSV的历史分析

직접 API를 호출해도 되지만, local skill pipeline에서는 아래 스크립트 사용을 우선 권장한다.

bash

node ./lck-analytics/scripts/sync-oracle.js \
  --csv ./lck-analytics/samples/oracle-lck-sample.csv

也可以直接调用API，但本地Skill流水线优先推荐使用以下脚本：

bash

node ./lck-analytics/scripts/sync-oracle.js \
  --csv ./lck-analytics/samples/oracle-lck-sample.csv

3. Match analysis via local pipeline script

3. 通过本地流水线脚本生成赛事分析

bash

node ./lck-analytics/scripts/build-match-report.js \
  --date 2026-04-01

필요하면 팀 필터도 같이 준다.

bash

node ./lck-analytics/scripts/build-match-report.js \
  --date 2026-04-01 \
  --team 한화

bash

node ./lck-analytics/scripts/build-match-report.js \
  --date 2026-04-01

如有需要可以同时添加战队筛选：

bash

node ./lck-analytics/scripts/build-match-report.js \
  --date 2026-04-01 \
  --team 한화

4. Game analysis with turning points via local pipeline script

4. 通过本地流水线脚本生成包含转折点的赛事分析

bash

node ./lck-analytics/scripts/analyze-live-game.js \
  --game game-id

fixture 기반으로 분석할 때는

--window

--details

를 같이 줄 수 있다.

bash

node ./lck-analytics/scripts/analyze-live-game.js \
  --game game-id

基于固定数据做分析时，可以同时传入

--window

、

--details

参数。

Output guidelines

输出规范

사용자에게는 원본 JSON을 길게 그대로 던지지 말고 먼저 아래 순서로 정리한다.

不要直接给用户返回冗长的原始JSON，优先按以下顺序整理输出：

경기 결과 요청

赛事结果请求

경기 시각
팀1 vs 팀2
상태
세트 스코어
요청 팀 경기만 있으면 해당 경기 우선
standings 요청이 있으면 현재 순위 같이 표시

赛事时间
战队1 vs 战队2
赛事状态
局数比分
仅查询指定战队赛事时优先展示对应赛事
如有排名查询需求，同时展示当前排名

진행 중 경기 요청

进行中赛事请求

현재 게임 번호
킬 차이
골드 차이
드래곤/바론/타워 차이
turning point 1~3개

当前游戏局数
击杀差
经济差
小龙/大龙/防御塔差
1~3个转折点

historical / meta 요청

历史/版本生态请求

sample 수를 먼저 표시
팀 파워 레이팅은 상위 팀부터 정렬
champion matchup / synergy는 표본 수가 적으면 낮은 확신도로 표시
patch meta는 top picks / risers 위주로 짧게 요약

首先展示样本数量
战队战力评分按排名从高到低排序
英雄对位/协同效果样本量不足时标注低置信度
版本生态优先简短总结热门选择/上升趋势英雄

Done when

完成条件

날짜 기준 경기 요약이 있다
요청 팀 필터가 적용된다
standings 요청이면 현재 순위가 같이 정리된다
live 요청이면 현재 게임 요약과 turning point가 있다
historical 입력이 있으면 patch meta 또는 power rating까지 설명할 수 있다

有按日期整理的赛事摘要
已应用请求的战队筛选条件
排名查询场景已同步整理当前排名
实时赛事请求场景包含当前赛事摘要和转折点
有历史数据输入时可说明版本生态或战力评分

Failure modes

异常场景

Riot 웹앱 API 구조/헤더가 바뀌면 패키지 수정이 필요할 수 있다
```
LOLESPORTS_API_KEY
```
public fallback이 회전되면 환경변수 override가 필요할 수 있다
historical CSV 컬럼명이 너무 다르면 Oracle-style 정규화 전에 전처리가 필요할 수 있다

Riot WebApp API结构/请求头变更时需要修改包代码
```
LOLESPORTS_API_KEY
```
公共备用密钥轮换时需要覆盖环境变量
历史CSV列名差异过大时需要在Oracle风格归一化前做预处理

Notes

注意事项

이 스킬은 조회/분석 전용이다
사용자의 "오늘/어제" 요청은 항상 절대 날짜(
```
YYYY-MM-DD
```
)로 변환해서 실행한다
이 저장소에서
```
main
```
으로 머지되면 Changesets가 Version Packages PR을 만들고, 그 PR이 merge된 뒤 npm publish가 실행된다

本Skill仅用于查询与分析
用户的「今天/昨天」类请求需要先转换为绝对日期(
```
YYYY-MM-DD
```
)再执行
本仓库代码合并到
```
main
```
分支后，Changesets会生成版本更新PR，该PR合并后会自动执行npm发布