@oh-story/dsh 0.1.3 → 0.1.5

package/lib/novel-to-game/skills/game-concept/references/concept-method.md

@@ -0,0 +1,94 @@
+# 概念选择方法
+
+## 类型与先例
+
+类型由玩家大部分时间用什么能力解决问题决定，不由原作表面上有多少战斗、恋爱或对白决定。范围可以
+缩小，核心循环不能削到只剩一次判断或一个放行按钮。
+
+先例按设计问题选择，不按题材相似选择。一个主要玩法先例应能说明核心动词、循环、压力与熟练度；
+辅助先例只补主要先例回答不了的独立问题。记录借什么、明确不借什么和事实来源，不收集与当前决定
+无关的销量或排名。
+
+需要玩家操纵空间、视角或地形时使用实时空间；固定镜头和连续场景不必为了“更像游戏”强做三维。
+平台与技术只是实现约束，不替代玩法判断。
+
+## 硬否决
+
+出现任一情况就重做，不靠评分补偿：
+
+- 玩家读完或点完一段只让既定剧情继续，换选择不会改变后续原因、关系、路线或结果；
+- 没有 3–5 个可重复参与手段，或这些动作不产生压力、取舍、状态变化与熟练度差异；
+- 原作中心规则、情感或伦理张力只存在于过场和名词，核心循环与它无关；
+- 删除专有名词后，本作与通用模板没有动作对象、代价或世界回应上的差异；
+- 最小切片依赖开放世界、多人服务、生产级内容量或不可获得资产；
+- 依赖复制其他游戏受保护的角色、地图、UI、文本或素材；
+- 玩法无法用一个主要先例或清楚的循环说明，玩家也无法预判自己反复在做什么；
+- 切片从头到尾只有数值或文本增加，没有新的参与手段、可达空间、可问对象或局面；
+- 玩家介入被兑现成花资源放行既定结果，缺少因果权或结算权。
+
+## 玩家能动性
+
+- **因果权**：玩家的选择决定事情为什么发生、朝哪里转；选什么都汇入同一原因即不成立。
+- **结算权**：世界会点名玩家做过的事，代价落在他在乎的对象上；只给总分或旁白总结不成立。
+
+每个方向用一句话回答：“玩家做了什么，使这件事只能这样发展，而且结果怎样看得出是他造成的？”
+
+## 身份专属命令
+
+自然语言不是默认输入方式。只有当玩家需要以角色身份组织对象、执行人、条件、期限或知情范围，且措辞
+差异本身值得保留时，才选择一项 `signature_command`；实时瞄准、移动、节奏操作或已有按钮已经完整表达
+核心动词时写 `N/A`。不开放通用“你想做什么”，也不把每个 NPC 都变成聊天入口。
+
+五项字段组成一条因果链：`player_job → recurring_job_loop → signature_command → resistance_chain →
+advancement_ladder`。`signature_command` 选中时只先锁 `id`、玩家可见 `label` 和候选 `intents`；具体
+槽位、验证器与提交项由世界设计裁决。意图数量服从最小切片，不设跨项目固定数；玩家表达先编译成
+有限候选动作，世界仍可拒绝、部分执行、走样、泄露或延期追责。若自由表达最后只等价于按一个现成
+按钮，且没有增加身份感、组合空间或可读后果，就不采用。
+
+## 体验承载类型
+
+- `system-led`：玩家主要操作规则，熟练度来自走位、出招、分配、经营或建造。
+- `narrative-led`：玩家主要读局面、追问、比对信息、表态并承担回响；拿掉数值面板仍知道该争取什么。
+- `hybrid`：两层各自成立且双向影响；一层只是为另一层放行时，按真正承载体验的那层记录。
+
+用“拿掉测试”判断：删掉系统层或场景/对白层，哪一边会让体验失去主要决策？两边都塌且彼此读写，
+才是 `hybrid`。
+
+## 互动叙事结构
+
+互动叙事的可重复循环可以是：读局面 → 追问/调查 → 比对证词与证据 → 表态或行动 → 承受回响。
+熟练度来自知道谁掌握什么、何时施压、什么必须隐瞒，以及先前行为怎样改变当前局面。
+
+按内容预算选择结构：
+
+| 结构 | 适用情况 | 主要成本 |
+|---|---|---|
+| 主干加瓶颈 | 关系与立场变化需要记忆，但关键事件可汇流 | 状态变体 |
+| 任务簇 | 调查、取证、地点顺序可交换 | 节点组合 |
+| 长廊 | 命定主线必须被所有玩家看到 | 分支较浅 |
+| 分院帽 | 前段选择分配到不同后半程 | 多套后半程 |
+| 树洞 | 短小、多周目、分支很少汇流 | 大量内容不可见 |
+
+不设汇流时分支不要连续膨胀；用“节点数 × 状态变体 × 关键人物数”估算内容，而不是画一棵无限树。
+
+## 三段弧
+
+三段弧要求玩家能力或局面发生质变：
+
+- 探索期：认识可用动作、对象和第一层风险；
+- 成长期：组合动作、读取先前状态，获得新手没有的选择；
+- 成熟期：在较少提示下利用早先积累，完成代表性结果。
+
+系统主导看新动词与新可达空间；叙事主导看新可问对象、质证手段、人物态度和只有知情者可达的场景。
+数字变大、多一段文本或无后果选项都不算弧线。
+
+## 比较维度
+
+1. 原作规则是否改变动作对象、顺序、代价或世界回应；
+2. 玩家是否亲手 enact 原作的情感或伦理张力；
+3. 玩家能动性是否在切片内被世界回读；
+4. 一张实际画面能否说明身份、动作和独特世界；
+5. 表达是否尊重原作文化，并适合目标界面语言与受众；
+6. 最小原型能否用现有时间、工具与资产证明最大风险。
+
+相近方案不做伪精确排序。选择能以最小切片证明核心幻想、且失败条件最清楚的方向。

package/lib/novel-to-game/skills/game-qa/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: game-qa
+description: "Verify a game with evidence on its selected target runtime. Launch the actual build and prove real rendering, input, the core loop, at least one designed outcome, restart, and explicit limitations without dressing subjective fun up as a certain verdict. Use for test a generated game, QA a game build, check whether the game is fully playable, or verify the build. 游戏证据化质量验证。在选定的目标运行环境中启动实际构建，证明真实渲染、输入、核心循环、至少一个设计结果、重开和明确限制，不把主观趣味包装成确定性结论。用于测试生成游戏、检查游戏能否完整游玩或验证构建。"
+---
+# 游戏质量验证
+
+验证当前候选能否完成最小可玩闭环，不把自动化结果包装成趣味、平衡、权利或发布质量结论。
+
+读取 [qa-contract.md](references/qa-contract.md) 定判据，按
+[test-design-method.md](references/test-design-method.md) 设计最少但有区分力的检查。
+
+产物语言由 `PRODUCT_BRIEF.md` 锁定；未锁定时跟随对话语言，不默认产出中文。
+
+## 唯一必需合同
+
+每个候选都必须用真实运行证据覆盖：`launch`、`render`、`input`、`coreLoop`、`outcome`、`restart`。
+`targetFinish` 描述成色，不改变这组六项。`checks` 恰好只含六键；项目回归与诊断只能映射回其中
+一项、写入 `verify.suites` / evidence，或作为 limitation，不得生成第七道门。
+
+这是一条自动化或代理可执行的运行验证，不要求真人试玩、主观评分或逐项人工批准。需要真人研究时
+另立产品研究任务，不得把它变成当前候选 PASS 的隐藏前置条件。
+
+## 执行
+
+1. 读取 `targetRuntime`、`testedRuntime` 和权威 verify；与 PRODUCT_BRIEF/BUILD_BRIEF 冲突时先报错，
+   不由 QA 猜值。
+2. 只运行一次权威 verify：它在 testedRuntime 从 clean start → 核心动作 → 设计结果 → restart
+   完成整条路径，并记录 command、exit code、环境、六项结果、最小证据和实际失败。
+3. 对照 GAME_DESIGN 中会改变结果的不变量和三段弧结束标记；只验证批准的设计承诺，不遍历所有
+   代码路径。
+4. 若候选有可执行模型、事件日志或 patch，由同一权威 verify 内嵌项目回归，不由 QA 另跑第二条命令：
+   同版本同初态/seed/输入得到同一终态，非法动作不提交，未选分支不污染，角色与玩家不读取未获知事实；
+   patch 只改变声明节点并重放受影响路径。若有 `signature_command`，还验证规范化候选的确定性提交、
+   否定/含混/冲突输入不误命中、执行阻力可拒绝或部分完成、实际结果与反馈一致、到期事项准时且只触发
+   一次；谈话不得越权提交效果或泄露知识。失败按影响映射到 `coreLoop` / `outcome` / `restart` 或写
+   limitation，不新增 checks。
+5. 记录 limitation 和问题的 product/design/art/build 归属。趣味、长期平衡、留存和商业价值只能写成
+   未验证风险，不给确定性 PASS。
+
+优先使用已有可观察状态；只有无法判断结果时才增加最小测试钩子。不要为了 QA 重构游戏或强制某种
+框架、测试库或调试接口。
+
+## 输出
+
+- `qa/verification.json`：唯一 QA 事实源，包含三态 status、权威命令、complete run、六项 checks、
+  一条证据路径和 limitations。证据文件保留运行细节，不再复制一份 `qa` 结论对象，也不再生成
+  重复的人工可读 QA 报告。
+
+状态只取 `NOT_RUN` / `FAIL` / `PASS`。缺口写结构化 limitation，不发明 `PASS_WITH_GAPS`；未运行或
+失败的必需项不能满足整体 PASS。

