@lemoncat7/dsh-partner 2.8.1 → 2.8.2

package/resources/skills/novel-game-creation/upstream/skills/game-world-design/references/world-design-method.md

@@ -0,0 +1,57 @@
+# 游戏世界设计方法
+
+## 可被推翻的体验假设
+
+把体验承诺落到玩家动作、可见变化和失败现象。切片范围服从 brief，保真度只覆盖最大风险：
+文本可以验证叙事因果，不能证明实时操作、空间、物理或镜头成立。
+
+每个系统必须改变核心决策；删除或自动处理后体验不变的系统应删减。不要用统一时长、系统数量、
+角色层级或关卡五拍替代项目范围判断。
+
+## 可执行因果
+
+只写运行时真正需要的规则：
+
+`当前状态 + 玩家行动 + 世界规则 → 新状态 + 可读反馈 + 后续机会`
+
+关键动作说明前置、效果、不可突破的不变量和后续读取点；需要引用或回放时使用稳定标识。
+只对秘密、证词、欺骗等高风险事实区分世界事实、玩家知道、人物知道或相信，不为普通事实维护心智模型。
+
+用代表路径检验承诺：玩家行动怎样改变原因或方向，世界又怎样回读该行动。
+按既定体验区分因果重演与策略取舍：能按原著步骤通关，不等于存在有意义的取舍。
+仅在承诺策略取舍时，给出选择间的代价与后果，以及能暴露无脑通解或伪选择的局面；
+单解谜题或线性重演可成立，不为满足此检查擅加多解、成长或新系统。
+承诺复玩时才要求可再生的不确定性。
+
+## 身份专属命令与延期回响
+
+只有 CONCEPT 选中 `signature_command` 时使用本节：
+
+`玩家表述 → 解析候选 → 澄清或拒绝 → 规则验证 → 执行阻力 → 提交实际结果 → 证物/知情变化 → 到期回响`
+
+GAME_DESIGN 固定 `id / label / intents / slots / validators / commit` 六组最小结构。
+候选字段按本项目需要选择，不要求统一数量或字段全集。否定、条件、互斥要求或不支持的语义
+必须澄清或拒绝，不能靠关键词命中静默反转玩家意思。
+
+规则器拥有提交权：分别判断资源、执行人意愿、空间权限、人物知识、冲突承诺与原作边界。
+反馈区分“玩家安排”与“实际执行”，显示留下的证物、见证和到期事项，不用生成叙事掩盖结算。
+
+延期事项保留来源行动、到期条件、相关人物/物件/承诺、当前状态与结清事件；到期时必须回到
+决策面，不能只追加装饰文本。若私人谈话能改变世界，也只提出事实、权限或承诺候选，
+经同一规则验证后提交；原始聊天和模型数值不是状态权威。
+
+## 进程与世界响应
+
+以本项目的完整路径组织局面变化和结束标记，不强套探索、成长、成熟三阶段。
+作为卖点的原作规则必须在运行中影响机会、代价或人物行动，不能只在说明里存在。
+若忽略一段规则仍得到近似结果，删除该段或补足其真正影响，不靠新增系统掩盖问题。
+
+叙事承担体验时，知识、人物与分支边界见 [narrative-design-method.md](narrative-design-method.md)。
+
+## 白盒反馈与局部修订
+
+保留足以复现的初态、输入路径与终态；涉及随机性时固定 seed，涉及事件回放时记录内容/规则版本与事件。
+反馈定位到“观察位置、预期/实际差异、所属规则、owner、最小修改、重放路径”，不每次重写整份设计。
+
+变量语义、行动效果、知识权限或不可逆承诺改变时，处理受影响的存档/日志或明确其失效。
+修订后重放失败路径与能揭露相邻污染的反例。验证只说明实际覆盖的效果，不证明主观趣味或长期平衡。

package/resources/skills/novel-game-creation/upstream/skills/novel-game-analyze/SKILL.md

