@oh-story/dsh 0.1.8 → 0.1.10

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

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

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

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

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

@@ -4,11 +4,11 @@
 
 ## 一、从六项结果反推
 
-为 launch、render、input、coreLoop、outcome、restart 各选择一条最小证据，不为项目自己的回归与诊断复制平行验收矩阵。
+为 launch、render、input、coreLoop、outcome、restart 各选择一条最小证据。
 
 ## 二、从设计承诺写断言
 
-读取 GAME_DESIGN 中会改变结果的门槛、结局、失败条件、三段弧结束标记和核心动词，为每项选择一
+读取 GAME_DESIGN 中会改变结果的门槛、结局、失败条件、结束标记和核心动作，为每项选择一
 个正例和一个有区分力的边界或反例。断言盯住玩家可观察结果，不绑定内部函数名。
 
 叙事项目重点检查关键选择、持久状态读取、分支汇流、结局条件和人物知识边界；系统项目重点检查
@@ -34,12 +34,16 @@
 
 时序、动效、碰撞和连续镜头证据必须在正常速度下采集；慢放只用于定位，不能证明体验正常。
 
-文字或叙事主导项目的代表帧同时记录目标视口与主游玩面板的实际溢出。若玩家必须滚动才能看完当前
-正文、选择或必要反馈，先归为设计／构建问题；明确由玩家主动打开的账册、图鉴和长档案不在此限。
-跨视口截图矩阵、raw trace 和溢出遍历可放临时目录做诊断，不要为了证明这一点把重型 QA 工程塞进示例。
+源码、攻略与隐藏状态可用于规则验证，不能据此证明玩家能自行理解提示或发现解法。
+仅在评估引导、提示或解谜可发现性时，另用未接触解法的试玩上下文，只提供玩家可见信息与正常输入；
+不向其开放源码、内部快照或答案文件。若已接触这些信息，结果只作知情验证，不冒充玩家视角试玩。
+记录所见提示、实际尝试与卡点；这种代理试玩不增加六项之外的必过门槛。
+
+文字或叙事主导项目在目标视口检查当前动作、必要依据与反馈是否可达可读，按批准的阅读方式判断
+遮挡、截断或不可操作。额外视口与溢出遍历按风险做诊断，不强制截图矩阵。
 
 ## 四、证据要求
 证据用工作区相对路径且文件真实存在（不引用临时目录、缓存或个人桌面）；状态、runtime 和 visual 各证明自己的层，不互相冒充；其余状态取值与 limitation 按 qa-contract.md 记录。
 
 大型录屏、逐点击截图、raw trace 和可重建 contact sheet 不长期进 Git；保留当前声明真正引用的最小
-代表证据。问题按 product/design/art/build 归属，主观体验不计入机器 PASS 数量。
+代表证据。问题按 product/design/art/build 归属。

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

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

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

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

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

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

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

@@ -1,124 +1,57 @@
 # 游戏世界设计方法
 
-## 先写可被推翻的体验假设
+## 可被推翻的体验假设
 
-把每条体验支柱写成玩家动作、可见变化和失败现象，并尽早放进一段粗糙但完整的切片。先解决最危险
-的体验问题，再增加内容和包装；时间或资产冲突时，保护最能体现原作转化的玩家动作。
+把体验承诺落到玩家动作、可见变化和失败现象。切片范围服从 brief，保真度只覆盖最大风险：
+文本可以验证叙事因果，不能证明实时操作、空间、物理或镜头成立。
 
-验证路径只记录输入、状态、反馈、结果和重开。主观喜欢与否不是机器结论。
+每个系统必须改变核心决策；删除或自动处理后体验不变的系统应删减。不要用统一时长、系统数量、
+角色层级或关卡五拍替代项目范围判断。
 
-原型保真度只覆盖最大风险：`narrative-led` 可用文本/场景白盒验证知识、承诺与回响；`system-led` 可用
-回合状态板验证资源、门槛与反制；`hybrid` 让两层在最短路径中互相读写；实时动作、视线、导航、物理或
-镜头风险直接进入目标引擎灰盒。不能用文字顺畅证明操作、空间或镜头成立。
+## 可执行因果
 
-## 类型合同与因果循环
+只写运行时真正需要的规则：
 
-只写影响玩家决策的类型规则。回合制关心信息、行动顺序和结算；实时动作关心输入、时机、空间与
-恢复；经营关心时间、资源流和延迟反馈；叙事关心信息权限、介入时机、不可撤回选择和人物回响。
-不要把任何一套字段固定给所有项目。
+`当前状态 + 玩家行动 + 世界规则 → 新状态 + 可读反馈 + 后续机会`
 