package/lib/novel-to-game/skills/game-qa/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Game QA"
+  short_description: "Verify the game runs and can be completed · 验证生成游戏能否完整运行和游玩"
+  default_prompt: "Use $game-qa to test this generated game on its selected target runtime and report blocking issues."

package/lib/novel-to-game/skills/game-qa/references/qa-contract.md

@@ -0,0 +1,66 @@
+# 质量验证契约
+
+本契约只规定什么结论需要什么证据。测试框架、调试接口和实现结构由项目决定。
+
+## 状态与事实源
+
+状态只取 `NOT_RUN` / `FAIL` / `PASS`。未验证不是通过，安全失败也不是成功降级。
+
+`qa/verification.json` schema v3 恰好使用以下顶层字段，`checks` 恰好只含六键：
+
+```json
+{
+  "schemaVersion": 3,
+  "status": "PASS",
+  "verify": {"command": "<权威命令>", "exitCode": 0},
+  "completeRun": {
+    "id": "main-path",
+    "cleanContext": true,
+    "terminal": "designed-outcome",
+    "restart": "initial-state",
+    "evidence": "qa/evidence/run.json"
+  },
+  "checks": {
+    "launch": "PASS", "render": "PASS", "input": "PASS",
+    "coreLoop": "PASS", "outcome": "PASS", "restart": "PASS"
+  },
+  "limitations": [
+    {"scope": "target device", "reason": "not available"}
+  ]
+}
+```
+
+`completeRun.evidence` 指向非空的 JSON 观察清单。清单只保存事实，不复制 command、exitCode 或
+六项 PASS/FAIL：`schemaVersion: 1`、与 `completeRun.id` 相同的 `runId`、非空 `environment`、
+非空 `inputTrace`，以及恰好包含六键的 `observations`。每项观察含非空 `id`、实际 `inputs` 和
+`state`；`render.visual` 必须指向工作区内非空画面，`outcome.state` 与 `restart.state` 分别记录
+`completeRun.terminal` 和 `completeRun.restart`。其他观察也可引用同次运行的画面。
+
+权威命令无论成功失败都原子重写 `verification.json`，旧 PASS 不得在失败复跑后幸存。项目回归只放
+`verify.suites` 或证据诊断；若其失败破坏六项之一，映射到该键。
+
+## 最小可玩闭环
+
+一次权威运行至少证明：
+
+1. 候选在实际 `testedRuntime` 启动，无阻断错误；
+2. 画面非空且会随时间或操作变化；
+3. 真实输入引起可观察状态变化；
+4. 核心循环完整执行；
+5. 至少一个设计结果可达；
+6. restart 回到定义初态。
+
+步骤、状态和画面必须属于同一次 complete run；截图不能证明隐藏状态，状态 dump 不能证明真实画面。
+目标运行环境与实际测试环境不同时，把目标独有输入、打包、性能和设备行为写 limitation；替代版本
+不能证明目标平台已通过。
+
+## 条件检查与边界
+
+连续 3D、多语言、无障碍、语音、媒体或生成资产只在游戏实际采用时运行诊断。只看玩家能否正确
+看到、听到、操作和完成核心流程；诊断不新增 checks，也不审计供应商请求、营销素材或生产身份。
+
+只有 brief/ledger 预先批准的 fallback 才能继续，并证明核心动作、状态、结果、可读反馈和 restart
+仍成立。安全失败仍是 FAIL；测试替身只证明测试层；placeholder 只描述完成度；历史证据只说明旧候选。
+
+不要求真人试玩、人工审查或另写 QA 报告。主观趣味、平衡、沉浸、选择重量、权利合规和发布质量
+不由本合同确定性证明；需要这类研究时另立任务，不影响本合同的机器 PASS。

package/lib/novel-to-game/skills/game-qa/references/test-design-method.md

