ai4rpg 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 的七个维度展开讨论：
- 项目定位
- 世界观构思
- 角色构思
- 互动与动态需求
- 创作方向
- 开场构思
- 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。