@oh-story/dsh 0.1.8 → 0.1.10

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

@@ -7,8 +7,7 @@ description: "Build a risk-matched whitebox or the approved production game for
 保护已批准的体验边界；正式生产时再保护已批准的美术边界。驱动实现模型完成真实可玩的候选，不在
 构建阶段重新做概念、关卡或美术方向。
 
-读取 [build-brief-contract.md](references/build-brief-contract.md) 与
-[playable-model-contract.md](references/playable-model-contract.md)。白盒阶段必须已有 `GAME_DESIGN.md`；
+读取 [build-brief-contract.md](references/build-brief-contract.md)。白盒阶段必须已有 `GAME_DESIGN.md`；
 完整候选还必须已有 `ART_DIRECTION.md`。缺产品决定时回对应 owner，不在 BUILD_BRIEF 就地发明。
 
 产物语言由 `PRODUCT_BRIEF.md` 锁定；未锁定时跟随对话语言，不默认产出中文。
@@ -19,14 +18,7 @@ description: "Build a risk-matched whitebox or the approved production game for
 目标工具链不可用时不得自动改做网页；只有 brief 已批准替代运行时才可使用，并分开记录
 `targetRuntime`、`testedRuntime` 与未覆盖项。
 
-正式生产继承美术方向的明度边界。非低照度题材不得在实现阶段擅自用全局黑罩、暗角、降曝光或低对比
-小字制造“电影感”；夜景也要保留人物、器物、行动与结果可读性。确需偏暗的界面只按已批准范围实现，
-并保留方向中约定的亮度或高对比 fallback。
-
-时代题材的高风险画风先接入一张实际目标图并在目标视口确认，再批量生产。目标图已批准后，后续资产
-必须继承同一时代世界、表现媒介、人物成熟度、身份锚点、光色和文本留白；不得把“当代审美”擅自实现成
-现代服装／棚拍，也不得把“古风”擅自实现成古画旧化。用户否决方向时停止扩批，替换运行引用并清理被
-否决资产，不能让旧图、试验图和批准图混在同一发布包。
+正式生产继承 `ART_DIRECTION.md` 的可观察视觉约束与批准目标图，在实际运行中验证焦点资产。
 
 BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式与完成证据，实现细节交给实现模型。
 
@@ -39,46 +31,36 @@ BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式
 
 ## 按能力读取可选合同
 
-- 语音策略不是 `none` 时读取 [tts-production-contract.md](references/tts-production-contract.md)。TTS
-  优先构建期生成成本地资产；运行时远程合成须在 brief 批准，密钥只留受信服务端。
-- 实际采用动态媒体时读取 [generative-media-pipeline.md](references/generative-media-pipeline.md)。已有批准
-  参考图时以图约束；工具与模型按当前环境选择，不写成跨项目默认。
+- 已选择 Blender 制作或修改可编辑三维资产时，读取 [blender-asset-workflow.md](references/blender-asset-workflow.md)；
+  不因项目是 3D 就默认采用 Blender 或安装 MCP。
+- 采用生成式自由输入、知识权限、事件回放、存档迁移或 `signature_command` 时，读取
+  [playable-model-contract.md](references/playable-model-contract.md) 的相关部分。
+- 语音策略不是 `none` 时读取 [tts-production-contract.md](references/tts-production-contract.md)。
+- 实际采用动态媒体时读取 [generative-media-pipeline.md](references/generative-media-pipeline.md)。
 
 ## 共同构建循环
 
 1. 先实现一个最小但完整的核心循环：启动、真实输入、状态变化、结果和重开。范围不足时修范围，
    不先堆审计材料。
-2. 先集中实现最小状态面与规则裁决器，再接表现层。模型可解释自由输入、提出候选动作或根据已提交结果
-   写对白；只有规则器能提交资源、位置、知识、承诺、物件归属、胜负与事件日志。
-   设计含 `signature_command` 时，先逐字继承 `id / label / intents / slots / validators / commit`，管线固定为
-   “表述 → 有版本的候选结构 → schema/前置/知识/承诺验证
-   → 执行阻力 → 确定性提交 → 叙述”；含混、冲突或越界候选返回澄清/拒绝且不提交，不能让关键词命中
-   或模型 `effects` 直接改状态。
-3. 固定内容/规则/存档版本、初态、seed 与输入序列；事件日志记录 action、观察者和前后状态摘要。专属
-   命令还记录解析器版本、规范化候选、验证结果、执行轨迹和到期事项；回放消费已记录候选，不重新调用
-   在线模型。试玩反馈定位到节点，局部 patch 后重放失败路径和相邻反例，不让未选分支进入历史。
+2. 实现 GAME_DESIGN 的状态、动作与结果；使用生成模型时，模型只解释输入和结果，规则器拥有提交权。
+   存在 `signature_command` 时再执行可选合同的专属边界。
+3. 保留能复现问题的初态与输入路径，涉及随机性时固定 seed；修订后重放失败路径与相邻反例。
 4. 回写实际工具链、install/build/start 命令和版本；未知值写 `NOT_AVAILABLE: 原因`，不猜。
 