@@ -0,0 +1,45 @@
+# 测试设计方法
+
+目标是用最少证据判断候选是否完成可玩闭环，而不是把项目变成测试工程展示。
+
+## 一、从六项结果反推
+
+为 launch、render、input、coreLoop、outcome、restart 各选择一条最小证据，不为项目自己的回归与诊断复制平行验收矩阵。
+
+## 二、从设计承诺写断言
+
+读取 GAME_DESIGN 中会改变结果的门槛、结局、失败条件、三段弧结束标记和核心动词，为每项选择一
+个正例和一个有区分力的边界或反例。断言盯住玩家可观察结果，不绑定内部函数名。
+
+叙事项目重点检查关键选择、持久状态读取、分支汇流、结局条件和人物知识边界；系统项目重点检查
+状态迁移、门槛、资源、失败和重开。修复缺陷时补能重现原故障的回归，不只验证 happy path。
+
+有事件日志时，保存规则版本、初态摘要、seed、输入序列和终态摘要，完整重放一次；随机探索只用于找
+死路和失败 seed，不能代替真实路径。叙事生成存在时增加四类反例：事实冲突、承诺冲突、改写玩家已
+提交行动、向未见证者泄密。模型输出只算候选，断言最终由规则器提交的状态与玩家可见反馈。
+
+存在身份专属命令时，正例从固定规范化候选开始证明同状态/seed/版本得到同一执行轨迹与结果；解析层另用
+同义表达、否定、条件、缺槽和互斥要求做契约检查，允许澄清或拒绝，不允许静默误命中。反例覆盖执行人
+不在场、资源不足、空间无权限、人物未知情和承诺冲突，均须无提交；部分执行或泄露时，反馈必须与实际
+证物、见证和知识变化一致。到期事项检查不早触发、到期重新上桌、只结算一次，并在存读/重开后不复活；
+谈话产生的事实、承诺、权限、拒绝和见证也必须先通过规则验证。
+
+局部 patch 后先重放原失败路径，再选一条共享上游状态但走相邻分支的反例。文本/资产替换可保持状态
+摘要不变；变量语义、节点 id、动作效果或知识权限改变则要求存档/日志迁移，或明确旧版本拒绝载入。
+
+## 三、一条完整路径胜过截图堆
+
+从 clean start 走到设计结果再 restart。每个 checkpoint 只保留触发输入、预期变化、状态证据、运行
+环境证据和必要代表帧。只有语义发生变化时留新 checkpoint；不要为每次点击保存一张图。
+
+时序、动效、碰撞和连续镜头证据必须在正常速度下采集；慢放只用于定位，不能证明体验正常。
+
+文字或叙事主导项目的代表帧同时记录目标视口与主游玩面板的实际溢出。若玩家必须滚动才能看完当前
+正文、选择或必要反馈，先归为设计／构建问题；明确由玩家主动打开的账册、图鉴和长档案不在此限。
+跨视口截图矩阵、raw trace 和溢出遍历可放临时目录做诊断，不要为了证明这一点把重型 QA 工程塞进示例。
+
+## 四、证据要求
+证据用工作区相对路径且文件真实存在（不引用临时目录、缓存或个人桌面）；状态、runtime 和 visual 各证明自己的层，不互相冒充；其余状态取值与 limitation 按 qa-contract.md 记录。
+
+大型录屏、逐点击截图、raw trace 和可重建 contact sheet 不长期进 Git；保留当前声明真正引用的最小
+代表证据。问题按 product/design/art/build 归属，主观体验不计入机器 PASS 数量。

