AI-translated from English; not yet reviewed by a fluent editor.

# Stockfishの解析とプレーヤーのメモを組み合わせるClaude Code用チェス分析スキル

> 公開されているClaude Code用スキル群が、Stockfishの評価、プレーヤーのメモ、モデル生成の解説を、検証可能な対局の振り返りにまとめる。その手順と限界を、公開コードとドキュメントに基づいて追う。

By BIG CHANGE Editorial

Published: 2026-09-26T20:57:48.171Z
Updated: 2026-09-26T20:57:48.171Z
Canonical: https://bigchange.ai/blog/claude-code-chess-stockfish-postmortem-skill

![A chess player studies a midgame position on a wooden chessboard beside an analog chess clock in a quiet club room.](https://bigchange.ai/api/media/file/chess-postmortem-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

公開されたClaude Code用スキル群は、チェスの対局を注釈付きPGNとHTML解析盤にまとめる。作者はナレーション付き動画の作成手順も提供している。Stockfishが局面を評価し、Claude Codeは追加質問をしてプレーヤー向けの解説を書く。この[リポジトリ](https://github.com/brumar/chess-postmortem-skills)には、一連の手順を示す対局例と、それを支えるスクリプトが含まれる。BIG CHANGEが確認したのはコミット`46919038`で、日付は2026年9月26日。ワークフローは実行せず、チェスの助言自体も独自には評価していない。

## 大きな変化

- **何が変わったか：**この小規模な公開プロジェクトは、エンジンによる局面チェックを、プレーヤー自身の対局や（提供されている場合は）記録された思考過程に沿った解説につなぐワークフローを紹介している。
- **なぜ重要か：**プレーヤーはPGN、エンジンによる全局面の走査、保存された問い合わせ行、注釈を個別に確認できる。そのため、生成された解説を該当局面に照らして問い直しやすい。上達に役立つかどうかは、ここでは測定されていない。
- **注目点：**質問の選択、エンジンの変化の解釈、レッスンの執筆は、引き続きモデルが担う。プロンプトに基づく検証役はその内容を確認するが、検証役がいること自体は正確さの証明にならない。学習に使うか判断する読者は、引用された局面と指し手の変化を自分で確かめたい。

## 対局記録から候補となるミスへ

入力は、直接渡すか対局リンクから取得するPGN形式の棋譜だ。この`chess-analysis`スキルはまず読者の棋力を設定し、その人に合ったコメントを付ける。文章のメモも追加できる。考えを声に出して記録した音声を使う場合、文書化された手順ではローカルのwhisper.cppで文字起こしし、PGNの時計コメントを使って発言と指し手を対応付ける。この対応付けには利用可能な時計データと、発言内の指し手への言及を特定できることが必要だ。PGNだけからプレーヤーの思考を復元する方法ではない。

最初の機械的な処理は[`sweep.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/sweep.py)で確認できる。このスクリプトは各指し手の前後の局面をStockfishで評価し、候補手とスコアを記録する。損失が既定値の30センチポーンに達した指し手にはフラグを立てる。文書に記載された既定の探索深さは22だ。これらの評価は詳しく調べる局面を特定するもので、数値だけでミスの理由を説明するわけではない。

次にこのスキルは、Claude Code上の調査エージェントにフラグの付いた局面を一つずつ検討させる。その[`query.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/query.py)はStockfishに別の指し手を尋ねることができ、候補手を指定した限定探索にも対応し、得られた手順をJSONに保存する。別の指示では、調査役に盤面画像を確認させ、ある手や代案が有効な理由を説明させる。プレーヤーのメモは、その手に対応する場合に限り解説に反映できる。ここでエンジン出力がモデル執筆のチェス解説に変わり、判断が入り、誤りが生じる可能性も加わる。

## チェックと出力から何が分かるか

リポジトリの`chess-analysis`スキルでは、別の検証エージェントが、全注釈をエンジン走査とプレーヤーのメモに照らして確認する。チェックリストは、フラグが立ったミス、合法な変化、評価に関する主張、プレーヤーの思考についての記述を対象とし、評価の主張は走査結果または保存済みのエンジン問い合わせと一致させる。[`build_annotated.py`スクリプトも](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py)PGNを再解析して構文解析エラーを報告する。これらは別々のチェックだ。構文解析で確認できるのは指し手を読み取れること、検証役が行うのはモデルの指示に沿った説明の再点検である。どちらも、すべての解釈が正しいとは証明しない。作者は個人利用での誤りはまれだと述べているが、独立した誤り率の調査は示していない。

保存された注釈付きPGNと[`build_viewer.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_viewer.py)から、コメント、評価グラフ、キャッシュ済みエンジンの変化を含む単独動作のHTML盤面を生成する。後から任意で使える[`chess-video`スキル](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md)は注釈付きPGNと走査結果から始める。Claude Codeにストーリーボードを書かせた後、スクリプトで盤面を描画し、ナレーションを合成して字幕付きMP4を作る。リポジトリには作者自身の早指し対局を使った6分49秒の動画例があり、文字起こし、走査結果、注釈も含まれている。この例が示すのは想定される成果物であり、複数のプレーヤーや対局で測定した結果ではない。

## 前提条件、所要時間、制約

この[README](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md)には、スキル用フォルダーをClaude Codeの個人用またはプロジェクト用ディレクトリにコピーし、対局リンクかPGNを渡す手順がある。[Claude Code公式ドキュメント](https://code.claude.com/docs/en/skills)もそれらの保存先を確認している。分析にはPythonと`python-chess`および`cairosvg`に加えてStockfish実行ファイルが必要だ。リポジトリの取得スクリプトは、既存の実行ファイルがあればそれを使い、なければLinux x86-64向けStockfish 17.1をダウンロードする。[Stockfish公式ダウンロードページ](https://stockfishchess.org/download/)では現行版としてバージョン19を掲載しているため、リポジトリの代替ダウンロードは旧版に固定されている。音声を使う場合はwhisper.cppとモデルが必要で、その[ドキュメント](https://github.com/ggml-org/whisper.cpp)には音声を16ビットWAVに変換して`whisper-cli`に渡す手順がある。動画工程にはPillow、Piperまたはespeakによる音声合成、FFmpegも必要だ。これらの手順と依存関係は文書化されているが、この記事はインストールテストでも、特定のマシンでの互換性保証でもない。

作者はレビューから動画作成まで約1時間の処理時間を見積もっているが、リポジトリには実行1回分の料金は記載されていない。[Anthropicの現行プラン表](https://claude.com/pricing)ではClaude CodeをFreeではなくProに分類している。月払いの場合、Proは月額20ドルで、利用上限がある。ローカル計算時間、サブスクリプションやAPIの利用、任意の文字起こし・動画環境によって費用は読者の環境ごとに変わる。例の所要時間と作者による精度の評価は、あくまで一人の利用者の報告として読む必要がある。

## Sources

- [brumar/chess-postmortem-skills、コミット46919038時点のREADME](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — 作者による対局、入力、出力例、インストール、前提条件、約1時間という処理時間の説明。誤りに関する個人的な評価と所要時間は、独立した測定ではない。
- [チェス分析スキルと検証チェックリスト](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/SKILL.md) — PGN、任意のメモや音声入力、Stockfishによる走査、調査担当の問い合わせ、注釈生成、モデル指示による検証、HTML出力を説明する。検証役のチェックリストはリンク先のreferences/style.mdにある。文書化された指示だけでは毎回の確認が正しいとは証明できない。
- [チェス分析スクリプト：走査、問い合わせ、注釈生成、ビューアー](https://github.com/brumar/chess-postmortem-skills/tree/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts) — コードから、既定の探索深さと損失しきい値、手を限定したStockfishへの問い合わせと保存される変化、PGNの再解析、HTMLへのまとめ方を確認できる。コードの確認だけでは、実行テストにも品質評価にもならない。
- [チェス動画スキルとレンダリング用スクリプト](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) — 任意のストーリーボード、ナレーション、MP4、字幕、HTML工程と、動画固有の前提条件を説明する。BIG CHANGEは動画を生成していない。
- [Claude Code公式ドキュメント：スキル](https://code.claude.com/docs/en/skills) — 個人用およびプロジェクト用スキルディレクトリの場所を確認できる。第三者のこのプロジェクトが異なるバージョン間で互換性を保つとは検証していない。
- [Stockfish公式ダウンロード](https://stockfishchess.org/download/) — Stockfish 19と各プラットフォーム向けダウンロードを掲載する。調査したプロジェクトの代替取得スクリプトはLinux x86-64版Stockfish 17.1に固定されている。
- [whisper.cpp公式リポジトリ](https://github.com/ggml-org/whisper.cpp) — whisper-cliと入力音声を16ビットWAVに変換する手順を記載する。文字起こしと音声・指し手の対応付けはプロジェクト内の任意工程であり、ここではテストしていない。
- [AnthropicのClaude料金](https://claude.com/pricing) — 個人向けプラン表ではClaude CodeはFreeではなくProに含まれ、料金は月払いで月額20ドル、年払いで月額換算17ドルとされている。利用上限や価格改定があり、チェスプロジェクトの実行ごとの費用は示されていない。