安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install novel-game-analyze
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 novel-game-analyze。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Novel Game Analyze 是 Openclaw Skills 工作流，可从小说中提取游戏改编所需的事实基础。它会识别世界规则、玩家行动的可能性、空间、角色目标、系统、文化背景和视觉锚点，同时保留文本证据，并区分事实、推论与尚待解决的设计问题。
此技能旨在支持可靠的后续设计，而非评判文笔或凭空创造游戏机制。它会生成 analysis/SOURCE_BIBLE.md，追踪来源覆盖范围与改编边界，并保留原文引文。如果已有项目或完整解构资料，则会复用这些成果，并针对缺失证据查阅原文，避免不必要地重复完整分析。

应用场景

将完整小说分析为游戏改编的源材料。
将现有写作项目或完整解构资料库转化为结构化、证据充分的 SOURCE_BIBLE。
在进入概念设计前，确认现有源材料是否覆盖全书。
为后续设计师提取玩家可执行动作、角色目标、世界响应、空间可能性和视觉参考。
记录改编边界、文化背景、术语、风险和尚未解决的设计空间。
选定改编片段后重新核查，并附上逐项事实证据表。

工作原理

确定范围：识别来源版本、覆盖范围、授权边界，以及是否存在 PRODUCT_BRIEF.md。依据简报中已锁定的优先事项与身份决策指导证据收集。
选择合适的输入路径：尽可能复用写作项目或完整解构资料，并查阅原文核实关键证据。仅有原始小说时，运行全书工作流。除非用户明确限定改编范围，否则局部预览不能证明已理解全书。
逐单元提取证据：遵循 references/gameability-protocol.md 规范。保留会影响玩家行动、世界响应或视听识别度的细节，并记录硬性规则、关键目标、身份证据、转折、结局和标志性锚点的来源位置。
追踪覆盖并汇总：完成覆盖检查关卡，并分层综合证据。只有在使用相同提取规范时，才可并行处理互不重叠的章节批次；汇总和事实核查仍须依序进行。若无法并行，则依序处理各批次，不得抽样。
重新核查来源：确认覆盖范围与来源单元集合一致，保留原文引文，标明推论与开放设计空间，并记录开篇、中段、结尾及相互关联章节中的反例和变化。
压缩并交付：将简洁、以证据为依据的交接文档写入 analysis/SOURCE_BIBLE.md。概念选定改编片段后，重新查阅来源并附上所需的片段级事实表。

配置指南

将此技能放入支持 Openclaw Skills 的 AI 编码代理环境，并向代理提供小说、写作项目或解构资料。
请求全书分析时，提供完整来源。如果任务有意限定于某一卷或节选，请明确说明范围。
如有 PRODUCT_BRIEF.md，请一并提供；它会设定输出语言，也可规定优先事项或锁定游戏身份。否则，技能将遵循对话语言，而不会默认使用中文。
确保技能引用的规范文件 references/gameability-protocol.md 可用；SKILL.md 要求工作流遵循该文件。
提出分析请求，并在将圣经文档用于概念设计前，检查生成的覆盖范围与证据。
提供的 SKILL.md 未指定 shell 安装命令或包管理器流程。此技能的主要交付物是 Markdown 文件，而非软件构建产物。

预期的项目交付文件位置

analysis/SOURCE_BIBLE.md

数据架构

