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`的文档和代码，该提交日期为 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。文档说明了这些路径和依赖；本文没有进行安装测试，也不保证在某一特定计算机上兼容。

作者估计，完整复盘并制作视频大约需要一小时。代码库没有提供该次运行的费用账单。[Anthropic 当前的方案表](https://claude.com/pricing)将 Claude Code 列在 Pro 方案下，而不是免费方案；按月付费时，Pro 每月 20 美元，并有用量限制。本地计算时间、订阅或 API 用量，以及可选的转录和视频配置，都会使成本取决于读者的环境。示例所需时间和作者对准确性的看法，应视为单个用户的记录。

## Sources

- [brumar/chess-postmortem-skills：提交版本 46919038 的 README](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 和各平台下载版本。检查的项目备用下载脚本固定使用 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 列在 Pro 而非免费方案下；按月付费为每月 20 美元，按年付费折合每月 17 美元。用量限制和价格可能变化；该棋类项目没有提供单次运行成本。