mcpField
N
novel-game-analyze

novel-game-analyze

github.com/zenstory-aiCreative & media938289 installsUpdated 1w ago
Repository

About novel-game-analyze

novel-game-analyze is a skill for extracting game-design facts from novels, intended for adaptation planning. It emphasizes full-text coverage, evidence checks, and boundaries between source material and later design, without judging prose or choosing a game genre.

Key features

  1. 01Extract facts across the full book
  2. 02Check source coverage
  3. 03Record evidence and design gaps
  4. 04Organize terminology and cultural context
  5. 05Produce SOURCE_BIBLE.md

Use cases

  1. 01Build a source fact record for a novel adaptation
  2. 02Verify coverage beyond the opening chapters
  3. 03Ground player actions and world design in the source

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zenstory-ai/novel-to-game --skill novel-game-analyze

After installing, type/novel-game-analyzein Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/gameability-protocol.md

Details

From the project README

小说游戏化拆解

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

读取 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,不得把既有事实 改写成切片说辞。

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

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

Comments

Markdown supported