-`whitebox` 到此只运行最窄的模型/回放检查与启动 smoke，输出结构化观察并交回 design owner；不调用
-`game-qa`，不写或覆盖 `qa/verification.json`，也不把白盒通过冒充生产候选完成。设计修订后重放受影响
-路径，直到最大风险已被实际暴露或当前方向被否决。
+`whitebox` 到此按 build-brief-contract「完成证据」运行最窄检查并交回 design owner；设计修订后
+重放受影响路径，直到最大风险已被实际暴露或当前方向被否决。
 
 `production` 继续：
 
 5. 提供一条权威验证命令和最小可观察状态，使 `game-qa` 能一次走完
-   `clean start → 核心动作 → 设计结果 → restart`；构建阶段不预写 QA 结论或重复跑完整验收。
+   `clean start → 核心动作 → 设计结果 → restart`。
 6. 运行最窄的开发检查与启动 smoke，修复构建失败、阻断日志、资源失败和崩溃；替代运行时未覆盖的
    目标平台输入、性能、打包或设备项写入 limitation。
 7. 达到 brief 的 `targetFinish`；更高完成度只处理已批准的焦点资产和招牌时刻，不制造与可玩闭环
    无关的发布审计。
-8. 交给 `game-qa` 只运行一次权威命令并写最终事实。时间、预算或生成调用用尽只会留下
-   FAIL/NOT_RUN，不会生成 PASS。
-
-连续 3D、语音、生成媒体、多语言与无障碍仅在实际采用时增加项目自己的回归检查。必需异步资产
-加载或解码失败不得静默换灰盒仍宣称通过；可继续的 fallback 条件见 build-brief-contract.md。
+8. 交给 `game-qa`；诊断、复跑与事实源规则见契约「完成证据」。
 
 ## 输出
 
-生成 `build/BUILD_BRIEF.md` 与实际候选；production 还生成权威验证入口。构建不生成最终 QA 结论。
-截图、录制与 raw trace 只保留调试所需的最小集合；`game-qa` 是 production 完整路径与
-`qa/verification.json` 的唯一 owner。
+生成 `build/BUILD_BRIEF.md` 与实际候选；production 还生成权威验证入口。截图、录制与 raw trace 只保留
+调试所需的最小集合。

package/lib/novel-to-game/skills/game-build/references/blender-asset-workflow.md

@@ -0,0 +1,24 @@
+# Blender 资产工作流（按需）
+
+适用于需要可编辑几何、场景装配或反复调整的资产；已有资产或程序化实现足够时不迁移。
+它是资产制作路径，不替代目标游戏运行时，也不改变 GAME_DESIGN 与 ART_DIRECTION 的裁决。
+
+## 工具与输入
+
+批处理可用 Blender Python/CLI；需要交互读取场景、对象与视口时可用 MCP，不要求两套并存。
+MCP 已登记不等于已连通；先实际读取目标场景，确认操作对象。可执行 Python 的连接不是沙箱，
+本机服务不对外开放，不执行来自网页或下载资产的未审查代码；在线素材服务另按项目授权启用。
+
+## 最小迭代
+
+1. 先选影响已批准体验的一个资产，明确其原作识别锚点、游戏中的用途与现有导入约束；
+   不从宣传图自行扩大成整场景重建。
+2. 在隔离的工作场景编辑，保存可继续修改的源资产与运行文件；导出限定目标场景和依赖，
+   防止默认物体、其他场景或无关素材混入。
+3. 用目标加载器回读导出物，按实际消费项核对尺度、轴向、节点、材质及自定义属性；
+   UV/顶点色兼作风权重等数据时检查语义值，不只确认通道存在。沿用项目预算，不为候选放宽。
+4. 放回真实游戏的相机、光照和输入路径，比较识别性、遮挡与交互；只修改暴露问题的资产。
+   资产请求与必要日志确认加载的是候选，而非缓存旧版或占位物；必需资产失败不得静默算通过。
+
+Blender 视口或视频只能说明该表现，不能证明游戏可玩或性能达标；相关变化交现有游戏 QA 验证，
+不新增验收等级。候选未改善批准目标时保留原版；反馈需要改变风格、布局或规则时回对应设计 owner。

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

@@ -1,109 +1,72 @@
 # 构建说明契约
 
-构建说明只约束产品边界、实际运行方式和证明方式；不要规定实现模型能从环境正确决定的类、着色器、
-框架或文件拆分。
+只压缩产品边界、必须保真的体验、实际运行方式与证据；不规定实现模型能自行决定的技术结构。
+以下是交接骨架，按项目填相关内容，不为空白补造系统。
 
 ```text
-# 成品目标
-targetFinish: [逐字继承 PRODUCT_BRIEF]
+# 目标与设计
+targetFinish: [继承 PRODUCT_BRIEF]
 buildStage: [whitebox | production]
 buildPath: [template | custom]
-[目标平台、目标交付物、受众、切片时长、视口/朝向/输入、分级、联网边界]
-
-# 必读设计
-- whitebox: [GAME_DESIGN.md]
-- production: [GAME_DESIGN.md, ART_DIRECTION.md]
+[平台、交付物、受众、范围、视口/输入、分级、联网边界]
+[whitebox 读取 GAME_DESIGN；production 追加 ART_DIRECTION]
 
 # 必须保真
-- 玩家承诺与核心幻想
-- experienceProfile: [逐字继承 GAME_DESIGN]
-- 3–5 个核心动词及各自输入、可观察状态变化
-- 会改变结果的规则、三段弧结束标记
-- 界面语言、人物声口和禁用句式
-- 叙事项目追加主要路径、结局条件、持久旗标读取点和人物知识边界
-- production 追加：每个界面/模式的招牌时刻、HUD 层级、主游玩面板的单焦点阅读边界与美术禁区
-
-# 可执行模型（两阶段都需要）
-- 最大风险与原型形态；采用 template 时列语法与脱离条件，custom 时列不可被模板替代的核心动词
-- 运行时真正消费的最小状态、动作、前置、效果、观察者/知识更新、事件和不变量
-- signature_command: [N/A，或 id / label / intents / slots / validators / commit；具体数量服从项目]
-- 到期事项与谈话回灌（实际采用时）：来源、due/trigger、携带事实、重新上桌、结清；谈话只提交已验证结构
-- contentRevision / rulesRevision / saveSchemaVersion / seed
-- snapshot 用于载入，event log 用于定位与重放；两者不能互相冒充
-- 固定验证路径：初态摘要、输入序列、预期终态/反馈、相邻反例
-- 反馈 patch：issue id、owner、目标节点、兼容性、受影响路径与重放结果
-
-# 范围
-[必须包含；明确排除；最终范围差异]
-
-# 运行与验证
+experienceProfile: [继承 GAME_DESIGN]
+[玩家承诺、核心动作及可观察变化、会改变结果的规则和结束标记]
+[产物语言与原作身份；叙事实际采用时记录路径、历史读取点和知识边界]
+[production 继承关键游戏时刻、视觉约束与批准目标图]
+
+# 最小实现与复现
+[最大风险、原型形态、复用语法及脱离条件]
+[运行时消费的状态、动作、前置、效果与不变量]
+[初态、输入路径、预期结果；随机性相关时固定 seed]
+[仅在采用生成式输入、知识权限、事件回放、存档迁移或专属命令时追加对应可执行模型合同]
+signature_command: [N/A，或继承 id / label / intents / slots / validators / commit]
+
+# 运行
 toolchain:
   targetPlatform: [批准平台]
-  targetRuntime: [计划交付的运行环境]
-  testedRuntime: [本次实际启动的运行环境]
+  targetRuntime: [计划交付环境]
+  testedRuntime: [本次实际启动环境]
   engine: [实际引擎/框架]
-  engineVersion: [实际版本或 NOT_AVAILABLE: 原因]
-  runtimeVersion: [实际版本或 NOT_AVAILABLE: 原因]
+  engineVersion: [版本或 NOT_AVAILABLE: 原因]
+  runtimeVersion: [版本或 NOT_AVAILABLE: 原因]
   packageManager: [name@version；无则 none]
 commands:
   install: [命令；无需安装写 NONE]
   buildOrExport: [命令；无需单独构建写 NONE]
   start: [命令]
-  modelCheck: [whitebox 的最窄模型/回放检查；production 可写 NONE]
-  verify: [production 的一条权威验证命令；whitebox 写 NOT_APPLICABLE]
+  modelCheck: [whitebox 的最窄风险检查；production 可写 NONE]
+  verify: [production 权威命令；whitebox 写 NOT_APPLICABLE]
 verification:
   owner: [whitebox 为 design owner；production 为 game-qa]
-  evidence: [whitebox 的结构化观察，或 production 完整运行生成的工作区相对路径]
+  evidence: [工作区相对路径]
 
-# 当前限制
-[scope / reason；testedRuntime 与 targetRuntime 不同时列目标独有未测试项]
+# 限制
+[实际范围差异、未测试项与原因；替代运行时不证明目标平台]
 ```
 
-## 最小完成证据
-
-whitebox 只证明被选中的最大风险：规则/场景模型能启动，固定路径可运行与重放，偏差能定位回
-GAME_DESIGN；不要求 ART_DIRECTION、最终 HUD、完整路径或 `qa/verification.json`，也不进入六项 QA 结论。
-
-production 的权威 verify 必须能在一次完整路径中证明：启动成功、非空且变化的真实渲染、真实输入改变状态、核心
-循环完成、至少一个设计结果可达、restart 回到定义初态。构建阶段只准备入口和可观察状态；由
-`game-qa` 实际运行一次并写结论。证据使用工作区相对路径，不能只留临时目录或逐点击截图。
-
-可执行模型、事件日志或 patch 存在时，verify 还应在项目回归中证明同版本同 seed/输入可重放、非法
-前置不提交、未选择分支不污染、未见证者不引用秘密，以及 patch 声明外的状态不变。这些诊断映射回
-六项玩家效果或写 limitation，不新增顶层 QA gate。
-
-测试环境与目标运行环境不同时，这六项只声明实际覆盖；源码身份、公网、营销、主观趣味、权利
-判断和完成度声明不进入这六项机器事实。
-
-## 条件台账
-
-### 视觉与必需资产
-
-只列批准的焦点资产与招牌时刻：资产键、生产状态、工作区证据和剩余问题。必需运行期资产失败必须
-阻断或进入明确错误界面；可降级项须预先写 fallback，并证明核心动作、状态、结果、可读反馈和重开
-仍成立。
-
-同时继承 `ART_DIRECTION.md` 的明度边界。非低照度题材检查首屏、核心循环、夜景和结果页，禁止用
-未经批准的全局黑罩、暗角、降曝光或灰色小字替代气氛设计；夜景至少能辨认人物轮廓与朝向、关键器物、
-行动目标、正文／选项和结果信号。批准的暗调界面须保留约定的亮度或高对比 fallback，并在目标视口
-用实际交互画面验证，而不是只验静态海报。
-
-时代题材另列目标图批准状态和三轴合同：世界时代、表现媒介、人物理想化程度。未批准前只生产最小
-样张；批准后批量资产必须引用目标图与身份母版，并继承光色、构图和文本留白。若用户否决样张，构建
-立即停止同方向扩批，替换所有运行引用并从发布目录清掉旧图、试验图和未引用变体。
+## 完成证据
 
-### 连续 3D
+whitebox 只证明选中的最大风险，保留可复现的实际观察并定位回 GAME_DESIGN；
+不要求最终美术、完整产品路径或 `qa/verification.json`，不进入六项 QA 结论。
 
-采用连续 3D 时记录输入控制权、相机/移动前向、失焦归零，以及会改变路线的可见布局与 collider
-边界。不要把渲染帧率或一条成功路线当碰撞证明。
+production 的权威 verify 必须在同一次完整运行中证明启动、真实渲染、真实输入、核心循环、
+至少一个设计结果与重开。证据留在工作区，不只保存在临时目录。
+构建者准备入口，不预填 PASS；game-qa 记录实际命令、退出码和结果。
 
-### 动态媒体与语音
+允许定向检查、修复和复跑；最终 `qa/verification.json` 原子替换为当前完整运行结果，
+失败不得残留旧 PASS，也不能拼接不同版本或不同运行的六项成功。
+有事件、知识权限或 patch 时，将其相关回归纳入项目验证，不另设顶层通用门禁。
 
-只记录游戏实际采用的媒体或语音资产、来源、运行文件、字幕/静音/缺音 fallback 和生成状态。密钥
-不入库；未生成写 `NOT_RUN: 原因`。生成请求、营销旁白和可重建中间文件不作为最小 QA 证据。
+## 按需交接
 
-## 权威验证
+- 视觉：只列批准的焦点资产、生产状态、运行中证据和剩余问题，继承 ART_DIRECTION，不重新裁决风格。
+  必需资产失败须明确报错；可降级项采用预先定义的替代，并验证玩家效果仍成立。
+- 连续 3D：记录控制权、相机/移动前向、失焦归零，以及改变路线的布局与碰撞边界；
+  帧率或一条成功路线不证明碰撞正确。
+- 动态媒体/语音：记录实际资产、来源、运行文件、字幕/静音/缺音替代与生成状态，
+  不把生成请求或营销旁白当成游戏运行证据。
 
-verify 可以组合现有游戏效果脚本，但最终 QA 只运行一次；由 `game-qa` 在 `qa/verification.json`
-回写实际 command、exit code、完整路径、六项结果和当前限制。构建者不得预填 PASS 或另跑一套平行
-验收。预算、时间或调用上限只会留下 NOT_RUN/FAIL、延期或缩小范围，不会替代证据。
+预算或工具缺口只能产生明确限制、NOT_RUN/FAIL 或经批准的范围调整，不能替代证据。

package/lib/novel-to-game/skills/game-build/references/generative-media-pipeline.md

@@ -1,56 +1,25 @@
 # 动态媒体生产合同
 
-仅当 `ART_DIRECTION.md` 已选择视频过场、环境循环或关键帧演出时使用。本文只规定改编连续性与
-交接边界；图片、视频工具和模型由当前环境决定，使用前按其官方文档核实能力、许可、费用与输出格式。
-
-动态媒体负责表现已批准的角色、场景和剧情状态，不重新设计人物身份、空间地理、玩法结果或镜头用途。
-
-## 采用判断
-
-- 固定构图、无需玩家改变视角或空间关系的短演出适合预渲染媒体。
-- 输入会改变视角、位置、碰撞或战术信息时使用实时场景，不用视频伪装交互。
-- 每条动态媒体都必须有静帧或低动效表达；跳过或降级后仍保留信息、节拍、输入机会和结果。
-- 只有 brief 明确把该媒体列为必需玩家效果时，缺失才阻断完整路径；否则使用已登记的 fallback，
-  并把完成度差异写入 limitation。
+仅在 ART_DIRECTION 选择动态媒体时使用。工具和模型由环境决定，使用前核实当前能力、许可与费用。
+媒体表现批准的状态，不重新决定人物身份、地理或玩法结果；需要改变视角、位置或空间关系时不能用视频伪装交互。
 
 ## 最小台账
 
-不要为每个供应商建立一套目录和审批流。在 BUILD_BRIEF 或资产台账中每条只记录：
-
-`asset_key | state_trigger | duration | references | locked_facts | allowed_motion | start_boundary | end_boundary | output | fallback | provenance | status`
-
-- `references`：已批准的角色、造型、场景或构图参考；声明各自允许控制的事实。
-- `locked_facts`：不得漂移的身份、服装、地理、道具状态、色板与材质。
-- `allowed_motion`：本镜允许发生的角色动作、状态变化和运镜，不重描外观。
-- `start_boundary` / `end_boundary`：镜头两端的位置、朝向、持物、服装、光线和剧情状态。
-- `provenance`：输入与输出的来源、权利边界和工作区路径；真实人物参考须有明确授权。
-
-## 生产顺序
-
-1. 先冻结持久事实与本镜临时状态，再生成关键帧或动态结果；不要用提示词临时补设计空白。
-2. 已有可用参考时做受控变体，只描述本镜差量；没有参考时才从风格与事实锁生成第一张基准图。
-3. 先用低成本草稿检查身份、构图、动作和边界，成立后再产最终尺寸；不要把分辨率当连续性。
-4. 输出立即保存到工作区并使用稳定文件名；临时下载地址、供应商任务页和缓存不是游戏资产。
-5. 密钥只留在受信环境。只在复现故障确有需要时保留去密钥请求摘要，不默认归档完整 API 往返。
-
-## 连续性检查
+在 BUILD_BRIEF 或资产台账记录：
 
-对每条媒体只检查会影响玩家理解的事实：
+`asset_key | state_trigger | references | locked_facts | allowed_motion | start_boundary | end_boundary | output | fallback | provenance | status`
 
-- 首、中、尾代表帧中的角色身份、临时造型、场景地理、道具状态和色板没有无依据漂移；
-- 上一镜 `end_boundary` 能接到下一镜 `start_boundary`；
-- 设计规定的状态变化发生在正确镜头，未提前泄露或丢失；
-- 没有凭空增加人物、道具、肢体或第二个主角；
-- 正常速度下动作、字幕与输入窗口可读，跳过后仍进入同一合法状态。
+- 参考声明允许控制的事实；锁定身份、服装、地理、道具状态与已批准风格。
+- 本镜只改变允许的动作与状态；开始/结束边界需能衔接相邻镜头。
+- 来源与权利可追溯，真实人物参考须有明确授权；不上传与本资产无关的原文或私人信息。
 
-这是构建检查，不新增真人审片或独立 QA 门禁。审美偏好保留为主观风险；只有身份、状态、边界或
-可读性破坏批准设计时才回流修复。
+## 连续性与运行验证
 
-## 接入与失败
+检查代表帧中的身份、地理和道具是否漂移，状态变化是否发生在正确镜头，
+是否泄露未获知事实；已有参考时用其约束变体，不用提示词临时补设计空白。
 
-- 由游戏状态机触发，预载、播放、跳过、失焦、静音和资源释放行为必须明确。
-- 运行环境不能解码最终格式时，在构建期转成目标环境支持的格式，不在运行时临时请求供应商。
-- 可降级资产失败时落到台账中的 fallback；必需资产失败时显示明确错误并让对应玩家效果 FAIL。
-- 项目自己的媒体诊断映射回既有六项可玩结果，不生成媒体专属 PASS、报告或重复证据对象。
+在实际触发位置验证播放、跳过与降级。跳过或低动效版本仍进入同一合法状态，
+保留必要信息、输入机会和结果。最终运行文件保存在工作区，供应商任务页不是资产。
 
-BUILD_BRIEF 字段见 [build-brief-contract.md](build-brief-contract.md)。
+必需媒体失败时明确报错；可降级媒体采用已定义替代并记录完成度差异。
+相关诊断映射到现有六项玩家效果或 limitation，不另造媒体 QA 等级。

package/lib/novel-to-game/skills/game-build/references/playable-model-contract.md

@@ -1,81 +1,46 @@
 # 可执行改编模型合同
 
-可执行模型只保存当前候选运行时必须消费的因果语义，不复制策划理由、美术方向或整份内容库。若项目
-已有代码原生状态机、对话引擎、规则表或引擎场景图，可直接把它声明为模型；不要为了文件名再造一份
-平行 JSON/YAML。独立数据文件只有在运行时实际加载，或作为测试合同逐项对照实现时才存在。
+仅在生成式自由输入、知识权限、事件回放、存档迁移或专属命令需要时读相关部分。
+复用已有状态机、对话引擎或场景图，不为了合同再造平行 JSON/YAML；
+独立数据只有被运行时消费或被测试逐项对照时才存在。
 
-## 选择原型与构建路径
+## 生成模型与规则的边界
 
-先按最大风险选白盒：
+模型可解释输入、提出动作候选、写对白或表达已确认结果；规则器唯一提交时间、资源、位置、
+物件、知识、承诺、胜负与事件。候选按适用的 schema、前置、数值范围、知识权限和原作边界验证。
 
-| 风险 | 最小可用形态 | 不能据此证明 |
-|---|---|---|
-| 知识、承诺、分支回响 | 文本/场景状态沙箱 | 操作手感、空间与镜头 |
-| 资源、门槛、策略反制 | 回合状态板或桌面沙箱 | 实时节奏与物理 |
-| 两层互相读写 | 场景叙事 + 最小系统 | 未实现层的完整质量 |
-| 走位、视线、相机、物理 | 目标引擎灰盒 | 最终美术完成度 |
+表现层只读取已提交状态。换文字、镜头、动画或三维表现不能改变因果、观察者、归属或后续回读。
+秘密、证词与误判区分世界事实、玩家知道、人物知道或相信；普通事实不维护多层知识模型。
 
-`template` 表示已有交互语法能直接承载核心动词；记录模板提供什么、原作改变什么、何时必须退出模板。
-`custom` 表示核心动作依赖模板没有的操作或世界规则。路径只决定复用方式，不决定题材或成色。
+## 身份专属命令
 
