Skip to content

ushinotan/rift-log / .claude/skills/lol-review

lol-review

Verified

League of Legends のランク戦(牛乃タン#SION, JP)を Riot API から取り込み、試合ごとの振り返り(良かった点・改善点・次の目標)をデータに基づいて書いて DB に保存する。「ランク戦を振り返って」「試合を取り込んで」「振り返りを書いて」と言われたときに使う。

ランク戦の振り返り

このリポジトリ(rift-log)のルートで作業する。コマンドは 必ず npm run -s(-s で npm のヘッダー行を抑え、JSON だけを出力させる)。

手順

1. 新しい試合を取り込む

npm run -s sync
  • 標準出力に新しく取り込んだ matchId が1行ずつ出る(進捗は標準エラー)。
  • 「API キーが無効か期限切れ」と出たら、そこで止めてユーザーに伝える: 開発キーは24時間で失効するので https://developer.riotgames.com/ で再発行し、.env の RIOT_API_KEY を書き換えてもらう。キーを自分で入力・推測しない。
  • 「試合を取り込んで」だけを頼まれた場合は、取り込み結果を報告して終わる(振り返りは書かない)。

2. 振り返り待ちの試合を確認

npm run -s pending

振り返りがまだない試合の matchId が古い順に出る。0件なら「振り返り待ちの試合はありません」と報告して終わる。 古い順に1試合ずつ 3〜4 を繰り返す(前の試合の振り返りが、次の試合の recentHistory に反映されるため)。

3. 試合データを読む

npm run -s match -- <matchId>

主なフィールド:

フィールド内容
summary日時・結果・試合時間・チャンピオン・ロール・対面・パッチ
me / opponent / diffVsOpponent自分と対面のスタッツと差(自分 − 対面)
laningDiffs5/10/15/20分時点の対面とのゴールド差・CS差、チームのゴールド差
myDeaths自分のデス(時刻・倒した相手・アシスト)
objectives味方/敵のタワー・ドラゴン・ヴォイドグラブ・ヘラルド・バロン数、ファーストブラッド/タワー/ドラゴン
objectiveTimeline / killTimeline時系列イベント(me に自分の関与:キル/デス/アシスト/ラストヒット)
build / skillOrderアイテムの購入・売却順、スキル順
recentHistoryこの試合より前の直近5試合(スタッツ・オブジェクト・その試合の改善点と目標)
existingReviewItemsこれまでに使った「項目」名の一覧

4. 振り返りを書く

次の JSON を作る。

{
  "良かった点": [{ "項目": "短い見出し", "詳細": "データを引用した説明" }],
  "改善点":     [{ "項目": "短い見出し", "詳細": "データを引用した説明" }],
  "次の目標":   [{ "項目": "短い見出し", "詳細": "具体的で測れる目標" }]
}
  • 良かった点 3〜5個、改善点 3〜5個、次の目標 1個。すべて日本語。
  • 数字は必ずデータから引用する(例:「CSは対面に65差で勝ち(245 vs 180)」「10分時点でゴールド +820」「14:32 にリヴェン・リー・シンに倒された」)。データにない数字を作らない。
  • データから断定できない推測(意図・判断の理由・見えていなかった情報など)には文末に 「(推定)」 を付ける。
  • 項目は短く、表記を揃える。existingReviewItems に同じ意味の項目があればその文言をそのまま使う(傾向画面で回数を集計するため)。例:「ヴォイドグラブを取られた」「中盤のデス」「視界確保」「CS」。
  • recentHistory を見て、同じ改善点が続いていたら必ず指摘する。例:「ヴォイドグラブを3試合連続で取られている(0-3, 0-6, 1-5)」。前回の「次の目標」を達成できたかにも触れる。
  • 次の目標は1試合で確認できる具体的なもの(例:「15分までのデスを0にする」「CS/分 7.5 以上」)。
  • チャンピオン・アイテム・ルーン・スペル名は match の出力にある日本語名をそのまま使う(英語名や独自の表記にしない)。

JSON はスクラッチ用の一時ファイル(リポジトリの外、または data/ 配下)に UTF-8 で書く。

5. 保存する

npm run -s review:add -- <matchId> <JSONファイル>

同じ試合の振り返りは上書きされる。件数の注意が出たら直して保存し直す。

6. チャットで報告

試合ごとに短く:日時・チャンピオン vs 対面・結果・KDA、良かった点と改善点の見出し(各1行)、次の目標。 連続している改善点があれば強調する。最後に npm run dev → http://localhost:5173 で詳細が見られることを一言添える。

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall