book-to-skill 是一种把书籍资料转化为 AI Skill 的工作方式先拆解一本书里的知识结构提取出可执行的规则、流程和模板再把这些内容打包成让 AI 编程工具可以直接调用的 Skill。它的价值在游戏开发场景里特别明显因为游戏开发涉及引擎配置、场景组织、脚本结构、资源管理和调试方法光靠聊天式问答很难让 AI 稳定产出符合规范的项目代码。下面以“把一本游戏开发入门资料蒸馏成一个 Pygame 游戏开发 Skill再用它开发一个‘接苹果’小游戏”为例完整走一遍选材、拆解、打包、调用、验证和排错的过程。即使你手头没有现成的电子书也可以沿用这套流程处理官方文档、技术手册、课程笔记和其他知识库。读完你可以得到一个能直接使用的最小 Skill也知道如何把它扩展成适合自己团队的游戏开发规范。1. 先理解 book-to-skill 和 Skill 的工作方式1.1 Skill 不是提示词而是可复用的“工作包”很多人第一次接触 Skill 时会把它理解成一段更长的提示词。这个理解不准确。提示词是一次性的指令它只影响当前这一轮对话Skill 则是一个独立的目录里面可以包含主说明文件、参考资料、代码模板和可执行脚本AI 编程工具在任务开始时扫描这些目录并根据任务语义自动选择是否加载。在常见的 AI 编程工具中Skill 通常表现为一个子目录目录内包含一份SKILL.md主文件以及若干辅助文件。例如skills/ pygame-game-dev/ SKILL.md references/ project-structure.md common-errors.md templates/ main.py.tpl scripts/ run.sh当用户提出“开发一个 Pygame 游戏”时工具会识别到pygame-game-dev这个 Skill 的适用范围然后让模型按照SKILL.md中的流程和规则完成任务。相比普通提示词Skill 的优势是稳定规则被固化在文件里不依赖用户每次重复描述也不容易在长对话中丢失。1.2 蒸馏一本书的核心是提取“决策规则”book-to-skill 里的“蒸馏”不是做摘要更不是把整本书的 Markdown 文本丢进同一个文件夹。图书和手册最大的价值是告诉读者“在什么条件下应该做什么决定”。这些决定可以是算法选择、代码结构、错误处理方式、性能优化策略也可以是发布前的检查项。举个例子一本 Pygame 入门书可能用一整章解释“为什么游戏运行需要主循环”。真正能被 Skill 复用的部分不是那段长篇原理而是这条规则在游戏运行期间每一帧都要按“事件处理 - 更新状态 - 绘制画面 - 控制帧率”的顺序执行。把这句规则写进SKILL.md后模型生成代码时就会自动遵守。即使以后换一个游戏需求只要 Skill 被正确加载这个结构就不会丢。相比之下整段复制书里的概念解释反而会稀释指令让模型把注意力放在无关的段落上。1.3 游戏开发场景为什么特别适合这种思路游戏开发是一个“模式固定但细节繁多”的领域。几乎所有小游戏都需要窗口初始化、主循环、事件处理、碰撞检测、资源加载和计分逻辑这些模式非常适合固化成规则。但当具体需求变化时游戏类型、控制方式、碰撞粒度、资源格式又会带来大量分支。这种组合恰恰是 Skill 最擅长的场景基础规范由 Skill 保证具体逻辑由用户和模型通过对话补充。如果团队里已经有一本内部项目规范或常用开发手册把它蒸馏成 Skill 后新成员可以让 AI 在生成代码时自动遵守这些规范。省去的不仅是写提示词的时间还有反复纠正生成结果的时间。2. 搭建运行环境Skill 宿主、Python 和 Pygame2.1 确认 Skill 宿主工具的目录规则不同的 AI 编程工具对 Skill 目录的查找规则并不完全一样。有的工具要求把 Skill 放在用户级目录让所有项目都能使用有的工具支持项目级目录让 Skill 和项目代码放在同一个仓库里。落地前先确认自己正在使用的工具版本和文档说明。常见的位置包括# 用户级目录示例 ~/.claude/skills/ # 项目级目录示例 .your-tool/skills/如果工具的界面里没有直接显示 Skill 路径可以找一个“查看当前会话使用了哪些 Skill”的入口。有的工具支持/skills命令或者在会话信息里展示加载情况。确认路径后再创建目录不然 Skill 文件写好了也不会被扫描到。2.2 准备 Python 和 Pygame 环境本文的示例游戏使用 Python 和 Pygame 实现原因是环境简单、代码量少、适合作为 Skill 的最小验证对象。建议使用 Python 3.10 及以上版本Pygame 使用 2.5 或以上版本。命令如下python3 --version pip --version python3 -m venv .venv source .venv/bin/activate pip install pygame2.5.2Windows 环境下虚拟环境激活命令略有不同平台激活命令macOS / Linuxsource .venv/bin/activateWindows PowerShell.venv\Scripts\Activate.ps1Windows CMD.venv\Scripts\activate.bat激活虚拟环境后再执行pip install pygame。如果不使用虚拟环境也可以直接安装但推荐在项目目录中创建虚拟环境避免多个项目之间的依赖版本互相干扰。2.3 初始化项目目录建议把 Skill 目录和游戏项目目录分开避免把 Skill 的维护代码和游戏运行代码混在一起。目录结构如下book-to-skill-demo/ skills/ pygame-game-dev/ SKILL.md references/ templates/ game/ main.py requirements.txt docs/ prompt-examples.mdskills目录用来放置蒸馏出的 Skillgame目录是 AI 生成游戏代码的工作区docs目录用来记录提示词和验证结果。这样分工明确Skill 是“知识资产”游戏代码是“生产产物”。3. 从一本书蒸馏成 Skill完整操作过程3.1 第一步拆解资料确定 Skill 的边界假设手头有一本约 200 页的 Pygame 游戏开发入门资料里面包含环境搭建、窗口与事件、精灵与碰撞、资源加载、场景管理、打包发布等章节。不要试图把所有章节都塞进一个 Skill第一版只抽取“写一个小游戏必需的最小知识集”。对这个示例最小知识集可以确定为四块游戏项目结构入口文件、配置文件、资源目录怎么摆放。主循环结构初始化、事件、更新、绘制、帧率控制。精灵与碰撞使用矩形碰撞避免对象越界。运行验证启动命令、依赖文件、常见报错。边界越窄Skill 越容易验证。等第一版跑通后再逐步扩展“场景管理”“音效播放”“打包发布”等子 Skill。3.2 第二步设计 Skill 目录与文件在skills/pygame-game-dev下创建skills/ pygame-game-dev/ SKILL.md references/ project-structure.md common-errors.md templates/ main.py.tplSKILL.md是主文件决定 Skill 何时被触发、按什么流程执行。references放补充规则templates放可复用的代码模板。文件数量不需要多关键是每个文件都要有明确用途。如果某个文件没有在SKILL.md中被引用就说明它还没有被纳入实际工作流。3.3 第三步编写 SKILL.md 主文件SKILL.md采用 Markdown 格式开头包含 YAML 格式的元信息。name是这个 Skill 的唯一标识description决定 AI 是否在合适的任务中调用它。--- name: pygame-game-dev description: 当用户需要开发或修改 Pygame 小游戏时使用。适合创建游戏窗口、事件循环、精灵、碰撞检测、资源加载和基础运行检查。 --- # Pygame 游戏开发 Skill ## 工作流程 1. 确认需求游戏类型、窗口尺寸、控制方式、计分规则、资源文件。 2. 检查环境Python 版本、pygame 是否安装、当前项目路径。 3. 创建项目结构。 4. 实现主循环。 5. 补充资源加载、碰撞检测和异常处理。 6. 运行并验证。 ## 强制规则 - 游戏必须有主循环每帧顺序为事件处理 - 更新状态 - 绘制 - 控制帧率。 - 资源路径使用相对于项目根目录的路径不要使用绝对路径。 - 图片或音频加载失败时打印错误并跳过不能让游戏崩溃。 - 坐标系统以窗口左上角为原点向下为 y 轴正方向。 - 对象移动后要检查窗口边界防止角色或物体移出可视区域。 - 发布前检查 requirements.txt 是否存在、资源文件是否完整。这里的关键是“强制规则”部分。不要写“尽量”“通常”这类模糊表达否则模型在生成代码时会自由发挥。规则要写成可判断的陈述句。3.4 第四步补充参考资料和模板references/project-structure.md定义推荐的目录结构game/ main.py settings.py assets/ images/ sounds/ requirements.txtreferences/common-errors.md记录常见的报错和处理方式这样 Skill 被加载后模型在遇到同类错误时可以直接给出修复建议而不是现查资料报错信息常见原因处理方式pygame.error: video system not initialized未调用pygame.init()在创建窗口前调用pygame.init()ModuleNotFoundError: No module named pygame未安装 pygame 或未激活虚拟环境激活虚拟环境后执行pip install pygamepygame.error: Couldnt open file资源路径错误或文件不存在检查相对路径和资源文件完整性templates/main.py.tpl给出一份最小可运行模板模型生成代码时可以参考import pygame import sys WIDTH 800 HEIGHT 600 FPS 60 BG_COLOR (20, 20, 40) def main(): pygame.init() screen pygame.display.set_mode((WIDTH, HEIGHT)) pygame.display.set_caption(Game) clock pygame.time.Clock() running True while running: for event in pygame.event.get(): if event.type pygame.QUIT: running False # 更新游戏状态 screen.fill(BG_COLOR) # 绘制游戏对象 pygame.display.flip() clock.tick(FPS) pygame.quit() sys.exit(0) if __name__ __main__: main()模板不需要很复杂它的作用是确保生成代码至少拥有正确的骨架。具体游戏逻辑由后续对话补充。3.5 第五步在项目中接入 Skill 并验证将skills目录放到工具扫描的位置后重新打开一个 AI 编程会话并输入一个明确任务使用 pygame-game-dev Skill 开发一个接苹果游戏。如果 Skill 成功加载AI 应该先按照SKILL.md里的工作流程要求你补充窗口尺寸、控制方式、计分规则等信息或者直接按默认规格生成项目结构。如果 AI 完全没有提到 Skill也没有按 Skill 中的规则输出就要回到第 2.1 节检查目录路径和description是否写清楚了触发条件。注意Skill 是否生效不能只看生成代码能不能运行还要观察模型是否遵循了主循环顺序、资源路径规则和错误处理规则。4. 用蒸馏出的 Skill 开发一个“接苹果”小游戏4.1 给 AI 下达明确的游戏需求将需求描述得越具体生成结果越接近预期。下面是一个可直接使用的需求描述使用 pygame-game-dev Skill 开发一个接苹果游戏。 需求 1. 窗口大小 800x600。 2. 玩家角色在窗口底部使用键盘左右键移动。 3. 苹果从窗口顶部随机位置下落。 4. 玩家接到苹果加 10 分苹果落到底部则游戏结束。 5. 没有图片资源时用色块代替角色和苹果。 6. 运行入口是 game/main.py。如果 AI 输出的代码结构不符合 Skill 中“主循环顺序”的规则可以补充一句请严格按照 Skill 中的主循环顺序事件处理 - 更新状态 - 绘制 - 控制帧率。4.2 理解 AI 生成的核心代码结构结合 Skill 的规则AI 通常会生成类似下面的代码。这个版本使用色块代替图片保证在无资源环境下也能运行import random import sys import pygame WIDTH 800 HEIGHT 600 FPS 60 PLAYER_WIDTH 80 PLAYER_HEIGHT 20 APPLE_SIZE 20 PLAYER_SPEED 8 BG_COLOR (20, 20, 40) PLAYER_COLOR (100, 200, 100) APPLE_COLOR (220, 80, 80) def main(): pygame.init() screen pygame.display.set_mode((WIDTH, HEIGHT)) pygame.display.set_caption(Catch Apple) clock pygame.time.Clock() player_x WIDTH // 2 - PLAYER_WIDTH // 2 player_y HEIGHT - PLAYER_HEIGHT - 20 apple_x random.randint(0, WIDTH - APPLE_SIZE) apple_y 0 apple_speed 5 score 0 font pygame.font.Font(None, 36) running True while running: for event in pygame.event.get(): if event.type pygame.QUIT: running False keys pygame.key.get_pressed() if keys[pygame.K_LEFT]: player_x - PLAYER_SPEED if keys[pygame.K_RIGHT]: player_x PLAYER_SPEED player_x max(0, min(WIDTH - PLAYER_WIDTH, player_x)) apple_y apple_speed if apple_y HEIGHT: print(Game Over, score:, score) running False player_rect pygame.Rect(player_x, player_y, PLAYER_WIDTH, PLAYER_HEIGHT) apple_rect pygame.Rect(apple_x, apple_y, APPLE_SIZE, APPLE_SIZE) if player_rect.colliderect(apple_rect): score 10 apple_x random.randint(0, WIDTH - APPLE_SIZE) apple_y 0 apple_speed min(20, apple_speed 1) screen.fill(BG_COLOR) pygame.draw.rect(screen, PLAYER_COLOR, player_rect) pygame.draw.rect(screen, APPLE_COLOR, apple_rect) screen.blit(font.render(fScore: {score}, True, (255, 255, 255)), (10, 10)) pygame.display.flip() clock.tick(FPS) pygame.quit() sys.exit(0) if __name__ __main__: main()这段代码的骨架和模板里“主循环”的结构保持一致。注意三个关键点pygame.key.get_pressed()用于读取持续按下的方向键适合平滑移动。pygame.Rect.colliderect()做矩形碰撞检测在“接苹果”这类小游戏中足够精确。clock.tick(FPS)控制帧率避免游戏在不同电脑上运行速度差异过大。4.3 运行游戏并验证输入输出把上面的代码保存到game/main.py然后运行cd book-to-skill-demo/game python main.py预期结果弹出一个 800x600 的窗口标题为Catch Apple。窗口底部有一个绿色色块窗口顶部出现一个红色色块。按键盘左右键绿色色块可以在底部移动。当红色色块与绿色色块接触时计分增加红色色块回到顶部重新下落。当红色色块落到底部时控制台输出Game Over, score: xxx窗口关闭。验证完成后回到 AI 会话观察这次开发过程中模型是否严格遵守了 Skill 里的规则。这是检查 Skill 质量最直接的方法。5. 常见问题和排查路径Skill 不生效怎么办5.1 Skill 没有被调用的四种原因现象是 AI 生成代码时完全没有参考 Skill 中定义的规则例如没有主循环、资源路径混乱、没有错误处理。可能原因通常是下面四种原因检查方式处理建议description写得太泛没有触发词查看 Skill 元信息里的description把“当用户需要开发或修改 Pygame 小游戏时使用”写清楚Skill 目录不在工具扫描范围内确认技能目录路径和工具要求一致按工具文档调整目录位置SKILL.md的 YAML 格式有误检查---是否配对、缩进是否一致修正元信息格式后重新加载工具版本不支持 Skill 机制查看工具更新日志和当前版本升级到支持 Skill 的版本或先使用长提示词过渡如果工具支持查看当前会话加载了哪些 Skill直接查看加载结果是最快的定位方式。5.2 生成结果与书不一致的排查思路Skill 加载成功但生成代码的风格和资料里的示例明显不同。这个问题通常不是“AI 不听话”而是 Skill 里没有把“书中的代码风格”转成可执行规则。例如书里习惯把全局配置集中在一个settings.py中Skill 就必须在规则中写明- 所有常量、配置项统一放在 settings.py 中main.py 不写业务常量。再如在书中碰撞检测统一使用矩形碰撞Skill 就应写明- 默认使用 Rect 的 colliderect 进行碰撞检测不引入像素级检测。排查顺序是先看 Skill 有没有覆盖这个决策点再看规则是否足够具体。如果规则是“按书中风格编写”那等于没写。必须把风格拆成“常量放哪里”“函数命名方式”“注释语言”等可判断的条目。5.3 Pygame 运行报错速查表报错信息常见原因处理建议ModuleNotFoundError: No module named pygame虚拟环境未激活或 pygame 未安装执行source .venv/bin/activate后重新安装pygame.error: video system not initialized创建窗口前没有调用pygame.init()在set_mode前增加pygame.init()pygame.error: Couldnt open file图片或音频路径错误确认资源文件位于assets目录使用相对路径窗口一闪而过主循环没有正确运行检查while running循环和pygame.display.flip()键盘按键无响应事件循环被阻塞检查事件处理代码是否放在主循环内且没有time.sleep阻塞这些常见错误可以提前写到 Skill 的references/common-errors.md中。这样后续再遇到同类问题时AI 可以直接根据 Skill 给出修复方案。5.4 更新 Skill 后不生效修改了SKILL.md但 AI 仍然使用旧规则通常是两个原因缓存或会话状态。先关闭当前 AI 会话并重新打开再发起测试任务如果仍然不生效检查是否项目里存在同名 Skill 并且旧版本被优先加载。多个目录下出现同名 Skill 时工具一般按特定优先级选择建议只保留一个。注意更新 Skill 后不要只看一次生成结果至少用三个不同需求做回归测试再确认修改是否真正生效。6. 把 book-to-skill 应用到真实游戏项目的最佳实践6.1 按“开发环节”拆分 Skill而不是按“书籍章节”合并一本书往往包含环境搭建、角色控制、UI、音效、打包等多个模块。把整本书的内容合并成一个 Skill会让加载负担变大规则之间还可能互相冲突。更合理的做法是拆成多个小 Skillpygame-project-init负责创建项目结构、初始化环境。pygame-player-control负责角色移动、碰撞、边界处理。pygame-resource-loading负责图片和音频加载、路径校验。pygame-build-check负责发布前的依赖和资源检查。每个 Skill 只解决一个环节模型在任务开始时只需要加载与当前需求相关的部分规则更清晰生成结果也更稳定。6.2 学习环境可以“快速跑通”生产环境还要补齐工程保障如果只是学习或参加活动上面的最小 Skill 已经足够。但在真实项目中还需要额外考虑把 Skill 目录纳入 Git 版本管理记录每次规则变更。在SKILL.md中增加版本号字段方便回溯。为游戏代码补充日志特别是资源加载失败和异常分支。增加自动化测试验证核心函数的行为。明确 AI 生成代码的审查人不能直接把未审阅代码发布。学习环境的目标是验证 Skill 是否生效生产环境的目标是让 Skill 成为团队开发基线的可重复执行部分。6.3 记录 Skill 的版本和验证结果在SKILL.md里增加版本号并把每次验证结果写进单独的CHANGELOG.md# Changelog ## [0.2.0] - 2025-01-20 - 增加 common-errors.md 引用。 - 明确碰撞检测使用 Rect.colliderect。 ## [0.1.0] - 2025-01-10 - 首次发布支持基础 Pygame 小游戏开发。有了版本记录Skill 出现问题时可以快速对比哪些规则发生了变化。6.4 book-to-skill 蒸馏检查清单每次制作或更新 Skill 时建议对照以下清单检查是否明确了 Skill 的触发场景。是否包含“输入 - 处理 - 输出”的完整流程。是否写出强制规则和禁止事项。是否提供参考文档和代码模板。是否包含运行验证命令和常见错误表。是否避免大段复制原文只保留决策规则和示例片段。是否在小规模任务上完成至少三次验证。是否记录了版本号和变更历史。最后一点特别重要一个 Skill 的完成标志不是文件写得多工整而是 AI 在无人干预的情况下稳定产出符合预期的结果。从这个角度看book-to-skill 的本质是把人的经验整理成机器可执行的工作协议。游戏开发只是其中一个很好的应用场景同样的流程也适用于后端开发规范、前端组件设计、数据库建模和运维排查手册。下一步可以从你手头最常查的那份资料开始先抽一个章节做成 Skill跑通之后再扩展成整套规范。