-## 最小语义面
+仅实现 GAME_DESIGN 已选的 `signature_command`，继承
+`id / label / intents / slots / validators / commit`，不扩展成通用聊天。
 
-按项目需要定义，不要求所有字段：
+解析器输出有限候选；schema、前置、资源、执行人可用性、空间权限、人物知识、
+冲突承诺或原作边界失败时，返回澄清/拒绝且不提交。
+否定、条件和互斥表达不能按关键词猜成相反行动。
 
-```text
-version: content / rules / save schema
-state: stable id / type / initial / visibility / invariant / source anchor
-action: id / actor / preconditions / costs / effects / observers / reveals / consumes
-event: action / before+after summary / witnesses / seed use / future callback
-knowledge: world fact / player knows / character knows or believes / open question
-commitment: who promised what / to whom / when it becomes irreversible / later reader
-validation path: initial state / seed / inputs / expected state / expected feedback
-```
+规则器输出执行轨迹与实际结果，再提交资源、物件、知识、关系、证物、见证和到期事项；
+叙述器只表达已确认事实。在线解析记录解析版本、规范化候选与验证结果，
+确定性回放从候选开始，不再次请求模型。
 
-只对会改变玩家决策或产生泄密风险的事实维护知识权限；普通环境事实无需多层心智模型。事件账本保留
-“发生过什么”，关系或资源保留“现在是什么”；只存终值无法解释回响，只存事件也不适合即时载入。
+私人谈话若能改变主线，只提出事实、承诺、权限、拒绝或见证候选，经同一规则验证；
+自由效果字段、聊天摘要或忠诚估值不能直接成为状态权威。
 
-## 裁决边界
+## 延期后果
 
-规则器唯一提交时间、资源、位置、物件归属、知识、承诺、胜负和事件。生成模型可解释自由输入、提出
-合法动作候选、写对白或根据已确认结果组织表达，但不能直接改最终状态。输出需先通过 schema、前置、
-数值范围、知识权限、原作边界和分支污染检查。
+记录来源行动、到期条件、携带事实、当前状态、重新进入决策面的方式与结清事件。
+载入或回放不得提前触发、重复触发或让已结事项复活。
 
-表现层只读取已提交语义。同一个事件可渲染为文字、镜头、动画或 3D 交互，但换表现不能更改原因、
-观察者、物件归属、知识披露或后续回读。
+## 回放与兼容性
 
-## 身份专属命令（按需）
+需要载入时用快照，需要重演时保留事件和规范化输入；不要求每个游戏同时维护两套存储。
+同一内容/规则版本、初态、seed 与规范化动作序列应复现规则终态和事件顺序；
+在线生成表达不参与权威状态比较。
 
-只有 GAME_DESIGN 选择 `signature_command` 时实现，并逐字继承其 `id / label / intents / slots /
-validators / commit` 六组结构；各组的具体条目数量服从项目。输入解析器把角色化表述变成有限候选，
-不拥有结算权；候选按项目需要携带 intent、执行人、对象、物件、地点、可见范围、期限等槽位。schema、前置、资源、
-执行人可用性、空间权限、人物知识、冲突承诺和原作边界任一失败时返回结构化澄清/拒绝，状态保持不变。
+回滚遵循已批准设计。节点标识、变量语义、行动效果或知识权限变化时迁移或明确拒绝旧存档/日志，
+不能静默重解释。局部修改声明基础版本、目标、预期差异与兼容性，重放失败路径及相邻反例，
+检查修改范围外的不变量。
 
-规则器再输出执行轨迹与实际结果：每一阻力环节说明通过、拒绝或部分完成，提交资源/物件/知识/关系，
-创建证物、见证与到期事项；叙述器只把这些已确认事实写成场面。否定、条件和互斥表达不得靠关键词猜成
-相反动作。若使用在线模型解析，日志保存 parser version、规范化候选与验证结果；确定性回放从候选开始，
-不再次请求模型。
-
-私人谈话若会改变主线，也走同一边界：模型只提出 `facts / promises / permissions / refusals / witnesses`
-候选，规则器验证后写入事件账。不得让自由 `effects`、原始聊天摘要或忠诚估值直接成为权威状态。
-
-## 到期事项
-
-延期后果记录 source action、due/trigger、携带的执行人/物件/见证/承诺、status、重新上桌方式和结清事件。
-到期时必须形成当前可见压力、机会或再次裁决；载入/回放不得提前触发、重复触发或让已结事项复活。
-
-## Snapshot、事件日志与回放
-
-- snapshot 服务快速载入，带内容/规则/存档版本；event log 服务定位、重演与测试。
-- 同一版本、初态、seed 和规范化动作输入序列必须得到同一终态与事件顺序；在线生成表达不进入裁决 hash。
-- 回滚模式由设计声明：自由重选、固定历史仅回看、或明确不可逆节点。渲染和 UI 回调不得偷偷改状态。
-- 节点 id、变量语义、行动效果、知识权限改变时提供迁移，或明确拒绝旧存档/日志；不得静默重解释。
-
-## 反馈与局部 patch
-
-反馈记录 `issue → observation → expected/actual → node → owner → patch → replay`。自然语言负责表达复杂
-偏差，标签负责聚类，结构化修改只触及被定位节点。patch 声明基础规则版本、目标节点、预期差异、
-存档兼容性和受影响路径；修改后重放原失败路径及一条相邻反例，确认声明外状态没有变化。
-
-白盒只回答被模拟的风险是否暴露、规则是否可执行和结果为何发生。选择是否困难、角色是否吸引人、
-节奏是否愿意重玩仍需真人研究，不写成确定性 PASS。
+这些检查只证明被覆盖的因果与回放，不证明角色魅力、选择重量或复玩意愿。