package/lib/novel-to-game/skills/game-world-design/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: game-world-design
+description: "Design game experience, systems, and levels. Converge the chosen concept into one GAME_DESIGN defining the player promise, core loop, how the world responds, the systems actually needed, level pacing, feedback, failure, and a fully playable prototype. Use for design the game world, deepen the gameplay and levels, write the game design document, design the branching story structure, scenes, dialogue and consequences. 游戏体验、系统与关卡策划。把选定概念收束为一份 GAME_DESIGN，定义玩家承诺、核心循环、世界响应、必要系统、关卡节奏、反馈、失败和可完整游玩的原型。用于设计游戏世界、深化玩法和关卡、设计互动叙事的场景对白与分支因果等需求。"
+---
+# 游戏体验与世界设计
+
+把选定概念变成可实现的玩家体验，不写世界观百科、工程方案或美术方向。
+
+输入必须包含 `SOURCE_BIBLE.md`、已选择的 `CONCEPT.md` 和 `PRODUCT_BRIEF.md`。读取
+[world-design-method.md](references/world-design-method.md)；确有资源、门槛或难度时再读
+[numeric-design-method.md](references/numeric-design-method.md)。
+
+`narrative-led` 或 `hybrid` 的叙事层同读
+[narrative-design-method.md](references/narrative-design-method.md) 与
+[dialogue-design-method.md](references/dialogue-design-method.md)。需要玩家可见文案时按
+[game-writing-craft.md](references/game-writing-craft.md) 统一声口，不为所有项目强制写长篇对白。
+
+产物语言由 `PRODUCT_BRIEF.md` 锁定；未锁定时跟随对话语言，不默认产出中文。
+
+## 设计原则
+
+- 保护 CONCEPT 的玩家承诺、`experienceProfile` 和不可妥协项；发现范围冲突时回上游修订。
+- 只保留一个核心系统、最多两个支持系统；删除后不影响核心循环的内容不要升格为系统。
+- 规则写成玩家动作 → 状态变化 → 世界反馈 → 后续选择，不用背景设定代替可玩因果。
+- 用“教会 → 变式 → 组合 → 检验 → 命运回收”组织最小切片；默认 10–30 分钟且不超过 brief 时长。
+- NPC、势力、资源和历史只设计到玩家能感知、利用或改变的深度。
+- 不写文件名、函数、存储键、测试脚本、着色器或资产管线；实现结构由构建阶段决定。
+
+## 输出合同
+
+生成一个 `design/GAME_DESIGN.md`，保持紧凑并包含：
+
+1. **体验合同**：玩家身份、承诺、目标感受、`experienceProfile` 与首分钟目标；
+2. **核心动词与循环**：3–5 个动词、短循环、长循环、主要玩法先例，以及原作如何改变动作对象、
+   顺序、代价和世界回应；
+3. **世界规则与必要系统**：玩家可见/隐藏信息、行动顺序、随机性、资源或持久状态及其读取点；
+4. **成长与三段弧**：探索、成长、成熟阶段新增的参与手段、可达空间或局面，以及可观察结束标记；
+5. **代表性决策**：用一个场景证明最优选择会随局面翻转，并写清因果权与结算权；
+6. **空间、镜头与关卡节拍**：路线、地标、压力、教学、组合和检验如何制造选择；
+7. **反馈、失败与重开**：输入反馈、状态变化、失败原因、下次可改之处和定义初态；
+8. **叙事附件**：仅在叙事实际承载体验时写场景脊柱、人物议程、知识/证词边界、持久回响、
+   分支汇流和结局回收；否则写 N/A；
+9. **语言、文化与交接边界**：界面语言、术语、阅读顺序、内容尺度，以及交给美术和构建的玩家效果；
+10. **可执行切片合同**：最大设计风险、与风险匹配的原型形态、最小状态面、关键动作的前置/效果/观察者、
+    会被后续读取的事件，以及固定初态、seed、输入序列、预期状态与反馈；若概念选择了
+    `signature_command`，固定 `id / label / intents / slots / validators / commit` 六组最小结构，再追加
+    澄清与拒绝条件、委托执行链、实际结果、证物/知情变化和到期回响；
+11. **验证切片**：范围、明确非目标、完整路径和会触发设计修改的观察结果。
+
+只有门槛、结局或张力确实读取数值时才做数值预算；叙事状态同理，写入后没有可见读取点就删除。
+规则优先用短表表达，不复制成平行 JSON、go/no-go 表或第二份验收矩阵。
+
+## 完成检查
+
+- 玩家能从初态通过真实选择到达至少一个结果并重开；
+- 三段弧改变的是可用动作、空间或局面，不只是数字、文本或收集量增加；
+- 核心状态都在后续被读取，主要选择至少一次被世界明确回响；
+- 同一初态、规则版本、seed 与规范化动作输入序列可重放到同一终态；未见证角色不能读取秘密，未选分支不能污染历史；
+- 专属命令若存在，玩家表述、解析候选、实际执行与反馈彼此可区分；无效或含混输入不得偷偷提交近似动作；
+- 支持系统、分支和角色内容没有静默扩出 brief 范围；
+- 文档没有替实现做技术设计，也没有把趣味或平衡写成确定性 PASS。
+
+输出交回总入口，不自行推进美术、构建或 QA。

package/lib/novel-to-game/skills/game-world-design/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Game World Design"
+  short_description: "Design the playable world, systems, and levels · 设计可玩的世界、系统与关卡体验"
+  default_prompt: "Use $game-world-design to deepen this concept into a playable world and a complete prototype."

package/lib/novel-to-game/skills/game-world-design/references/dialogue-design-method.md