-关键规则都用同一因果句描述：
+关键动作说明前置、效果、不可突破的不变量和后续读取点；需要引用或回放时使用稳定标识。
+只对秘密、证词、欺骗等高风险事实区分世界事实、玩家知道、人物知道或相信，不为普通事实维护心智模型。
 
-```text
-当前状态 + 玩家选择 + 世界规则 → 新状态 + 可读反馈 + 后续选择变化
-```
+用代表路径检验承诺：玩家行动怎样改变原因或方向，世界又怎样回读该行动。
+按既定体验区分因果重演与策略取舍：能按原著步骤通关，不等于存在有意义的取舍。
+仅在承诺策略取舍时，给出选择间的代价与后果，以及能暴露无脑通解或伪选择的局面；
+单解谜题或线性重演可成立，不为满足此检查擅加多解、成长或新系统。
+承诺复玩时才要求可再生的不确定性。
 
-对关键动作补齐稳定 id、前置条件、确定性效果、观察者/知情者、揭示或消耗、不可突破不变量与后续回读。
-只对秘密、证词、欺骗和关系误判等高风险事实维护 `world fact / player knows / character knows or believes`；
-不要为普通事实制造多层心智模型。
+## 身份专属命令与延期回响
 
-短循环闭合一次动作和即时反馈，长循环组合多个动作并带来新压力、信息或阶段结果。优秀玩家与新手
-的差异可以是操作、资源判断、空间阅读、人物判断或一次性知识；只有项目承诺复玩时才要求可再生的
-不确定性。
+只有 CONCEPT 选中 `signature_command` 时使用本节：
 
-## 身份专属命令、执行链与延期回响
+`玩家表述 → 解析候选 → 澄清或拒绝 → 规则验证 → 执行阻力 → 提交实际结果 → 证物/知情变化 → 到期回响`
 
-只有 CONCEPT 选中 `signature_command` 时才设计本节。先定义一项身份动作和最小有限意图，不从通用聊天
-框开始：
+GAME_DESIGN 固定 `id / label / intents / slots / validators / commit` 六组最小结构。
+候选字段按本项目需要选择，不要求统一数量或字段全集。否定、条件、互斥要求或不支持的语义
+必须澄清或拒绝，不能靠关键词命中静默反转玩家意思。
 
-```text
-玩家表述 → 解析候选 → 缺槽/歧义/冲突处理 → 规则验证 → 执行阻力 → 提交实际结果
-→ 反馈证物与知情者 → 到期后果重新进入决策面
-```
+规则器拥有提交权：分别判断资源、执行人意愿、空间权限、人物知识、冲突承诺与原作边界。
+反馈区分“玩家安排”与“实际执行”，显示留下的证物、见证和到期事项，不用生成叙事掩盖结算。
 
-GAME_DESIGN 固定写出 `id / label / intents / slots / validators / commit` 六组最小结构；具体意图、槽位、
-验证器与提交项服从本项目，不设跨项目固定数量。候选动作可按项目包含执行人、动作、对象、物件、地点、
-可见范围、期限等；不要求所有项目共享同一字段全集。否定、条件、互斥要求或超出支持语义时澄清或拒绝，
-不靠命中关键词静默改成相反行动。
-规则器分别裁决资源、执行人在场/意愿、空间权限、人物知识、冲突承诺与原作边界，因此实际结果可以是
-完成、部分完成、拒绝、走样或泄露。反馈并列“你的安排 / 实际执行 / 留下的物与见证 / 后续到期事项”，
-不能只用一段生成叙事掩盖结算。
+延期事项保留来源行动、到期条件、相关人物/物件/承诺、当前状态与结清事件；到期时必须回到
+决策面，不能只追加装饰文本。若私人谈话能改变世界，也只提出事实、权限或承诺候选，
+经同一规则验证后提交；原始聊天和模型数值不是状态权威。
 
-延期事项至少声明来源行动、到期条件、携带的执行人/物件/见证/承诺、当前状态、重新上桌方式和结清事件；
-它必须在到期时改变当前选择或要求再次裁决，不能只追加一句装饰回声。若私人谈话也是玩法通道，谈话只
-提出事实、承诺、权限、拒绝和见证候选，经同一规则验证后进入事件账；原始聊天文本和模型数值都不是状态
-权威。
+## 进程与世界响应
 
-## 决策深度与能动性
+以本项目的完整路径组织局面变化和结束标记，不强套探索、成长、成熟三阶段。
+作为卖点的原作规则必须在运行中影响机会、代价或人物行动，不能只在说明里存在。
+若忽略一段规则仍得到近似结果，删除该段或补足其真正影响，不靠新增系统掩盖问题。
 