package/lib/novel-to-game/skills/game-build/references/tts-production-contract.md

@@ -1,37 +1,23 @@
 # 语音资产生产合同
 
-只在 `ART_DIRECTION.md` 已选择角色语音、旁白或朗读时启用。语音表现已批准的台词和角色方向，
-不创造新剧情，也不成为规则、目标、选择或结果的唯一载体。
+只在 ART_DIRECTION 已选择语音时启用，表现已批准台词，不创造剧情或成为必要信息的唯一载体。
 
-## 产品边界
+## 授权与数据边界
 
-- 默认在构建期生成或录制成本地资产，游戏运行不依赖网络、供应商或密钥。
-- 运行时动态语音只有在 PRODUCT_BRIEF 已批准联网、外部文本处理、成本、隐私和服务失效行为时采用；
-  客户端不持有服务密钥。
-- 只发送逐句台词与必要读音，不上传小说、SOURCE_BIBLE、设计文档、未公开手稿或无关个人信息。
-- 营销旁白与游戏内语音分别记账；一次成功不自动扩大到全量配音。
+默认构建期生成本地资产。运行时合成须由 PRODUCT_BRIEF 批准联网、外部文本处理、成本、隐私与失效行为；
+服务密钥不进入客户端、仓库、日志或证据。只发送逐句台词与必要读音，不上传小说、设计文档或无关私人信息。
 
-## 唯一台账
+音色来源须有使用权，真实人物克隆须明确许可。营销旁白不等于游戏语音，一次成功不自动扩大到全量配音。
+工具按当前能力与许可选择，不固定供应商或模型。
 
-每条采用语音只记录一行：
+## 台账与验证
 
-`line_id | speaker | trigger | exact_text | language/pronunciation | voice_direction | subtitle_key | provenance/rights | output | fallback | status`
-
-- 字幕和语音输入由同一 `exact_text` 派生；台词变化时旧音频失效。
-- `speaker` 继承美术方向的年龄感、节奏、文化依据和可听辨差异，不按语言给所有角色共用一个声线。
-- 音色只使用自录、获授权真人、获授权公共音色或合成设计音色；真实人物克隆需要明确许可。
-- `fallback` 至少保证静音、缺文件和自动播放受限时仍能读懂并完成游戏。
+每条采用语音记录：
 
-## 生产与检查
-
-1. 使用当前环境中合适的工具，按官方文档核实许可、输入处理和输出格式；仓库不固定供应商或模型。
-2. 密钥只从受信环境读取，不进入仓库、客户端、日志正文或证据文件；失败重试有明确上限。
-3. 把最终音频保存到工作区稳定路径；临时 URL、供应商任务页和缓存不是游戏资产。
-4. 确认文件非空、可被目标运行时解码，时长/声道/响度合理，并在实际触发位置播放一次。
-5. 检查字幕同步、说话者标识、专名读音、重复频率、跳过、静音、损坏文件和重开路径。
+`line_id | speaker | trigger | exact_text | language/pronunciation | voice_direction | subtitle_key | provenance/rights | output | fallback | status`
 
-自然度、魅力和音色偏好不写成机器 PASS，也不新增强制真人听审。可降级语音失败时保留字幕或普通
-音效并记 limitation；brief 明确列为必需的语音失败时，对应玩家效果 FAIL。
+字幕与语音来自同一台词，台词变化使旧音频失效；说话者继承批准的声口、文化身份和可辨差异。
+最终文件保存到工作区，在实际触发位置检查说话者、专名读音、字幕、跳过、静音、缺音和重开。
+降级后仍能理解并完成游戏；必需语音失败映射到对应玩家效果，否则保留替代并记 limitation。
 
-构建完成后只回写上述台账的本地输出、来源/权利、基本媒体信息和结果，不归档完整 API 往返、供应商
-页面截图或重复报告。
+不归档完整服务往返或重复报告。自然度、魅力和音色偏好不写成机器 PASS，也不新增强制真人听审。

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

@@ -1,6 +1,6 @@
 ---
 name: game-concept
-description: "Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_BRIEF, generate three genuinely different directions on the dimensions still unlocked, then pick the most worthwhile playable prototype using hard vetoes and explicit trade-offs. Use for what game should this novel become, compare game concepts, choose a game direction for this book, decide whether this novel should become an interactive story. 小说游戏概念设计。根据 SOURCE_BIBLE 与 PRODUCT_BRIEF 在未锁定维度上生成三个真正不同的方案，用硬否决和关键取舍选择最值得做的可玩原型。用于判断小说适合做成什么游戏、该不该做成互动叙事、比较游戏方案等需求。"
+description: "Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_BRIEF, compare meaningful alternatives on the dimensions still unlocked, then select a playable direction using hard vetoes and explicit trade-offs. Use for what game should this novel become, compare game concepts, choose a game direction for this book, decide whether this novel should become an interactive story. 小说游戏概念设计。根据 SOURCE_BIBLE 与 PRODUCT_BRIEF 比较未锁定维度上的有效替代方案，用硬否决和关键取舍选择可玩方向。用于判断小说适合做成什么游戏、该不该做成互动叙事、比较游戏方案等需求。"
 ---
 # 游戏概念设计
 