@@ -0,0 +1,59 @@
+# 对白与互动选择设计方法
+
+对白承担主要体验时，用本方法把人物目标、信息权限和玩家选择写成可实现的场景。它不规定
+台词长度、选项数量或固定节拍；逐字文案的声口见
+[game-writing-craft.md](game-writing-craft.md)。
+
+## 一、先写议程，不先写台词
+
+先完成 [narrative-design-method.md](narrative-design-method.md) 的场景脊柱，再为会改变局面的
+参与者记录：当前要求、害怕暴露的事、可用筹码、初始策略、受阻后会换的策略和底线。
+
+先写行动链：
+
+`A 用策略和筹码行动 → B 回应或拒绝 → 局面变化 → A 换招或退出`
+
+每轮应改变信息、关系、权力、物件、站位或下一步可做的事。纯粹重复立场的往返应压缩；一方
+每句都成功会把对话变成演讲。
+
+## 二、让台词执行动作
+
+关键台词应主要执行一种人物动作，例如试探、交换、划界、推责、威胁、保护、求证、拒绝、
+承诺或撤回。同一句事实可以因目标不同而成为不同动作；先定动作，再写句子。
+
+保留能推进局面、增加期待、显露人物或改变权力的台词。物件、站位和反应已经表达的意义不要
+再解释。沉默、打断和长发言只有在改变策略或信息条件时才保留；设定信息随压力和行动进入，
+不要让角色整段科普。
+
+## 三、人物声音
+
+核心人物只需一张紧凑声音卡：
+
+- 他认定什么算证据，又怎样证明；
+- 他如何使用称呼、公开范围和关系控制距离；
+- 他如何隐藏、拒绝或转移；
+- 压力下句式和策略怎样变形；
+- 哪条底线被触碰时会出现可追溯变化。
+
+人物辨识度来自目标、知识和关系策略，不靠口头禅。交换两名说话者后若关键台词仍完整成立，
+检查缺少的是目标、证据观、知识边界还是关系位置；不要用固定对白长度推断权力。
+
+## 四、信息、潜台词与选项
+
+人物只能使用本场已经掌握的信息；推断说出口时要听得出仍是推断。潜台词同时包含字面内容、
+想让对方做的事和不能直说的风险，并通过避词、物件、称呼、证据矛盾或公开范围变化让玩家看见。
+没有秘密、风险或权力差时，直说通常比强造潜台词更真实。
+
+互动选项写主角真正会说或会做的内容，不用“安抚她”“施压”“信任他”这类作者摘要。选择后
+先给人物反应，再让后续行动承接；按钮、回应和代价提示各做一件事，不重复解释。
+
+## 五、修订与交付
+
+逐场检查：是否过度解释或收口；人物是否只会重复同一策略；证据、筹码和信息密度是否变化；
+选择是否总套用同一模板；代价是否被当场结清；巧合或第三人是否反复替人物解决问题。
+
+修订优先删解释、合并重复轮次、让反对方使用筹码，并让物件或空间承担意义。保留原作中的方言、
+笨拙、急话、称呼和不整齐句式，不把所有人物润色成同一种标准范文。
+
+交付前反向走读分支，确认未选事实没有串入；每场至少留下可见变化和退出压力；玩家作判断所需
+的证据不能在删解释时一并删掉。

package/lib/novel-to-game/skills/game-world-design/references/game-writing-craft.md

@@ -0,0 +1,53 @@
+# 游戏文案写作规范
+
+小说改编游戏的玩家可见文本应继承原著的语言资产，同时适应平台、分级和交互节奏。先确定声口，
+再删解释腔和模板腔；适用于标题、引导、按钮、提示、事件、对白、结算和结局。
+
+## 一、确定声口
+
+根据 `PRODUCT_BRIEF`、原作语域和目标市场确定整体声口，例如古典白话、现代口语、克制写实、
+喜剧或悬疑。结构可以更短、更适合交互，但用词、称呼、礼制和文化概念仍跟随原作；不要把所有
+题材改成同一种网络腔。
+
+核心人物各记一行：说话目的、施压方式、句式节奏、称呼习惯、常落到的实物和绝不会说的话。
+只保留会改变实际台词的差异，不靠口头禅制造辨识度。
+
+## 二、视角与信息
+
+场景按明确视角人物呈现，只写其此刻能感知、记起或合理推断的内容。视角可以换场切换，但不要
+在同一场景随意滑入他人内心，也不要由旁白提前解释秘密、主题或人物品性。
+
+玩家作决定所需的证据要可见；结论尽量交给动作、物件、台词和反应。界面读数只服务确实需要
+量化的系统，不替人物和现场叙事。
+
+## 三、删模板腔
+
+修订时优先处理这些信号：
+
+- 用“不是 A，而是 B”、总结句或主题升华替玩家下结论；
+- 直接命名情绪，却没有身体、动作或关系上的表现；
+- 同一动作重复描写，或用万能副词、套语堆出文学感；
+- 人物用完整书面句科普设定、前因后果和自己的真实动机；
+- 所有句子同样工整，所有人物同一种语法、节奏和证据观；
+- 段尾总靠预告、感叹或抽象悬念收束，而不是未完成的行动或具体变化。
+
+这些是修订线索，不是机械词表。方言、口吃、急话、地方称呼和题材需要的停顿不应因“规范化”
+被抹平；判断标准是它是否符合人物、场景和原作语域。
+
+## 四、交互文本
+
+- **按钮与选项**：写玩家将执行的动作或真正会说的话，不写策划标签；
+- **提示与引导**：说明当前可做什么或可见代价，不一次倾倒术语；
+- **事件标题**：给出具体冲突、人物或物件，不用空泛悬念；
+- **结算反馈**：先让人物和世界回应，数字只补充量，不替代意义；
+- **选择节点**：按钮、代价提示和回应各承担不同信息，避免重复解释。
+
+## 五、分级与安全边界
+
+内容强度服从 `PRODUCT_BRIEF` 和目标平台。亲密或成人向场景仍需明确视角、人物意志、关系变化
+和后果，不把身体描写当作内容本身；不涉及真实人物，不性化未成年角色。
+
+## 六、交付自查
+
+逐场确认声口一致但人物可区分；信息没有越过视角；玩家能理解选择依据；UI 没有把世界翻译成
+策划术语；删除一句若不损失信息、人物、情绪或行动，就删除。自然度不以固定词频或字数阈值判定。