-为最重要的决策写一个代表性例子：列出可选动作和至少两种真实局面，说明为什么原本合适的动作会在
-另一局面失效。不存在跨局面永远正确的默认动作，玩家也能从界面、空间、人物或前路信息预判后果。
+叙事承担体验时，知识、人物与分支边界见 [narrative-design-method.md](narrative-design-method.md)。
 
-不要用固定选项数、百分比阈值或跨项目数值比冒充深度。项目先声明什么现象表示取舍不存在，再用
-实际规则和代表路径去证伪。
+## 白盒反馈与局部修订
 
-玩家能动性同时要求：选择改变事情的原因或方向，结果又会回读玩家做过的具体事。总分、旁白总结、
-随机救场或花资源放行既定剧情都不能代替这两项。
+保留足以复现的初态、输入路径与终态；涉及随机性时固定 seed，涉及事件回放时记录内容/规则版本与事件。
+反馈定位到“观察位置、预期/实际差异、所属规则、owner、最小修改、重放路径”，不每次重写整份设计。
 
-## 世界必须主动回应
-
-作为卖点的规则不能只供玩家单向利用。对手、环境或人物至少读取一种玩家状态并改变策略：敌人根据
-站位或资源反应，环境根据工具改变路线，人物根据承诺、证词或旧账主动试探、提条件、抢先公开或
-拒绝。只会等待玩家点击、始终完整回答或按固定脚本行动的对象没有形成对抗。
-
-所有随时间增长的资源、等级、好感和进度，都要带来新的决策类型、可达空间、人物行为或组合方式；
-只涨读数就是空转。
-
-## 系统与内容预算
-
-第一版只保留一个核心系统、最多两个支持系统和一个标志性场面。库存、制作、技能树、天气、开放
-世界和额外关系线只有在增加核心决策时存在；自动替玩家处理后体验不变的成长系统应删除或降级。
-
-角色与事件按承诺分层：
-
-| 层级 | 最小深度 |
-|---|---|
-| 氛围人物 | 身份、位置、可辨识反应 |
-| 支持短线 | 自身诉求、一次有后果的选择、一次下游回响 |
-| 核心路线 | 多阶段关系、独立筹码、高潮与结局回收 |
-
-短线先证明会产生后续差异；升级为核心路线是新的产品范围，不由内容数量自动决定。
-
-## 关卡与场景节拍
-
-用“教会 → 变式 → 组合 → 检验 → 命运回收”组织最短闭环：
-
-1. **教会**：给清楚目标，让玩家尽快做出核心动作并看到后果；
-2. **变式**：改变空间、信息、对手意图或资源，使机械重复失效；
-3. **组合**：让两个已知规则产生原作特有的场面或取舍；
-4. **检验**：减少提示，让玩家迁移所学，并显示失败原因和可改之处；
-5. **命运回收**：结果读取玩家的关系史、知识、资源与关键选择，而非只看一个总分。
-
-逐拍用最省事的默认打法走一遍；若忽略该拍规则仍得到近似结果，就给它一条可见的局面约束，或把
-这拍删掉。修复优先复用已教系统，不为中段另造新系统。
-
-## 空间、首屏与反馈
-
-每个空间说明镜头可见范围、主路线、可选风险路线和地标。第一帧只保留一个主要焦点；次级面板的
-折叠、隐藏或常驻都要有触发或产品理由。
-
-核心动词的输入、画面/声音反馈和状态变化应在同一节拍内闭合。高压后安排恢复；失败说明发生了什么
-以及玩家下次能改变什么。优先通过空间、人物反应和后果传递设定，不用百科文本替代世界响应。
-
-叙事承载体验时的场景、知识、分支和人物方法见
-[narrative-design-method.md](narrative-design-method.md) 与
-[dialogue-design-method.md](dialogue-design-method.md)。
-
-## 白盒试玩与局部修订
-
-白盒运行至少留下初始状态、内容/规则版本、seed、输入序列、事件日志与终态摘要。每次反馈定位为：
-`观察位置 → 预期/实际差异 → 状态/动作/知识/回响节点 → owner → 最小修改 → 重放路径`。自然语言可表达
-问题，问题标签便于聚类，结构化字段只修改被定位的节点；不要每次重写整份设计。
-
-文本、标签与表现资产通常可局部替换；变量语义、节点 id、行动效果、知识权限或不可逆承诺改变时，声明
-存档/日志迁移或明确失效。修订后先重放原失败路径，再跑一条会揭露分支污染的相邻路径。
+变量语义、行动效果、知识权限或不可逆承诺改变时，处理受影响的存档/日志或明确其失效。
+修订后重放失败路径与能揭露相邻污染的反例。验证只说明实际覆盖的效果，不证明主观趣味或长期平衡。