@@ -17,56 +17,38 @@ description: "Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_B
 时回总入口修订，不在概念阶段静默改值。原作语言、文化语境、目标市场和界面语言分别处理，不从
 其中一个自动推出另一个。
 
-先例只用于解释玩法为什么可识别：选一个最接近核心动词与循环的主要玩法先例，必要时再补一个解决
-独立问题的辅助先例。写清借用的动词/循环/结构与明确不借的内容，不要求销量数字、固定名单或为每个
-方向重复市场研究。外部事实只有在会改变选择且可能变化时才核实。
-
 互动叙事是成熟玩法，不因以阅读和对白承载就降低标准；它的动词可以是读局面、追问、比对信息、
-表态、隐瞒、交出与承担回响。先例提供语法，原作规则负责改变动作对象、顺序、代价和世界回应，
-不能只做 IP 换皮。
+表态、隐瞒、交出与承担回响。
 
 概念还要判断验证形态：可用成熟交互语法表达时说明“已有语法 + 原作如何改变它”；核心依赖实时手感、
 空间、视线、物理或独特操作时明确走自定义灰盒。不要把文本原型当所有体验的统一前置层，也不要因有
 模板可用就让模板替原作决定玩法。
 
-## 三个方向
-
-先列 brief 的锁定维度和仍开放的维度。三个方向必须在至少三项开放维度上真正不同，例如玩家身份、
-子类型、核心循环、压力来源、原作选段、空间/镜头、成长关系或美术方向；已锁的主玩法不可偷换，
-未锁的核心循环可以正面比较。
-
-每个概念卡只回答：
+## 比较范围
 
-- `player_job`：玩家以什么身份长期做哪份工作，想获得什么独特幻想；
-- `recurring_job_loop`：这份工作每个周期反复做什么；
-- 主类型、`experienceProfile`、主要玩法先例，以及本作借什么/不借什么；
-- 3–5 个核心动词、循环、压力、失败和世界响应；
-- `signature_command`：只有当自然语言表达本身能体现该身份时，写 `id`、`label` 与候选 `intents`；
-  不合适时明确 `N/A`，不得给所有游戏统一添加聊天框；
-- `resistance_chain`：谁或什么会阻止、拒绝、扭曲或泄露玩家的安排；
-- `advancement_ladder`：玩家在探索、成长、成熟阶段分别新学会什么、新能组合什么；
-- 原作独有的规则或情感/伦理张力怎样被玩家亲手 enact，而不是留在过场；
-- 一张能同时看出身份、动作与世界特征的招牌画面；
-- 最小验证切片、最大风险，以及什么观察结果会否决该方向。
+先列 brief 的锁定维度和仍开放的维度，只比较能揭示真实取舍的方向，不凑概念数量或差异维度。
+仅在方向仍开放时考察可信替代；用户已选定方向或不存在有效替代时说明原因，改为验证该方向的风险，
+不重开选择。
 
 ## 选择
 
-先按 concept-method 的硬否决逐个淘汰，不计算总分。再比较原作适配、玩家能动性、可读性、文化
-准确性、传播画面和完成风险。`quick` 自动选证据最强的方向；`director` 给出推荐后等待用户决定。
+先按 concept-method 的硬否决逐个淘汰，不计算总分，再按其比较维度选择。`quick` 自动选证据最强的
+方向；`director` 只对尚未决定的方向给出推荐并等待用户选择。
 
 ## 输出
 
 生成一个 `concepts/CONCEPT.md`，只含：
 
 1. brief 锁定值与开放维度；
-2. 三条体验支柱，各配可观察现象和失败现象；
+2. 体验承诺及其可观察现象和失败现象；
 3. 紧凑先例说明；
-4. 三个概念卡；
+4. 候选概念卡：主类型、`experienceProfile`、借用/拒绝的玩法先例、核心动作与循环、压力、失败、
+   世界响应；说明玩家身份如何形成反复行动、执行阻力与可观察变化，不要求独立的固定键名。
+   `signature_command` 按方法「身份专属命令」写值或 `N/A`；最后说明原作张力如何由玩家亲手 enact、
+   招牌画面、最小验证切片、最大风险和否决观察；
 5. 硬否决结果、关键取舍、推荐与选择状态；
-6. 选定方向的 `experienceProfile`、玩家能动性合同、不可妥协体验承诺，以及五项独立交接字段：
-   `player_job`、`recurring_job_loop`、`signature_command`（或 `N/A`）、`resistance_chain`、
-   `advancement_ladder`；
+6. 选定方向的玩家能动性合同、不可妥协体验承诺；
 7. 最小验证问题与开放问题。
 
-`narrative-led` 或 `hybrid` 的叙事层还要选择一种分支结构语法并说明内容预算。概念不得写伤害公式、
-具体百分比、敌人血量、代码结构或逐场脚本；交接前确认选定方向可在 brief 范围内做成完整切片。
+`narrative-led` 或 `hybrid` 的叙事层还要选择一种分支结构语法并说明内容预算。交接前确认选定方向
+可在 brief 范围内做成完整切片。