# Tavern Design

> 角色卡与世界书的叙事设计阶段：大方向讨论、世界观/角色头脑风暴、剧情设计、体验目标、风格意向，以及从小说/游戏脚本等现成材料转化为故事大纲并完成 design-spec.md。确保在以下情况也使用此 skill：用户提到'设计角色卡'、'设计世界书'、'从零创作'、'大方向'、'剧情设计'、'世界观构思'、'角色构思'、'头脑风暴'、'故事大纲'、'材料转化'、'轻小说改编'、'剧本改编'、'design-spec' 等关键词时，即使用户没有明确说'tavern-design'也应触发。完成叙事设计后由 tavern-cards 继续项目创建与创作规划。

- Skill: `ai4rpg/tavern-design` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add ai4rpg/tavern-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai4rpg/tavern-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ai4rpg (https://skillmd.com/u/ai4rpg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ai4rpg/tavern-design

---


# SillyTavern 角色卡与世界书叙事设计

完成叙事设计阶段的大方向讨论、剧情设计与材料转化，产出跨 skill 交接物 `design-spec.md`（tavern-design 写入叙事设计段，tavern-ui 在 UI 开发阶段追加 UI 段，tavern-cards 消费它）。

## 适用场景

| 场景 | 流程 |
|------|------|
| 从零创建完整项目 | 询问项目名称 → 创建 `cards/{Project}/` → 大方向讨论 + 剧情设计 → 产出 `design-spec.md` → 用户确认 |
| 从现有材料转化 | 询问项目名称 → 先讨论素材未覆盖内容和转化侧重 → 转化（叙事材料产出 `故事大纲.yaml`）→ 结合成果完成 `design-spec.md` → 用户确认 |
| 只做叙事设计 / 大方向讨论 | 同上，产出 `design-spec.md` 即可 |
| 修改已有角色卡的叙事方向 | 读取已有 `design-spec.md` 和创作规划，讨论修改点，更新 `design-spec.md` 后回到 tavern-cards |

## 流程

### 1. 创建项目目录

询问用户项目名称，创建 `cards/{Project}/` 目录。后续 `design-spec.md` 和转化成果都保存在这里。

### 2. 大方向讨论

按 `references/design-guide.md` 的七个维度展开讨论：

1. 项目定位
2. 世界观构思
3. 角色构思
4. 互动与动态需求
5. 创作方向
6. 开场构思
7. SFW / NSFW

复杂剧情额外讨论暴露时机与控制策略。讨论过程忠实记录用户想法，不猜测、不代替用户决定。

### 3. 材料转化（从材料创建时）

- 先讨论素材未覆盖内容与转化侧重
- 执行 `references/conversion.md` 流程；叙事材料产出 `cards/{Project}/故事大纲.yaml`，结构化材料可直接提炼
- 结合转化成果完成 `design-spec.md`

从零创建时跳过本步骤。

### 4. 产出 design-spec.md

将大方向讨论结果整理为 `cards/{Project}/design-spec.md`。格式建议见 `references/design-guide.md`。

### 5. 用户确认

展示 `design-spec.md` 并暂停等待用户确认。用户确认后，告知用户接下来可交给 tavern-cards 进行项目创建与创作规划。

## 子代理

调用时由 Agent harness 注入任务，主代理在 task 字符串里携带下表「输入」一列的参数，并按下表「输出」一列处理返回。

| 子代理 | 作用 | 输入 | 输出 |
|--------|------|------|------|
| conversion-agent | 材料转化分片处理 | 源文件路径、行范围、输出路径；前序大纲片段路径（如有） | 按规范写入输出路径，并运行 `scripts/validate-conversion-outline.mjs` 自验片段；另返回 `missing_names` 供主代理合并 |

长文本分片调用与合并的衔接见 `references/conversion.md`、`references/conversion/outline.md`。

## 技术细节边界

`design-spec.md` 只记录大方向；MVU/EJS、typeLists、头像、UI 模式、变量结构、条目级规划等技术细节由 tavern-cards 项目创建步骤处理。

## 参考资料

此索引是 `references/` 文档列表的权威来源。

```
references/
├── design-guide.md             —— 大方向讨论指导与 design-spec.md 格式
├── conversion.md               —— 从材料转化流程（主文档）
└── conversion/
    ├── outline.md              —— 大纲构建指导（长文本处理、分卷、子代理分配）
    ├── outline-spec.md         —— 大纲规范（信息分类、记录原则、行号规范）
    ├── validation.md           —— 转化大纲验证脚本使用说明
    ├── assessment.md           —— 材料类型评估标准
    ├── source-chapters.md      —— source_chapters 标注标准
    ├── key-info.md             —— 关键信息确认流程
    └── error-handling.md       —— 转化错误处理（材料矛盾、信息缺失、转化失败）
```

工具脚本：

- `scripts/validate-conversion-outline.mjs`：验证故事大纲的 YAML 结构、章节引用、占位符和原文引用真实性。使用说明见 `references/conversion/validation.md`。