主要交付物为 analysis/SOURCE_BIBLE.md。它是精简、结构化的交接文档，而非过程日志的倾倒。
章节或记录 必需内容
来源范围 与审查相关的来源版本、覆盖范围及授权边界；仅在需要复现时加入获取元数据。
覆盖范围 全书覆盖、连续区间、开篇／中段／结尾的发展、跨章节呼应、节奏、反例及改编影响。注明来源单元数量与成功处理单元数量；已覆盖集合必须与来源单元集合一致。
世界与改编事实 世界身份与规则、来源事实及引文、改编边界、文化背景、风险和设计缺口。
玩家与角色可能性 玩家身份候选项或对已锁定身份的核实、可游玩动作、角色能动性、可执行或可接收的身份行动，以及执行限制。
设计证据 来源支持的世界模型、空间、角色目标与能动性、视觉锚点及系统。不得将后续创作内容说成来源事实。
术语 角色、地点、物件及规则名称保持一致。引文保留原文；规划语言或界面语言不同时，添加必要译文。不得用其他文化中的近似标签替代特定文化实践。
改编边界表 项目 角色名册（适用时） 姓名
选定片段事实表 概念选定后添加：`事实
明确标注推论，并将未解决事项标为开放设计空间。如果锁定的游戏类型要求来源未确立的系统，应指出这是后续创作。不要将游戏状态键、回合或日程 ID、场景 ID、枢纽／界面结构、QA 和范围计划写入 SOURCE_BIBLE；这些内容属于 GAME_DESIGN。

高级特性

证据优先的改编：
引文和来源位置便于审查，并防止将缺乏依据的设计主张当作小说事实。
全覆盖关卡：
覆盖范围必须与来源单元一致；仅有开篇预览不能代替全书分析。
受控并行处理：
互不重叠的章节批次可在同一提取规范下并行处理，综合与事实核查则须依序进行。
复用既有成果：
优先使用写作项目或完整解构资料，并针对缺失证据回查来源。
结合简报确定优先级：
PRODUCT_BRIEF.md
优先收集核心幻想相关证据，并核实预先选定的玩家身份，不凭空创造来源未支持的系统。
多语言处理：
保留来源语言引文，添加必要译文，并维护一致的术语表。
后续交接保障：
提供标准化边界表和角色名册，概念选定后再添加片段级事实表；发现差异时应在上游更正，不让下游团队改写已确立的事实。
明确区分事实与设计：
明确记录推论和开放设计空间，并将虚构的游戏实现结构排除在 SOURCE_BIBLE 之外。

name: novel-game-analyze description: "Deconstruct a novel for game adaptation. Compress a raw novel, deconstruction library, or writing project into a SOURCE_BIBLE with cited textual evidence, extracting world rules, player verbs, spaces, character will, systems, and visual anchors — without inventing a genre yet. Use for gameable book analysis, analyze a novel for game adaptation, extract game systems from a book. 游戏化拆书。把原始小说、拆文库或写作工程压缩成有必要原文证据的 SOURCE_BIBLE，提取世界规则、玩家动词、空间、角色意志、系统和视觉锚点，不提前发明游戏类型。用于游戏化拆书、分析小说的游戏改编基础等需求。"

小说游戏化拆解

建立游戏设计所需的事实层，不评价文笔，也不在此阶段选择游戏类型。

读取 gameability-protocol.md。

产物语言由 PRODUCT_BRIEF.md 锁定；未锁定时跟随对话语言，不默认产出中文。

原文可以是任意语言。引用保留原文；策划语言或界面语言与原文不同时附必要译文，并建立角色名、 地名、物件和规则的统一术语表；礼制、宗教和叙事惯例不替换成另一文化的近似类型标签。

输入

优先复用现有写作工程或全量拆文产物，只回原文补关键证据；只有原始小说时才执行 本 skill 的全书管道。已有分析若只覆盖黄金三章或快速预览，只能帮助判断开篇，不能 证明理解了全书。除非用户明确只改编某一卷或片段，否则来源未覆盖全文时不得进入概念设计。

若存在 PRODUCT_BRIEF.md，先读取：分级、核心幻想与已锁类型决定取证优先级——优先为 核心幻想涉及的动作、关系、场面取证；对已锁类型需要而原作未系统提供的体系（如属性相克、 数值成长），在设计空白中写明「原作无系统化的对应体系，属下游发明」，供下游改编边界如实 引用。

全书管道

建立边界 → 逐单元提取 → 覆盖门禁 → 分层聚合 → 回查原文 → 压缩交付。各步做法以 gameability-protocol.md 为准，此处只列顺序，不重述。选定改编段落的核对在概念选定后二次 进入时做，产出逐事实表（见「输出」）。工作卡只服务覆盖、恢复和复核，不把过程日志包装成策划成果。

可以在运行时并行处理互不重叠的章节批次，但每批必须使用同一提取契约，聚合和事实回查 保持串行。环境不支持并行时逐批串行完成，不能改成抽样。

提取维度

只保留会影响玩家动作、世界响应或视听身份的内容；维度、覆盖状态与命令/委托的记录方式以协议 「逐单元取证」「从事实得到系统候选」为准。

为硬规则、关键角色目标、玩家身份依据、转折结局和标志性锚点记录章节或文件位置。 普通候选项不必机械附带置信度对象；推断必须明确标成推断或开放设计空间。

输出

生成一份 analysis/SOURCE_BIBLE.md，包含来源范围、全书覆盖、世界身份、原作事实与 证据、改编边界、玩家身份候选（PRODUCT_BRIEF 已锁身份时改为该身份的动作空间验证）、 可玩动词、可下达/承接的身份动作及其执行阻力、世界模型、空间与角色能动性、文化语境、 术语表（语言条件见上）、视觉锚点、风险和设计空白。全书覆盖按连续范围列出开篇、中段、结局和跨段 回收的关键变化、强弱节奏、反例与游戏化意义；表头写明来源单元数与成功数，覆盖集合必须与来源单元 集合一致。短表格优先于重复文档、结构化数据和证据索引。

改编边界必须是表格：条目 | 边界类型 | 证据位置，边界类型只用协议的四种标签；涉及 名分、座次、官阶或队伍序列的作品必须附人物名册行（姓名 | 身份/次序 | 结局 | 证据回目）， 作为下游各交接门逐项比对的名册基准。

概念阶段选定改编段落后，二次进入本 skill 为该段落补一张逐事实表并追加进 SOURCE_BIBLE： 事实 | 证据位置 | 边界类型，含入镜角色的外观要点（服饰、兵器、体量及位置；原文无描写 写「原文未明确」）。此表是下游交接门的段落级比对基准；下游仍可回原文补证，发现出入时 回上游修正此表，不得各自改写。概念选定后只补充或纠正有依据的原作事实——SOURCE_BIBLE 不得包含下游发明物，游戏状态键名、回合或日程编号、 scene_id、Hub/界面结构、QA 与范围计划只属于 GAME_DESIGN，不得把既有事实改写成 切片说辞。

来源范围只记录会影响复核的版本、覆盖范围和授权边界。下载日期、字节数、校验值和 本地路径只有在复现契约确实需要时才写，不把获取日志当策划内容。

其余完成门禁见协议「事实保真与交付」。

短剧创作者工作流
游戏 QA