Версия Markdown

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

# Шахматный навык для Claude Code соединяет анализ Stockfish с заметками игрока

> Открытый набор навыков для 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`, датированном 26 сентября 2026 года; мы не запускали процесс и сами не оценивали шахматные рекомендации.

## Главное изменение

- **Что изменилось:** этот небольшой открытый проект описывает процесс, который связывает проверки позиций шахматным движком с разбором собственной партии игрока и, если они предоставлены, с его записанными рассуждениями.
- **Почему это важно:** Игрок может отдельно изучить 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. Скрипт загрузки репозитория использует уже имеющуюся программу или скачивает сборку Stockfish 17.1 для Linux x86-64. На [актуальной странице загрузки Stockfish](https://stockfishchess.org/download/) указана версия 19, поэтому запасная загрузка в репозитории закреплена за более старым выпуском. Для необязательной обработки аудио нужны whisper.cpp и модель; в его [документации](https://github.com/ggml-org/whisper.cpp) описано преобразование аудио в WAV с глубиной 16 бит для `whisper-cli`. Для этапа видео также нужны Pillow, синтез речи Piper или espeak и FFmpeg. Эти способы и зависимости задокументированы; статья не является проверкой установки и не гарантирует совместимость с конкретным компьютером.

Автор оценивает обработку полного разбора и видео примерно в один час. В репозитории нет счёта за этот запуск. [В актуальной таблице тарифов Anthropic](https://claude.com/pricing) указан Claude Code в плане Pro, а не Free; помесячная оплата Pro стоит $20, при оплате за год — в пересчёте $17 в месяц. На стоимость влияют время работы локального компьютера, подписка или использование API, а также настройка необязательных средств транскрибирования и видео. Время выполнения в примере и оценку точности следует рассматривать как рассказ одного пользователя.

## Sources

- [brumar/chess-postmortem-skills, файл README в коммите 46919038](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — Рассказ автора о партии, входных данных, примерах результатов, установке, требованиях и обработке, занявшей около часа. Оценка ошибок и времени основана на личном опыте, а не на независимых измерениях.
- [Навык шахматного анализа и контрольный список проверяющего](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 и версии для разных платформ. Проверенный скрипт проекта для резервной загрузки закреплён за Stockfish 17.1 для Linux x86-64.
- [Официальный репозиторий whisper.cpp](https://github.com/ggml-org/whisper.cpp) — Описывает whisper-cli и преобразование входного аудио в WAV с глубиной 16 бит. Транскрибирование и привязка аудио к ходам — необязательные части проекта; здесь они не проверялись.
- [Тарифы Anthropic Claude](https://claude.com/pricing) — В таблице индивидуальных планов Claude Code указан в Pro, а не в Free; план Pro стоит $20 при помесячной оплате или в пересчёте $17 в месяц при оплате за год. Применяются лимиты использования и могут меняться цены; в проекте стоимость одного запуска не указана.