package/lib/novel-to-game/skills/game-world-design/references/narrative-design-method.md

@@ -0,0 +1,84 @@
+# 互动叙事设计方法
+
+场景、对白、知识差或关键选择承担主要体验时使用本文。写逐字文案时再读
+[dialogue-design-method.md](dialogue-design-method.md) 与
+[game-writing-craft.md](game-writing-craft.md)；系统主导项目使用
+[world-design-method.md](world-design-method.md)。
+
+## 一、玩家能动性
+
+互动叙事至少让玩家拥有两种权利：
+
+- **因果权**：选择改变后续事件为何发生、谁采取行动或什么机会被关闭；
+- **结算权**：人物、局面或结局会具体回应玩家做过的事，而不只改变隐藏总分。
+
+资源、卡牌和随机判定可以承载选择，不能替代选择。外部事件可以制造麻烦，但不应替玩家
+解决核心矛盾；误会需要有不解释的理由、改变人物行动，并在澄清后留下关系或机会上的残余。
+
+## 二、场景脊柱
+
+写场景前记录：
+
+| 项目 | 要回答的问题 |
+|---|---|
+| 存在理由 | 删除本场会损失哪项选择、证据、关系变化或不可逆行动 |
+| 时空与视角 | 何时何地发生，玩家通过谁感知现场 |
+| 人物议程 | 每个人想得到、保护、隐瞒或确认什么 |
+| 反制筹码 | 谁用人物、证据、物件、时间或身份挡住谁 |
+| 知识边界 | 世界事实、各人物相信和玩家知道分别是什么 |
+| 方向变化 | 哪句话、证词、物件或行动让原计划失效 |
+| 玩家介入 | 玩家观察、追问、表达或采取什么行动 |
+| 离场状态 | 人物、关系、信息和物件如何变化，下一场为何现在发生 |
+
+在压力已开始时进入，在局面改变后离开。相邻场景通过人物行动、未付代价、物件去向或时间
+压力连接；只有时间相邻而没有因果连接的场景应合并或删除。
+
+## 三、人物与知识
+
+核心人物只记录会驱动场景的内容：当前欲望、害怕失去的东西、掌握与误解的信息、可用筹码、
+对玩家行为的记忆、会主动发起的行动，以及声口和底线。人物变化必须能追溯为
+`压力 → 选择 → 局部结果 → 代价 → 新策略`；拒绝改变也可以是有效结果。
+
+关键事实维护三层状态：
+
+- **世界事实**：实际发生了什么；
+- **人物相信**：每个人知道、误信、怀疑或隐瞒什么；
+- **玩家知道**：玩家当前看见、听见并能合理推断什么。
+
+关键证据再区分可见载体、直接支持的最小结论和仍未确定的解释。人物只能使用自己已经掌握的
+信息；新揭示可以改写旧证据的意义，不能改写已经发生的事实，并应改变某人可采取的行动。
+
+## 四、选择与隐藏因果
+
+关键选择记录玩家掌握的信息、人物目标、可采取的说法或行动、即时反应、持久状态、最近回响、
+延迟回响和终局影响。选项数量跟随局面，不设机械下限；不用道德标签或结果预告代替角色行动。
+
+持久状态保存具体事实，例如答应了谁、支持了谁、看过哪份证词或把物件交给谁。每项状态都要有
+写入点、读取点和玩家可感知的回响；没有读取点就删除。优先让人物称呼、行为、场景顺序、可用
+行动或结局体现历史，不把关系压成一个匿名数字。
+
+设计玩家可见的信息节拍时，按“当前局面 → 必要依据 → 选择 → 人物回应”披露，而不是把全部系统
+状态、历史、证据、解锁条件和远期后果一次摊在选择页。旧事只有在它改变当前人物说法、选项可用性
+或代价时才回到正戏，并贴近受影响的那一项；完整关系史与账目属于按需档案。若主要选择需要滚动后
+才能看全，先拆拍、删重复或把细节改为主动揭示，不用更小字号把信息爆炸伪装成高密度玩法。
+
+共享场景可以汇流，但要按历史替换人物、对白、物件和可用行动，且不得把未选行动当作已发生。
+首个原型宁可保留少量会被回收的选择，也不要堆积无人记得的分支。
+
+## 五、揭示、节奏与前提装置
+
+揭示应来自已经出现过的事实或玩家选择，并迫使人物改变行动。检查谁能接触该事实、证据为何
+现在出现、它排除了哪些旧解释，以及得知后谁必须换策略。突然加入更大的秘密不等于反转。
+
+场景在行动、对话、观察和恢复段之间切换。当前悬念兑现前可种下下一项压力，但不要让所有场景
+保持同一情绪或同等信息密度，也不要把本场造成的代价立即全部结清。
+
+原作含重生、预知、系统或特殊能力时，明确其既有规则、信息边界和可见代价。装置可以提供能力、
+信息或期限，不能临时扩权、替主角决定或反复解决困境；对手应能观察并适应已经暴露的手段。
+
+## 六、交付与路径检查
+
+交付场景脊柱、人物议程、知识表、关键选择和必要的分支图。沿代表性路径正向与反向走读：确认
+人物只使用已知信息、未选事实没有串线、持久状态被读取、每个结果能回到具体选择和人物目标。
+
+自然度、人物魅力、沉浸和选择重量不由自动化确定，也不在本仓库另设人工审批流程。

