一组公开的 Claude Code 技能可以将一盘棋转化为带注释的 PGN 文件和 HTML 分析棋盘。作者还提供了生成配音视频的途径。Stockfish 负责评估局面；Claude Code 会追问问题并为棋手撰写说明。该代码库提供了一盘完整示例，以及支撑这一流程的脚本。BIG CHANGE 检查了截至提交版本46919038的文档和代码，该提交日期为 2026 年 9 月 26 日；我们没有运行此工作流程，也没有自行评估棋局建议。
主要变化
- 发生了什么变化：这个小型公开项目记录了一种工作流程：把棋类引擎对局面的检查与面向棋手本人棋局的说明相连接，并在提供笔记时纳入其记录的思考过程。
- 为何重要：棋手可以分别检查 PGN、引擎逐步分析结果、保存的查询着法和注释。这样一来，更容易针对说明涉及的局面提出质疑。本文没有测量它是否能帮助棋手进步。
- 接下来关注什么：模型仍负责选择问题、解读引擎分析线并撰写讲解。基于提示词的验证器会检查这些内容，但验证器的存在并不能证明结果准确。读者若要用这些输出辅助学习，应当复核其中引用的局面和着法。
从棋局记录中找出值得分析的失误
输入是一盘 PGN 棋局，可以直接提供，也可以从棋局链接获取。该chess-analysis技能首先会了解读者的棋力水平，以便针对该棋手撰写评论。还可以添加书面笔记。若要处理录制的边下边想过程，文档所述流程会在本地使用 whisper.cpp 转录音频，并借助 PGN 中的时钟注释将语音与着法对应起来。这种对应依赖可用的时钟数据，以及语音中对局面的提及能够匹配着法；仅凭 PGN 本身无法还原棋手的想法。
第一轮机械分析见于sweep.py。它会让 Stockfish 评估每一步棋前后的局面，记录候选着法和评分；若测得的损失达到脚本默认的 30 个厘兵值，就标记该步棋。文档所述默认搜索深度为 22。评估结果可以定位值得进一步检查的局面，但数字本身并不能解释失误。
随后，技能会指示 Claude Code 调查代理检查每个被标记的局面。其query.py技能可以要求 Stockfish 分析替代着法，包括限制搜索范围、只分析某一提议着法，并将结果着法线保存为 JSON。另有指令要求调查代理检查棋盘图像，并解释某一步棋或替代着法为何有效。只有与相应着法相关的棋手笔记才能用于说明。此时，引擎输出会转化为模型撰写的棋类文字讲解，判断和潜在错误也随之进入结果。
这些检查和输出能证明什么
代码库中的chess-analysis技能会要求另一个验证代理结合逐步分析结果和棋手笔记，复核最终注释。检查清单涵盖已标记的失误、合法变化、评估主张，以及关于棋手当时想法的陈述；评估相关主张应与逐步分析结果或保存的引擎查询一致。build_annotated.py脚本还会重新解析 PGN，并报告解析错误。这些属于不同检查：解析只能确认棋步可以读取；验证器则是由另一个模型主导的讲解复核。两者都不能证明每种解读都正确。作者称个人使用中错误很少，但没有提供独立的错误研究。
保存的带注释 PGN 和build_viewer.py会生成独立的 HTML 棋盘，其中包含注释、评估曲线和缓存的引擎着法线。另一个可选的chess-video技能会从带注释的 PGN 和逐步分析结果开始工作。它会要求 Claude Code 撰写分镜脚本，再由其脚本渲染棋盘、合成旁白，并生成带字幕的 MP4。代码库附有作者自己一盘快棋的示例，包含转录文本、分析结果、注释，以及一段 6 分 49 秒的视频。该示例展示了预期产物，并非对多位棋手或多盘棋局的效果测量。
前提条件、耗时和限制
该README建议将技能文件夹复制到 Claude Code 的个人或项目技能目录，然后提供棋局链接或 PGN。Claude Code 自身的文档确认了这些技能目录。分析需要安装 Python、python-chess以及cairosvg另外还需要 Stockfish 可执行文件。代码库的获取脚本会优先使用已有版本；若找不到，则下载适用于 Linux x86-64 的 Stockfish 17.1。Stockfish 当前下载页面列出的版本为 19，因此该项目的备用下载方案固定使用较旧版本。音频功能可选，需要 whisper.cpp 和模型；其文档介绍了如何将音频转换为 16 位 WAV，以供whisper-cli。视频阶段还需要 Pillow、Piper 文字转语音或 espeak，以及 FFmpeg。文档说明了这些路径和依赖；本文没有进行安装测试，也不保证在某一特定计算机上兼容。
作者估计，完整复盘并制作视频大约需要一小时。代码库没有提供该次运行的费用账单。Anthropic 当前的方案表将 Claude Code 列在 Pro 方案下，而不是免费方案；按月付费时，Pro 每月 20 美元，并有用量限制。本地计算时间、订阅或 API 用量，以及可选的转录和视频配置，都会使成本取决于读者的环境。示例所需时间和作者对准确性的看法，应视为单个用户的记录。
