ushinotan/rift-log / .claude/skills/lol-review
lol-review
VerifiedLeague 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 | 自分と対面のスタッツと差(自分 − 対面) |
laningDiffs | 5/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 で詳細が見られることを一言添える。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |