ruxi-skill

Files (75)

• .gitignore
• DESIGN.md
• LICENSE
• README.md
• README_en.md
• ROADMAP.md
• SKILL.md
• index.html · demos/
• CREDITS.md · demos/metamorphosis/
• backstairs.jpg · demos/metamorphosis/art/
• anna.webp · demos/metamorphosis/art/cast/
• charwoman.webp · demos/metamorphosis/art/cast/
• clerk.webp · demos/metamorphosis/art/cast/
• father.webp · demos/metamorphosis/art/cast/
• grete.webp · demos/metamorphosis/art/cast/
• koechin.webp · demos/metamorphosis/art/cast/
• mother.webp · demos/metamorphosis/art/cast/
• cover.jpg · demos/metamorphosis/art/
• hall-dark.jpg · demos/metamorphosis/art/
• hall-morning.jpg · demos/metamorphosis/art/
• kitchen-dusk.jpg · demos/metamorphosis/art/
• kitchen-night.jpg · demos/metamorphosis/art/
• room.jpg · demos/metamorphosis/art/
• spring.jpg · demos/metamorphosis/art/
• stairwell-rain.jpg · demos/metamorphosis/art/
• vestibule-dusk.jpg · demos/metamorphosis/art/
• vestibule.jpg · demos/metamorphosis/art/
• index.html · demos/metamorphosis/
• script.json · demos/metamorphosis/
• CREDITS.md · demos/pride/
• bedroom.jpg · demos/pride/art/
• breakfast-hall.jpg · demos/pride/art/
• charlotte.webp · demos/pride/art/cast/
• collins.webp · demos/pride/art/cast/
• jane.webp · demos/pride/art/cast/
• ladyc.webp · demos/pride/art/cast/
• lizzy.webp · demos/pride/art/cast/
• lydia.webp · demos/pride/art/cast/
• mrbennet.webp · demos/pride/art/cast/
• mrsbennet.webp · demos/pride/art/cast/
• sarah.webp · demos/pride/art/cast/
• cover.jpg · demos/pride/art/
• dining.jpg · demos/pride/art/
• garden.jpg · demos/pride/art/
• hall.jpg · demos/pride/art/
• library-door.jpg · demos/pride/art/
• night-window.jpg · demos/pride/art/
• servants-hall.jpg · demos/pride/art/
• servants-night.jpg · demos/pride/art/
• shrubbery.jpg · demos/pride/art/
• index.html · demos/pride/
• script.json · demos/pride/
• .nojekyll · docs/
• google8fcd9991381cbf50.html · docs/
• index.html · docs/
• index.html · docs/metamorphosis/
• og.jpg · docs/
• index.html · docs/pride/
• robots.txt · docs/
• 01-title.png · docs/shots/
• …and 15 more

SKILL.md (first lines)

# 入戏 · 把一本书变成你能玩进去的一场戏

> 你不是读者。你是书里那个只有三行字的人，
> 站在原著真实发生过的抉择路口上，替她重新选一次。

## 这个 skill 干什么

输入一本书，输出一个 `index.html`——双击即玩、离线可玩、可发给朋友的视觉小说。
它和「让 AI 写个 galgame」的区别是五条铁律（详见 `references/adaptation.md`）：

1. 不覆盖全书，只取五到八场戏
2. 玩家默认演原著里被略过的边角人物
3. 每个分支点必须指得回原文的一句话——找不到出处的分支砍掉
4. 不做好感度，做理解度：选项是解读，通关结算「你读懂了多少」
5. 结局里必须有一条是原著真实发生的事，标为正典

完整样例：`demos/metamorphosis/`（《变形记》——你是萨姆沙家十六岁的帮厨女孩）。

## 工作流：五阶段

### 阶段 0 · 版权判定（先于一切）

问用户或查证两件事：**作者卒年、首次发表年**。按 `references/adaptation.md` §6 判档，
写进 `meta.book.pd_status`。三档：全球公版 / 美国公版 / 有版权（仅限本地自娱，
构建器自动注水印）。**译本有独立版权**——引用一律引原语言初版，译文自译。
拿不准按有版权处理，并明确告知用户这不是法律意见。

### 阶段 1 · 拆书选戏

```bash
python3 tools/scan_scenes.py book.epub            # 英文书
python3 tools/scan_scenes.py book.txt --names "甲,乙,丙"   # 中文书必须给人名
python3 tools/scan_scenes.py book.epub --json     # 给自己读的全量数据
```

压强表出来后，精读入选章 + 人物首次登场章。压强公式会漏「沉默的重场」和
「信息爆点」，按方法论 §1 人工补。选定 5-8 场，排成一条线。

### 阶段 2 · 定角

按方法论 §2 找边角人物（grep 仆人/信使/邻居/无名者），验三条标准，
**把「玩家演谁」和「这个角色自带的中心问题」摆给用户确认**，再动笔。

### 阶段 3 · 写本

- 剧本 = 一个 JSON，结构定义在 `references/script-schema.md`，逐字段照填，不得加字段
- 写前先做文风档案（方法论 §5），旁白台词全部按档案写
- 每个 option 的 source 从原文精确摘句（≤60 字）；发明的场景诚实标注
- 理解度计分自查三问（方法论 §4）

### 阶段 4 · 构建与自测

```bash
python3 tools/build_html.py script.json out/index.html   # 校验 + 构建
python3 tools/build_html.py script.json --check          # 只校验
```

校验器抓：goto 断链、cast 引用错误、canon 结局不唯一、option 缺出处、超长台词。
构建后**必须自己玩一遍全部路线**（浏览器打开，或无头跑一遍分支图），
确认每条 goto 可达、结算页判词正确，再交付。

### 阶段 5 · 交付

交给用户：`index.html`（主产物）+ `CREDITS.md`（原著出处、素材许可、改编声明）。
可选导出 Ren'Py 工程（`tools/export_renpy.py`，若存在）。
产物不含原书全文；有版权的书只交付到用户本地，不发布。

## 品味守则（写本时贴在手边）

- 台词一行 ≤ 90 字，一次一口
- 情绪写成动作，不写成形容词；禁感叹腔、禁网络词、禁翻译腔
- 正典选项的 echo 告诉玩家「原著里，你就是这么做的」；偏离选项的 echo 承认「你离开了书页」
- 「两个都对但不能全要」的选择至少一个——理解是有代价的
- 判词冷静不奉承；低档判词 = 「你和书里的人读的是同一本书」
- 玩家可以没有名字。边角人物在原著里常常就没有名字，这不是缺陷，是身份

## 范围与近亲

- 小说/戏剧主打；传记/历史可做（「你是当时在场的人」）；科普工具书直接说不适合
- 本 skill 产脚本与引擎，不产 AI 绘图素材；美术默认纯 CSS/SVG 剪影（引擎内置五种人形）
- 与 master-skill 系的关系：大师蒸行业、私教蒸学习路径、孙割蒸文风——入戏蒸的是
  **一本书的抉择结构**，产物是可玩的，不是可读的

From swaylq/ruxi-skill, MIT.