@oh-story/dsh 0.1.3 → 0.1.5

package/lib/novel-to-game/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NovelToGame contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/novel-to-game/README.md

@@ -0,0 +1,180 @@
+# NovelToGame
+
+> Turn a novel in any language into a source-grounded, fully playable game.
+
+[![Validate](https://github.com/zenstory-ai/novel-to-game/actions/workflows/validate.yml/badge.svg)](https://github.com/zenstory-ai/novel-to-game/actions/workflows/validate.yml) [![Latest release](https://img.shields.io/github/v/release/zenstory-ai/novel-to-game?display_name=tag&sort=semver)](https://github.com/zenstory-ai/novel-to-game/releases/latest) [![License](https://img.shields.io/github/license/zenstory-ai/novel-to-game)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/zenstory-ai/novel-to-game?style=flat&logo=github)](https://github.com/zenstory-ai/novel-to-game/stargazers)
+
+NovelToGame is an open-source Agent Skills toolkit for Claude Code, Codex, and Kimi Code. It turns novel adaptation into a staged workflow: source analysis, concept selection, world and art direction, implementation, and runtime QA.
+
+Bring a novel in any language and choose the target runtime. Generated artifacts follow the requested language; build and QA stay on the chosen platform instead of silently falling back to an easier substitute.
+
+[中文](README_ZH.md) · [Play Online](#play-online) · [Quick Start](#quick-start) · [Workflow](#workflow) · [Skills](#skills) · [Artifacts](#artifacts) · [Contributing](#contributing)
+
+## Play Online
+
+Three playable adaptations, each available in a browser right now and linked to the case study behind it: source provenance, concept trade-offs, game and art direction, runnable source, and evidence from the playable paths.
+
+### Journey to the West · Three Borrowings of the Banana Fan
+
+[![Wukong's party and the Bull Demon King's formation remain fully visible above a separate light-silk command tray on the Jilei Mountain stage](examples/journey-to-the-west/screenshots/hero.jpg)](https://xiyouji.vibecoco.ai)
+
+**One wave of a fan blew you fifty thousand li. Take the mountain back one turn at a time.**
+
+Command Wukong's party through the three borrowings of the Banana-Leaf Fan: read the five-element wheel, follow a fire-vein treasure map, decide when to press deeper or bank the haul, transform your way in where force will not work, and turn a demon king who outclasses you into a rainstorm over the Mountain of Flames.
+
+**[Play in browser](https://xiyouji.vibecoco.ai)** · [Read the case study](examples/journey-to-the-west/) · design estimate: 45–90 min · all ages · playable prototype
+
+### Jin Ping Mei · Ledger of Desire
+
+[![Five women of the Ximen household face the player across the household ledger](examples/jin-ping-mei/screenshots/title.jpg)](https://jinpingmei.vibecoco.ai)
+
+**Choose whose door you enter tonight. Find out whose door knocks in the morning.**
+
+Twenty days, five courtyards. Keep silver, influence, reputation, exposure, and household strain in balance; respect each woman's terms; build trust through shared crises; and face a final ledger shaped by what everyone chose and remembers.
+
+**[Play in browser](https://jinpingmei.vibecoco.ai)** · [Read the case study](examples/jin-ping-mei/) · design estimate: 60–90 min · 18+ · playable prototype
+
+### Project Plateau · The Lost World · 3D
+
+A real-time **first-person 3D field-photography game** adapted from Arthur Conan Doyle's *The Lost World*. Cross a connected plateau, observe a living Iguanodon family, expose four glass plates under aerial pressure, and return with the views that survived.
+
+Play the full expedition on desktop, or watch the 15-second gameplay preview on other devices.
+
+https://github.com/user-attachments/assets/27819247-4e4d-4bf0-8f0f-43d4125c4d45
+
+**[Play in your browser — no install](https://plateau.vibecoco.ai)** · [Read the case study](examples/project-plateau/) · [Share feedback](https://github.com/zenstory-ai/novel-to-game/discussions/7) · 1–3 min run · desktop WebGL2 · playable prototype
+
+## Why NovelToGame
+
+A one-line “turn this book into a game” prompt often produces a generic reskin or a clickable plot summary. NovelToGame keeps the adaptation traceable and gives each major decision a clear owner:
+
+- **Source-grounded adaptation:** extract rules, spaces, character agency, conflicts, and visual anchors with citations;
+- **Real game design:** turn source evidence into player verbs, systems, levels, feedback, failure, and outcomes;
+- **Target-runtime delivery:** build for the approved platform or engine without implementation silently redesigning the game;
+- **Optional, restrained voice:** synthesize only selected high-value lines at build time, keep subtitles and mute fallbacks, and never send the whole novel to a TTS provider by default;
+- **Evidence-based QA:** verify startup, rendering, input, the core loop, an outcome, restart, and explicit limitations in the tested runtime.
+
+## Quick Start
+
+### 1. Install the seven skills
+
+| Agent CLI | Install | Invoke |
+|---|---|---|
+| Claude Code | `npx skills add zenstory-ai/novel-to-game -g -y -a claude-code -s '*'` | `/novel-to-game` |
+| Codex | `npx skills add zenstory-ai/novel-to-game -g -y -a codex -s '*'` | `$novel-to-game` |
+| Kimi Code | `npx skills add zenstory-ai/novel-to-game -g -y -a kimi-code-cli -s '*'` | `/skill:novel-to-game` |
+
+Install adapters for all three CLIs on the same machine:
+
+```bash
+npx skills add zenstory-ai/novel-to-game -g -y -s '*' \
+  -a claude-code -a codex -a kimi-code-cli
+```
+
+Cloning the repository also enables project-local skill discovery in all three CLIs.
+
+### 2. Start an adaptation
+
+Give the agent a novel file, directory, or link:
+
+```text
+Use novel-to-game quick to adapt this novel into a fully playable game.
+Recommend the target platform, genre, and engine from the source, and keep the first build to about 15 minutes.
+Let the player enter the world as an original character with a new playable route through its conflict.
+```
+
+When you want an **interactive story** rather than a systems game, say so. That locks the `narrative-led` experience profile, so concept, design, and QA judge continuous scenes, character dialogue, testimony, and key choices instead of applying rounds, cards, and resource bars:
+
+```text
+Use novel-to-game quick to adapt this novel into an interactive story.
+Carry the experience with continuous scenes, character dialogue, testimony, and key choices.
+Keep variables as hidden causal tags rather than a visible stat panel.
+Key choices must change later scenes, character attitudes, and the ending, and be named back in later text.
+```
+
+The narrative track **lowers no standard**: it still needs a recognizable gameplay precedent, the same
+three-phase arc, and the same hard vetoes. Only the expression changes -- new people to question, new ways to
+press a contradiction, and attitudes that shifted because of what you did earlier.
+
+`quick` is the low-friction option: the agent drafts sensible defaults, asks only about materially branching or safety-sensitive choices, compares three concepts, and continues through design, build, and QA. Every project runs one minimum QA path covering real startup, rendering, input, a complete loop, an outcome, restart, and explicit limitations. It does not require a human playtest or a separate approval report. Choose `director` when you want to pick the concept yourself.
+
+<details>
+<summary><strong>Native plugin installation</strong></summary>
+
+#### Claude Code
+
+```text
+/plugin marketplace add zenstory-ai/novel-to-game
+/plugin install novel-to-game@novel-to-game-skills
+/novel-to-game:novel-to-game quick
+```
+
+#### Codex
+
+```bash
+codex plugin marketplace add zenstory-ai/novel-to-game
+codex plugin add novel-to-game@novel-to-game-skills
+```
+
+#### Kimi Code 0.27 or newer
+
+```text
+/plugins install https://github.com/zenstory-ai/novel-to-game
+/reload
+/skill:novel-to-game quick
+```
+
+</details>
+
+## Workflow
+
+The orchestrator locks `PRODUCT_BRIEF.md`, then hands the adaptation through separately owned decisions. Concept, experience/level design, and art direction remain distinct. After world design, a risk-matched whitebox tests the hardest causal, systemic, spatial, or control question before art production; its findings return to the design owner rather than becoming a new QA gate.
+
+```text
+Novel → Source analysis → Concept → World design → Risk-matched whitebox ↺ → Art direction → Production build → QA → Playable game
+```
+
+The whitebox runs only the narrow model/replay check needed for its declared risk. The production build targets the chosen runtime and prepares one authoritative verification entry point; QA runs it once and records the six minimum player-visible effects with real execution evidence. Capability-specific regression checks run only when that capability is actually adopted. No human-playtest gate or duplicate QA report is required. Source identity, public hosting, marketing, rights, subjective fun, and publication quality are not machine-proven by this QA record.
+
+## Skills
+
+| Skill | Responsibility |
+|---|---|
+| [`novel-to-game`](skills/novel-to-game/) | Confirm requirements, choose a mode, orchestrate stage handoffs, and recover progress |
+| [`novel-game-analyze`](skills/novel-game-analyze/) | Extract cited rules, verbs, spaces, agents, systems, and signature moments |
+| [`game-concept`](skills/game-concept/) | Generate three materially different directions, reject invalid options, and choose one |
+| [`game-world-design`](skills/game-world-design/) | Define the player promise, core loop, world response, systems, levels, failure, and outcomes |
+| [`game-art-direction`](skills/game-art-direction/) | Define camera, composition, visual grammar, colour, light, materials, HUD, motion, and sound |
+| [`game-build`](skills/game-build/) | Build a risk-matched whitebox, then implement the approved production candidate without redesigning it |
+| [`game-qa`](skills/game-qa/) | Verify commands, states, screenshots, and real play paths without overstating subjective results |
+
+## Artifacts
+
+Each run creates a compact, self-contained adaptation workspace:
+
+```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
+```
+
+Core design documents remain independent of any single model or game engine. The approved target runtime determines the implementation and QA environment.
+
+## Contributing
+
+Reproducible bugs, skill gaps backed by evidence, and example proposals that demonstrate a distinct adaptation lesson are welcome. Read the [contribution guide](CONTRIBUTING.md) and use the repository's structured issue and pull request templates.
+
+## License
+
+NovelToGame is released under the [MIT License](LICENSE).
+
+## Acknowledgments
+
+Thanks to the [linux.do](https://linux.do) community for early feedback and support.

package/lib/novel-to-game/README_ZH.md

@@ -0,0 +1,178 @@
+# NovelToGame
+
+> 把任何语言的小说，改编成有原著依据、可完整游玩的游戏。
+
+[![Validate](https://github.com/zenstory-ai/novel-to-game/actions/workflows/validate.yml/badge.svg)](https://github.com/zenstory-ai/novel-to-game/actions/workflows/validate.yml) [![Latest release](https://img.shields.io/github/v/release/zenstory-ai/novel-to-game?display_name=tag&sort=semver)](https://github.com/zenstory-ai/novel-to-game/releases/latest) [![License](https://img.shields.io/github/license/zenstory-ai/novel-to-game)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/zenstory-ai/novel-to-game?style=flat&logo=github)](https://github.com/zenstory-ai/novel-to-game/stargazers)
+
+NovelToGame 是一套面向 Claude Code、Codex 和 Kimi Code 的开源 Agent Skills。它把小说游戏化改编拆成一条职责清晰的流程：拆解原著、选择概念、设计世界与美术、完成构建，并在目标运行环境中实际验证。
+
+小说可以使用任何语言，生成内容使用用户指定的语言。构建和 QA 始终以选定的平台或引擎为准，不会为了实现方便换成更容易的替代环境。
+
+[English](README.md) · [在线试玩](#在线试玩) · [快速开始](#快速开始) · [工作流](#工作流) · [Skills](#skills) · [产物](#产物) · [参与贡献](#参与贡献)
+
+## 在线试玩
+
+三款可玩的改编，都可以直接在浏览器里打开，每一款都链到对应的改编案例：原文依据、概念取舍、游戏与美术方向、可运行源码，以及来自实际游玩流程的证据。
+
+### 西游记 · 三借芭蕉扇
+
+[![积雷山决战中敌我阵列完整留在木刻舞台，下方轻绢指令台与人物画面彼此分离](examples/journey-to-the-west/screenshots/hero.jpg)](https://xiyouji.vibecoco.ai)
+
+**一扇吹出五万里。这口气，一回合一回合打回来。**
+
+你指挥孙悟空一行三借芭蕉扇：算五行、循火脉残图寻宝、在收手与深入之间下注、排阵型、变形取巧硬闯不进的地方，把一个正面打不过的牛魔王，打成落在火焰山上的一场雨。
+
+**[浏览器试玩](https://xiyouji.vibecoco.ai)** · [查看改编案例](examples/journey-to-the-west/) · 设计估时 45–90 分钟 · 全年龄 · 可玩原型
+
+### 金瓶梅 · 风月总账
+
+[![西门宅中五人隔着总账看向玩家](examples/jin-ping-mei/screenshots/title.jpg)](https://jinpingmei.vibecoco.ai)
+
+**今夜进谁的门，明早谁来敲你的门。**
+
+二十日，五处院门。平衡银钱、官势、声名、见光与宅门损耗，守住每个人亲口说出的规矩，让不同院门在真实危局中建立互信，最后面对一笔由所有选择和记忆共同写成的总账。
+
+**[浏览器试玩](https://jinpingmei.vibecoco.ai)** · [查看改编案例](examples/jin-ping-mei/) · 设计估时 60–90 分钟 · 18+ · 可玩原型
+
+### Project Plateau · 失落的世界 · 3D
+
+这是一款由柯南·道尔《失落的世界》改编而来的实时**第一人称 3D 野外摄影游戏**。玩家穿过连通的高原，观察共同生活的禽龙家庭，在空中威胁下拍完四张玻璃底片，再带着幸存的影像返回。
+
+桌面浏览器可完整试玩，其他设备可直接观看 15 秒实机预览。
+
+https://github.com/user-attachments/assets/27819247-4e4d-4bf0-8f0f-43d4125c4d45
+
+**[浏览器直接试玩，无需安装](https://plateau.vibecoco.ai)** · [查看改编案例](examples/project-plateau/) · [反馈体验](https://github.com/zenstory-ai/novel-to-game/discussions/7) · 1–3 分钟一局 · 桌面 WebGL2 · 可玩原型
+
+## 为什么用 NovelToGame
+
+只给模型一句“把这本书做成游戏”，很容易得到通用玩法换皮或可点击的剧情摘要。NovelToGame 让关键决策各有负责人，并保留从原著到成品的判断依据：
+
+- **基于原著做改编**：从文本中提取有原文依据的规则、空间、角色意志、冲突和视觉锚点；
+- **真正完成游戏设计**：把原著证据转成玩家动作、系统、关卡、反馈、失败与结果；
+- **面向目标环境构建**：严格按照批准的平台或引擎实现，避免实现阶段悄悄重做策划；
+- **克制地选用语音**：只在构建期合成选定的关键台词，保留字幕与静音降级，默认不向 TTS 供应商发送整本小说；
+- **用运行证据做 QA**：在实际测试环境中验证启动、渲染、输入、核心循环、一个结果、重开和明确限制。
+
+## 快速开始
+
+### 1. 安装七个 Skills
+
+| Agent CLI | 安装命令 | 调用方式 |
+|---|---|---|
+| Claude Code | `npx skills add zenstory-ai/novel-to-game -g -y -a claude-code -s '*'` | `/novel-to-game` |
+| Codex | `npx skills add zenstory-ai/novel-to-game -g -y -a codex -s '*'` | `$novel-to-game` |
+| Kimi Code | `npx skills add zenstory-ai/novel-to-game -g -y -a kimi-code-cli -s '*'` | `/skill:novel-to-game` |
+
+在同一台机器上为三个 CLI 安装适配器：
+
+```bash
+npx skills add zenstory-ai/novel-to-game -g -y -s '*' \
+  -a claude-code -a codex -a kimi-code-cli
+```
+
+克隆仓库后，三种 CLI 均可直接发现项目内的 Skills。
+
+### 2. 开始一次改编
+
+把小说文件、目录或链接交给 Agent：
+
+```text
+用 novel-to-game quick 把这本小说改编成一款可完整游玩的游戏。
+请根据题材推荐目标平台、类型和引擎，并把首个版本控制在 15 分钟左右。
+玩家以原创角色的身份进入世界，不要逐段复演原作剧情。
+```
+
+想要**互动小说 / 互动叙事**而不是系统玩法时，直接说出来——这会锁定 `narrative-led` 体验档案，让概念、设计与 QA 都按连续场景、人物对白、证词和关键选择来判，而不是套用回合、卡牌和资源条：
+
+```text
+用 novel-to-game quick 把这本小说改编成一款互动叙事游戏。
+体验以连续场景、人物对白、证词与关键选择承载；数值只作为隐藏的剧情因果标签，不做常驻数值面板。
+关键选择要改变后续场景、人物态度和结局，并在后文被点名回读。
+```
+
+叙事主导**不降低任何标准**：同样要有可识别的玩法先例、三段弧和硬否决；只是判据换成“新的可问
+对象、新的质证手段、因先前行为改变的人物态度”这类说法。
+
+`quick` 是低门槛默认模式：Agent 先给出合理草案，只追问会改变产品方向或涉及安全的选择，再比较三个概念并继续设计、构建和 QA。每个项目只运行一次最小 QA 路径：真实启动、渲染、输入、完整循环、一个结果、重开和明确限制；不要求真人试玩或另写审批报告。想自己选择概念时使用 `director`。
+
+<details>
+<summary><strong>使用原生插件安装</strong></summary>
+
+#### Claude Code
+
+```text
+/plugin marketplace add zenstory-ai/novel-to-game
+/plugin install novel-to-game@novel-to-game-skills
+/novel-to-game:novel-to-game quick
+```
+
+#### Codex
+
+```bash
+codex plugin marketplace add zenstory-ai/novel-to-game
+codex plugin add novel-to-game@novel-to-game-skills
+```
+
+#### Kimi Code 0.27 或更高版本
+
+```text
+/plugins install https://github.com/zenstory-ai/novel-to-game
+/reload
+/skill:novel-to-game quick
+```
+
+</details>
+
+## 工作流
+
+总入口先锁定 `PRODUCT_BRIEF.md`，再让改编任务进入职责独立的决策阶段。概念、体验/关卡与美术方向继续分别负责。世界设计完成后，先用与风险匹配的白盒验证最难的因果、系统、空间或操作问题，再开始美术生产；观察结果交回设计 owner，不新增一道 QA 门。
+
+```text
+小说 → 游戏化拆解 → 游戏概念 → 世界设计 → 风险白盒 ↺ → 美术方向 → 正式构建 → QA → 可玩游戏
+```
+
+白盒只运行足以暴露声明风险的最窄模型/回放检查。正式构建面向选定的运行环境并准备一条权威验证入口，QA 只运行一次，用实际运行证据记录六项最小玩家效果。只有实际采用的能力才运行对应回归检查；不要求真人试玩门禁或重复 QA 报告。源码身份、公网托管、营销、权利、主观趣味和发布质量不由这份机器记录证明。
+
+## Skills
+
+| Skill | 职责 |
+|---|---|
+| [`novel-to-game`](skills/novel-to-game/) | 确认需求、选择模式、编排阶段并恢复中断进度 |
+| [`novel-game-analyze`](skills/novel-game-analyze/) | 提取有引证的规则、动作、空间、角色、系统和名场面 |
+| [`game-concept`](skills/game-concept/) | 生成三个真正不同的方向，排除不合格方案后选出一个 |
+| [`game-world-design`](skills/game-world-design/) | 定义玩家承诺、核心循环、世界响应、系统、关卡、失败与结果 |
+| [`game-art-direction`](skills/game-art-direction/) | 定义镜头、构图、视觉语法、色光材质、HUD、动效与声音 |
+| [`game-build`](skills/game-build/) | 先做与风险匹配的白盒，再在不重做策划的前提下实现正式候选 |
+| [`game-qa`](skills/game-qa/) | 用命令、状态、截图和实际游玩路径验证构建，不夸大主观结论 |
+
+## 产物
+
+每次运行都会创建一个紧凑、自包含的改编工作区：
+
+```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
+```
+
+核心设计文档不绑定某个模型或游戏引擎；批准后的目标运行环境决定实际实现与 QA 环境。
+
+## 参与贡献
+
+欢迎提交可复现的 Bug、有证据支持的 Skill 能力缺口，以及能展示独特改编方法的示例提案。请阅读 [贡献指南](CONTRIBUTING.md)，并使用仓库提供的 Issue 与 PR 模板。
+
+## 许可证
+
+NovelToGame 使用 [MIT License](LICENSE)。
+
+## 致谢
+
+感谢 [linux.do](https://linux.do) 社区提供早期反馈与支持。

package/lib/novel-to-game/VERSION

@@ -0,0 +1 @@
+0.3.0