package/lib/novel-to-game/skills/game-world-design/references/numeric-design-method.md

@@ -0,0 +1,56 @@
+# 数值策划方法
+
+只在资源、门槛、结局或张力确实读取数字时使用。数值的任务是把已声明的取舍变成可演算、可推翻的
+规则，不是为设计稿增加精确感。
+
+## 先定义资源
+
+填数字前回答：
+
+1. 它用玩家能感知的词衡量什么；
+2. 从哪里产生、花到哪里；
+3. 哪些规则、事件、选项或结果读取它；
+4. 玩家怎样从界面或世界反馈理解变化原因。
+
+只有产出没有投入的资源会通胀，只有投入没有恢复会把玩家逼进死局。没有读取点的数字从 HUD 删除；
+若只是历史记录，就不要把它包装成策略资源。
+
+## 预算与可达性
+
+对每个会阻断路线或改变结果的门槛，写一行最小预算：
+
+`门槛/结果 | 起始值 | 主要增减来源 | 代表路径演算 | 是否可达 | 失败时调整`
+
+- 不可达：改门槛、来源或切片范围，不靠好运补洞；
+- 起始就达成：门槛没有制造选择，删除或重设；
+- 只有唯一可达路线：承认它是剧情条件，或补真正可比较的另一条路。
+
+预算使用实现将要消费的规则值；设计与实现不同步时逐项裁决，不维护两套“都正确”的数字。
+
+## 证明取舍存在
+
+先由设计声明什么现象会否决取舍，例如“无视相克与利用相克得到近似代价”。再选择能暴露这个问题
+的代表策略或路径运行比较。随机性会改变结论时固定种子；随机性无关时不为测试仪式强加 RNG。
+
+检查三类失败：
+
+- 一个动作或策略跨大多数真实局面都通吃；
+- 不同选择长期汇入相同状态和结果；
+- 玩家在选择前看不到足够信息，事后也学不到为什么错。
+
+项目自行声明有意义的差距和目标区间；仓库不提供跨类型通用倍率、回合数或胜率阈值。
+
+## 隐藏状态同样适用
+
+承诺、证词、物件去向、公开立场和关系变化也要有写入与读取。它们优先通过人物措辞、称呼、可选
+行动和场景可达性表现，不默认变成暗条。旗标少而被多次回读，比大量一次性变量更有深度。
+
+限制行动广度通常比锁住内容更有意义：代价可以让玩家今天少做一件事，不必让整条剧情永久不可见。
+
+## 实现漂移与交接
+
+打磨会改变数值。发现设计与实现不同时，逐项决定：采纳有运行依据的实现值并回写、修正文档错误、
+补记新增机制，或让实现补上遗漏承诺；说不清原因的批量同步不算裁决。
+
+交接前只确认：关键资源都有读取点，门槛可达，代表路径能暴露设计声明的失败现象，随机系统无死局，
+设计与当前实现没有未裁决漂移。主观平衡与长期经济仍需真实玩家研究，不写成机器 PASS。