@@ -0,0 +1,68 @@
+---
+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](references/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，不得把既有事实改写成
+切片说辞。
+
+来源范围只记录会影响复核的版本、覆盖范围和授权边界。下载日期、字节数、校验值和
+本地路径只有在复现契约确实需要时才写，不把获取日志当策划内容。
+
+其余完成门禁见协议「事实保真与交付」。

package/resources/skills/novel-game-creation/upstream/skills/novel-game-analyze/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Gameable Book Analysis"
+  short_description: "Extract gameable canon from a novel · 从小说中提取可玩的原作事实"
+  default_prompt: "Use $novel-game-analyze to extract a source bible this novel's game design can build on."

package/resources/skills/novel-game-creation/upstream/skills/novel-game-analyze/references/gameability-protocol.md

@@ -0,0 +1,65 @@
+# 游戏化全书拆解方法
+
+长篇分析采用稳定边界、逐单元提取、分层聚合和原文回查。这里只提炼游戏设计事实，不评价文风，
+也不提前选择游戏类型。
+
+## 一、来源与覆盖
+
+记录作品版本、改编范围、单元边界、缺失部分和授权边界。除非用户明确限定范围，分析集合应与
+来源边界集合一致；无法读取的部分要标为部分分析，不能用抽样冒充全书覆盖。
+
+长篇可把稳定边界表写入 `analysis/_coverage.md`，用于分批、恢复和缺号检查。已有拆文产物只有在
+逐单元覆盖与原文边界一致时才可复用为全量分析；临时工作卡完成聚合后可以删除。
+
+## 二、逐单元取证
+
+每个来源单元保留覆盖状态与证据位置，已审无相关发现也计入覆盖；未审或失败单独标记。
+以下是审阅维度，不是每章必填表。只记录有依据且影响改编的发现，不用空字段占位：
+
+| 字段 | 只记录什么 |
+|---|---|
+| 客观变化 | 谁做了什么，哪项状态、关系、资源、位置或认知因此变化 |
+| 动作候选 | 可被玩家重复执行且允许选择、反馈或熟练度差异的动作；含有原作依据的命令、委托或代办 |
+| 规则证据 | 触发条件、代价、例外、反制和可观察后果 |
+| 行动者 | 目标、默认行动、资源、底线、可下达/承接的事及其变化 |
+| 空间 | 入口、出口、门槛、地标、风险和可改变部分 |
+| 物件与能力 | 输入、效果、限制、归属和是否只出现一次 |
+| 知识与信息差 | 谁知道、误信、隐瞒或说谎，靠什么载体建立 |
+| 节奏与感受 | 压力怎样建立、释放或反转，玩家通过何种行动感受 |
+| 视听锚点 | 有原文依据且服务识别或反馈的轮廓、材质、声音和场面 |
+| 证据与边界 | 原文位置、推断、冲突、未定义和衍生混入风险 |
+
+提取结果保留可观察事实及其游戏化意义，不复述整章剧情。
+
+## 三、从事实得到系统候选
+
+不要把叙事元素自动映射成类型。对反复动作、世界规则、关系、地点、信息差和情绪承诺分别问：
+玩家能做什么决定，世界如何反馈，什么状态会持续到下一步，重复后能否产生学习或不同结果。
+一次性高潮可以保留为标志性场面，不能假装成核心循环。
+
+对命令或代办再区分：提出者想做什么、实际执行者能做什么、经过哪些人物/空间/权限、留下什么证据与
+见证、何时重新成为问题。原文中反复成立的“下令不等于办成”可成为系统候选；单次传话不能据此推断
+通用自由输入或完整委托系统。
+
+原作事实只用四种边界：`immutable`、`adaptable`、`open`、`conflicted`。玩家身份未锁定时，
+比较主角、原创角色、势力或聚落、观察者能访问的动作和决策空间；已锁定时只验证该身份。
+
+## 四、分层聚合
+
+按三层压缩：
+
+1. **单元层**：保留局部事实、变化和证据位置；
+2. **阶段层**：按剧情目标、地点、能力阶段或规则簇整理压力、转折和可重复结构；
+3. **全书层**：找反复成立的因果、角色能动性、空间语法、情绪承诺和独有视听身份。
+
+全书层主动找反例和最终回收，避免把只在开篇成立的现象写成硬规则。秘密、谎言、证词或立场
+冲突驱动原作时，再整理知识权限和铺垫回收；原作没有这类结构就不为凑表格编造。
+
+## 五、事实保真与交付
+
+数值、能力边界、人物关系、死亡和结局必须回查原文。聚合结论引用最早建立、典型运作、重要
+反例和最终回收位置；冲突保留各自证据并标为 `conflicted`，未定义内容进入开放设计空间。
+角色断言不自动等于世界事实，相邻实体的属性也不能互相挪用。
+
+`SOURCE_BIBLE.md` 只保留会影响概念选择的事实、边界和必要证据。交付时确认来源范围明确、
+覆盖集合完整、核心规则可追溯，并能回答玩家可能做什么、在哪里做、世界如何回应。

package/resources/skills/novel-game-creation/upstream/skills/novel-to-game/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: novel-to-game
+description: "Turn a novel into a fully playable game on the selected target platform. Orchestrates the whole adaptation pipeline — requirements intake, gameable deconstruction, concept selection, world and visual design, target-runtime build, and evidence-based QA — for a novel in any language. Use for novel to game, story to game, book to game, adapt this novel into a game, turn this book into a playable prototype, make an interactive story or text adventure from this novel. NovelToGame 总入口。把任意语言的原始小说、拆文库或 oh-story 写作工程转成有原著依据、可在目标平台完整游玩的游戏，编排游戏化拆解、概念选择、游戏与视觉设计、目标运行环境构建和证据化质量验证。用于小说转游戏、把这本书做成游戏、把小说改成互动小说 / 互动叙事 / 文字冒险游戏等需求。"
+---
+# NovelToGame 总入口
+
+你是小说游戏化总导演：守住改编判断、阶段边界和完成证据，不把普通原型包装成趣味、平衡、权利或
+发布质量结论。开始前读取 [pipeline-contract.md](references/pipeline-contract.md)。
+
+## 默认策略
+
+先速读来源并替用户起草 `PRODUCT_BRIEF.md`，再按
+[intake-method.md](references/intake-method.md) 只处理会实质改变方向或带来权利、尺度、平台风险的
+歧义。低风险空白集中列为未确认假设，不逐项拦停。
+
+`targetFinish` 只表示想做到的成色：`graybox`、`playable-prototype`、`polished-vertical-slice` 或
+`showcase`，不改变六项最小 QA，也不形成第二套验收等级。
+
+`PRODUCT_BRIEF.md` 与 `SOURCE_BIBLE.md` 是上游事实，下游不得静默改写。
+
+## 模式
+
+- `quick`：默认；用推荐草案推进，比较有效替代后自动选择并完成全流程。
+- `director`：给出候选和推荐后停靠，等待用户选方向；已有明确选择时不重复停靠。
+- `resume`：读取 `_progress.md` 和实际产物，从最早未完成的交接继续。
+
+## 流程
+
+1. 建立工作区，记录来源、模式、当前阶段和未确认假设。
+2. 生成 `PRODUCT_BRIEF.md`；高风险歧义未解决时才停靠。
+3. 调用 `novel-game-analyze` 生成有原文依据的 `SOURCE_BIBLE.md`。
+4. 调用 `game-concept` 比较仍开放的方向并选定 `CONCEPT.md`；自然语言专属命令按玩法需要选择，
+   不适用时明确 `N/A`；`director` 的待决方向在此停靠。
+5. 调用 `game-world-design` 生成 `GAME_DESIGN.md`，其中锁定最大设计风险与最小可执行切片。
+6. 在完整美术生产前调用 `game-build` 做与最大风险匹配的白盒候选；试玩后把偏差交回 design owner
+   局部修订并重放受影响路径，不能用文本模拟结果冒充空间或操作验证。
+7. 调用 `game-art-direction` 生成 `ART_DIRECTION.md`；只有目标成色需要时再制作视觉目标包。
+8. 再由 `game-build` 将验证后的因果语义实现为完整候选，`game-qa` 验证最小闭环；问题按
+   product/design/art/build 归属回流，不让实现阶段静默重做策划。
+
+## 语言与文化
+
+接受任意语言小说。产物使用用户指定语言，未指定时跟随对话语言；原文证据保留原语言，跨语言只补
+决策所需译文并维护一个术语表。原作文化语境、目标市场和界面语言分别记录，不用逐字翻译替代本地化判断。
+
+## 改编判断
+
+- 剧情必须转成玩家动词、选择和世界反馈，而非逐章复演。
+- `experienceProfile`（`system-led` / `narrative-led` / `hybrid`）由 brief 起草、概念阶段确认，之后
+  贯穿设计、美术、构建与 QA；它只改变判据表达，不降低完成要求。
+- 玩家选择要拥有因果权与结算权，不能用卡牌、回合或资源条伪装能动性。
+- 生成模型可以解释输入和写表达，状态提交、知识披露、资源结算与不可逆承诺必须由可重放规则裁决。
+- 自然语言只在能体现玩家身份的专属命令上按需开放；它先编译成有限候选，再经过执行阻力、规则提交、
+  证物/见证反馈与延期回响，不能退化成通用聊天或“说了就发生”。

package/resources/skills/novel-game-creation/upstream/skills/novel-to-game/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "NovelToGame"
+  short_description: "Turn a novel into a playable game · 把小说转成可玩的游戏"
+  default_prompt: "Use $novel-to-game to turn this novel into a fully playable game on the most suitable target platform."

package/resources/skills/novel-game-creation/upstream/skills/novel-to-game/references/intake-method.md

@@ -0,0 +1,50 @@
+# 需求 intake：先给推荐，再处理高风险歧义
+
+intake 的目的不是举行逐项审批会，而是尽早锁住会让下游返工的产品边界。先读来源，替用户写一页
+推荐草案；低风险空白列为未确认假设并继续，只有 materially branching 或安全相关决定才停靠。
+
+## 默认动作
+
+1. 速读到足以判断语言、题材、情绪内核、时代设定和内容尺度。
+2. 依据原作与用户用途给出一个完整推荐，而不是连续抛空问题。
+3. 只在平台、核心玩法、核心幻想、成人内容、真实人物、版权、资产授权、付费服务或不可逆制作投入
+   存在实质分支时停下来问。
+4. 其余未定项写进 `PRODUCT_BRIEF.md` 的「未确认假设」，标注推荐依据和影响；下游若要改变，回到
+   brief 显式修订。
+
+联网只用于会影响真实决定且可能变化的事实，例如当前引擎导出能力、许可证、渠道限制和新服务规格。
+不要为了给每个常识默认值找出处而把 intake 变成研究项目。
+
+## 产品框架
+
+引擎由目标交付物、现有工程、输入/显示、性能和导出约束决定，不在这里重复平台常识。
+玩法先例说明借用的动作与循环，视觉参考只约束声明的表现维度，两者都不以题材相似代替依据。
+尚未选定的玩法留给概念阶段，不提前锁死。
+
+| 维度 | 最小锁定内容 |
+|---|---|
+| 平台与形态 | 交付物、目标/最低显示模式、输入方式、性能预算 |
+| 市场与语言 | 目标市场、首发界面语言 |
+| 类型与先例 | 已锁玩法或开放方向、相关玩法先例、候选动作、空间形态 |
+| 主要承载 | `experienceProfile`：`system-led` / `narrative-led` / `hybrid` |
+| 美术与完成度 | 画风、`targetFinish`、参考维度、投入边界 |
+| 内容尺度 | 分级、成人内容范围与平台约束 |
+| 核心幻想 | 玩家扮谁、追求什么、何时产生什么情绪 |
+| 时长与结构 | 验证切片时长、单局/长线结构 |
+| 发行定位 | 买断、免费、N/A；只记录会影响玩法的部分 |
+| 引擎与运行时 | 生产引擎、目标运行时、可用的实际测试运行时 |
+| 玩家结构 | 单人/多人/异步/实时，以及切片内真实范围 |
+| 受众 | 硬核度、主要动机、上手与信息密度 |
+
+未适用的维度写 `N/A`，表示明确不做，不允许下游自行补默认。
+
+## 安全边界
+
+- 成人内容显式锁定上限和发行边界；不涉及真实人物，不性化任何未成年角色。
+- 目标与实际测试运行时分开；替代结果只证明实际覆盖层。
+- 参考只借已声明维度，不顺手搬入角色、UI、世界设定或未经授权资产。
+
+## 输出
+
+`PRODUCT_BRIEF.md` 紧凑写清上述产品边界、`targetFinish`、明确非目标、合规/权利边界、未确认假设和
+需要用户裁决的阻断项。只有阻断项为空才进入拆解；普通未确认假设不阻断 `quick`。

package/resources/skills/novel-game-creation/upstream/skills/novel-to-game/references/pipeline-contract.md

@@ -0,0 +1,60 @@
+# 流程契约
+
+## 最小工作区
+
+```text
+game-adaptations/{project}/
+├── PRODUCT_BRIEF.md
+├── analysis/SOURCE_BIBLE.md
+├── concepts/CONCEPT.md
+├── design/GAME_DESIGN.md
+├── design/ART_DIRECTION.md
+├── build/BUILD_BRIEF.md
+├── build/app/
+├── qa/verification.json
+└── _progress.md
+```
+
+按需增加 `_coverage.md`、视觉目标、资产账本和最小证据目录。所有机器状态只取 `NOT_RUN` / `FAIL` /
+`PASS`；`NOT_RUN` 表示没有证据，不能满足完成声明。
+
+早期白盒候选、可执行模型、事件日志、回放与 patch 只在项目实际需要时增加。可执行模型必须被当前
+候选运行时消费，或作为测试合同逐项对照实际规则；不能把整份 `GAME_DESIGN.md` 再抄成一份无人读取的
+JSON/YAML。设计理由仍由 `GAME_DESIGN.md` 拥有，运行状态与动作由实现拥有，实际发生记录由事件日志拥有。
+
+## 阶段 owner 与完成检查
+
+概念、体验/关卡设计、美术方向分别由 `CONCEPT.md`、`GAME_DESIGN.md`、`ART_DIRECTION.md` 的 owner
+负责；构建不得静默改写它们。编排器只检查：
+
+| 检查 | 成立条件 |
+|---|---|
+| `scope` | brief、source bible 和三份设计交接存在；范围、原作事实、目标运行形态、`targetFinish` 与 `experienceProfile` 不冲突 |
+| `playable` | `qa/verification.json` 的 `launch`、`render`、`input`、`coreLoop`、`outcome`、`restart` 均有真实运行证据 |
+
+`_progress.md` 只记录来源、模式、当前阶段、未确认假设、回流和这两项结果。详细测试状态留在
+`qa/verification.json`，不要复制到多份状态表。
+
+早期工作区缺少 `experienceProfile` 时，`resume` 按现有 `CONCEPT.md` 补记一次并继续；不得据此重做
+已批准概念。
+
+## 证据角色
+
+构建准备候选与 verify 入口。QA 可诊断、修复后复跑；最终事实源原子记录当前同一次完整运行，
+不拼接旧 PASS。不要求真人试玩、逐项人工批准、重复证据对象或第二份 QA 报告。
+
+白盒试玩是设计回流，不是第七道顶层 QA 门。反馈至少记录观察位置、玩家输入、预期与实际差异、受影响
+的状态/动作/知识/回响节点和 owner；修订后用可复现的初态与输入路径复查，随机性相关时固定 seed。
+已有存档/日志因节点标识、变量语义、动作效果或知识权限变化而失效时，迁移或明确拒绝兼容，不能静默解释成新历史。
+
+预算或工具耗尽只会留下 `NOT_RUN` / `FAIL`、缩小范围或延期，不会生成 PASS。
+
+## resume 与回流
+
+QA 发现按 owner 回流：
+
+- product：回 `PRODUCT_BRIEF.md`；
+- design/art：修订批准文档后重建受影响范围；
+- build：修实现并复跑同一验证路径。
+
+品类认不出、体验弧不存在、核心前提未上屏不是小缺陷；停止打磨并请求产品裁决。