关于 dndtale
Dndtale 是面向 Dungeon Master 和创作者的 Dungeons & Dragons 战役与冒险创作技能。它通过结构化工作流、模板和检查清单,支持从剧情主线到 NPC、遭遇和玩家资料的创作。
主要功能
- 01多场次战役与单次冒险
- 02NPC、地点与遭遇设计
- 03战役模板与工作流
- 04一致性与质量检查清单
- 05玩家资料与 DM 内容
- 06AI 图像生成提示词
适用场景
- 01从故事构想规划完整战役
- 02编写单场游戏冒险
- 03创建 NPC 与均衡遭遇
- 04修改战役文件并保持内容连贯
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mickume/ dndtale --skill dndtale安装后在 Claude Code 中输入/dndtale确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
STRUCTURE.mdchecklists/campaign-quality-checklist.mdcampaign-research-checklist.mdconsistency-checklist.mdexamples/the-stolen-flame/briefing.mdcampaign-overview.mdchapter-01.mdlocations.mdnpcs.mdmodules/campaign-types.mdcreative-voice.mddndig-reference.mdencounter-design.mdformatting-conventions.mdliterary-adaptation.mdsession-pacing.mdworld-building.mdtemplates/campaign-overview.mdchapter-template.mdchapters-summary.mdfactions.mdlocations.mdnpcs.mdREADME.mdtimeline.mdworkflows/campaign-creation-workflow.mditeration-workflow.md详细介绍
Dndtale - DnD 战役与冒险创作工具
Dndtale 是一款专用技能,旨在帮助地下城主和创意内容创作者打造完整、引人入胜的《龙与地下城》战役与冒险。
快速开始
创建新战役
- 立即使用 TaskCreate 创建规划清单
- 遵循工作流: workflows/campaign-creation-workflow.md
- 如果尚未提供需求,使用 AskUserQuestion 收集需求
- 使用模板: 所有模板都在 templates/ 中
- 质量检查: 完成后使用 checklists/campaign-quality-checklist.md
更新现有战役
- 阅读现有内容后再进行修改
- 遵循迭代工作流: workflows/iteration-workflow.md
- 检查一致性: 使用 checklists/consistency-checklist.md
- 对现有文件进行针对性修改时,使用 Edit 工具
需要示例?
查看完整的示例战役:examples/the-stolen-flame/
Dndtale 的功能
此技能可帮助你创作:
- 完整战役 - 多场次故事线,包含相互关联的情节、派系和长期影响
- 单次冒险 - 在单场游戏中完成,目标明确且结局令人满意的冒险
- NPC - 个性鲜明、动机明确、怀有秘密且拥有属性数据的角色
- 地点 - 细节丰富的场景设定,包含氛围、历史和互动元素
- 遭遇 - 平衡的挑战,设有多种解决方案并带来有意义的后果
- 故事框架 - 既保留玩家自主权,又能确保情节连贯的叙事结构
- 图像提示词 - 用于 AI 图像生成工具的详细提示词
核心原则
创作风格
- 使用富有感染力、营造氛围的文字——先渲染氛围,而非罗列数据(参见 creative-voice.md)
- 在每个场景描述中调动多种感官
- 让每个 NPC 都有欲望、说话方式和观点
- 将遭遇设计成戏剧引擎,而不是数学题
玩家自主权优先
- 始终为问题提供多种解决方案
- 设计会产生重要影响并持续发酵的后果
- 避免强制玩家沿单一路径前进
- 让玩家的选择塑造故事
- 角色背景故事是战役的燃料——将其融入其中
便于桌面游玩
- 编写清晰、便于快速浏览的 DM 记录
- 提供简洁的朗读文本
- 包含速查表
- 预先考虑 DM 的常见需求
完整性与一致性
- 在文档之间添加交叉引用
- 保持时间线与逻辑一致
- 确保名称和事实前后一致
- 修改内容时检查依赖关系
使用合适的工具
- TaskCreate/TaskUpdate: 跟踪复杂的战役创作任务
- AskUserQuestion: 澄清需求并收集偏好
- Read: 编辑前务必先阅读现有文件
- Edit: 对现有内容进行针对性修改
- Write: 根据模板创建新文件
- dndig: 生成战役插画(参见 dndig-reference.md)
文件组织
每个战役都应遵循以下结构:
campaigns/[campaign-name]/
├── campaign-overview.md # Master document with full campaign arc
└── changelog/ # Changelogs
└── [change-name].md # Documented changes to the campaign
├── README.md # Player-facing session zero document (spoiler-free)
├── chapter-01.md # Detailed session content
├── chapter-02.md # Continue for each chapter/session
├── chapters-summary.md # Chapter/Scene-level summaries for all chapters of the campaign
├── npcs.md # Important characters with stats and motivations
├── locations.md # Key places with descriptions
├── factions.md # Organizations and their goals (optional)
├── timeline.md # Timeline of events in the campaign (optional)
└── art/ # Image prompts and artwork
├── [scene-name].md # Image generation prompts for scenes
├── [location-name].md # Image generation prompts for locations/environment
├── [npc-name].md # Image generation prompts for unique NPCs
└── [generated-images.jpg] # Actual artwork *.jpg (if generated)
资源库
模板
将这些模板用作所有战役文档的起点:
- campaign-overview.md - 战役主文档
- chapter-template.md - 单次游戏的结构
- chapters-summary.md - 战役所有章节的场景级概览
- timeline.md - 战役事件时间线
- README.md - 面向玩家的零号场次文档
- npcs.md - NPC 名录及详情
- locations.md - 地点描述及地图
- factions.md - 组织与政治
模块
参考这些模块获取详细指导:
- creative-voice.md - 创作风格、表达指南、写作理念
- campaign-types.md - 线性、沙盒、事件驱动、设定驱动
- world-building.md - 设定、NPC、反派设计、道德复杂性、主题
- encounter-design.md - 遭遇设计理念、检查清单、多样性矩阵、Boss 设计
- session-pacing.md - 场次弧光、戏剧结构、节奏工具
- literary-adaptation.md - 将小说、电影、神话改编成战役
- formatting-conventions.md - 所有内容的格式规范
- dndig-reference.md - AI 图像生成工具参考
工作流
针对不同任务的分步流程:
- campaign-creation-workflow.md - 从头到尾完整创建战役
- iteration-workflow.md - 更新和完善现有战役
检查清单
用于质量保证:
- campaign-research-checklist.md - 创建前的基础准备与研究检查清单
- campaign-quality-checklist.md - 确保内容完整、平衡且优质
- consistency-checklist.md - 修改时保持一致性
示例
展示所有模板用法的完整战役示例:
- The Stolen Flame - 展示所有模板实际用法的单次冒险
工作流概览
创建新战役
阶段 1:收集需求
- 使用 TaskCreate 创建规划清单
- 如果简介不完整,使用 AskUserQuestion
- 收集:故事构想、长度、等级、背景、基调
- 如果要改编源材料,请遵循 literary-adaptation.md
- 完成 campaign-research-checklist.md
阶段 2:战役框架
- 选择战役类型(参见 modules/campaign-types.md)
- 创建 campaign-overview.md(使用模板)
- 规划章节划分和游戏场次节奏(参见 session-pacing.md)
- 创建 chapters-summary.md(使用模板)
- 确定主要 NPC 和地点
阶段 3:详细开发
- 使用 creative-voice.md 提升写作质量,为每章撰写内容
- 使用 encounter-design.md 设计多样且有深度的遭遇
- 使用 world-building.md 中的分级框架详细设计 NPC
- 详细设计地点(使用模板)
- 按需创建派系(使用模板)
阶段 4:面向玩家的内容
- 撰写 README.md(使用模板)
- 确保简介中没有任何剧透
阶段 5:润色与质量检查
- 使用 dndig-reference.md 为关键场景编写图像提示词
- 按照 campaign-quality-checklist.md 进行检查
- 通读整个战役,检查节奏和一致性
查看详细工作流: workflows/campaign-creation-workflow.md
更新现有战役
- 阅读所有受影响的文件
- 规划更改并确定依赖项
- 编辑现有文件,进行有针对性的更改
- 更新交叉引用
- 使用 consistency-checklist.md 检查一致性
查看详细工作流: workflows/iteration-workflow.md
重要指南
务必做到
使用 TaskCreate/TaskUpdate 处理复杂任务
- 立即使用 TaskCreate 创建规划清单
- 跟踪各个创作阶段的进度
- 完成任务后使用 TaskUpdate 将其标记为已完成
- 同一时间只能有一个任务处于 in_progress 状态
必要时提出问题
- 对于不明确的需求,使用 AskUserQuestion
- 确认基调、内容界限和玩家偏好
- 询问存在多种有效方案的情况
- 不要猜测——向 DM 确认
编辑前先阅读
- 使用 Edit 前,务必先使用 Read 阅读现有文件
- 理解完整上下文
- 检查依赖项和交叉引用
- 与现有内容保持一致
保留玩家自主权
- 为每个问题提供多种解决方案
- 设计有意义的后果
- 允许创造性的方法
- 避免强制玩家走单一路径
遵循模板
- 使用 templates/ 中的模板
- 保持格式一致
- 包含所有必需章节
- 与示例风格相符
切勿这样做
不要强行引导玩家
- 绝不要强制采用单一解决方案
- 不要否定玩家的选择
- 避免采用“NPC 包办一切”的解决方案
不要跳过质量检查
- 完成前务必使用检查清单
- 确认交叉引用有效
- 检查名称是否一致
- 测试故事逻辑
不要忘记文档
- 在文档之间添加交叉引用
- 链接相关内容
- 添加 DM 注释和提示
- 提供属性数据块或参考资料
不要破坏现有内容
- 编辑时保持故事逻辑
- 更新所有指向已更改内容的引用
- 检查时间线是否一致
- 保留有效内容
Session Zero 注意事项
除非另有说明,战役均面向愿意参与的成年人编写。当内容可能令人不安或属于 NSFW 时:
- 在 README.md 中加入内容警告
- 建议讨论 Session Zero 话题
- 推荐安全工具(X-Card、Lines & Veils)
- 明确标注成熟内容
标准 D&D 冒险结构
此技能遵循专业 D&D 冒险惯例(完整详情见 STRUCTURE.md):
**前置内容:**引言、概要、冒险钩子 **核心结构:**按章节划分场景、遭遇和 NPC **高潮:**史诗级最终遭遇,包含多种解决途径 **后置内容:**附录,包含属性数据、魔法物品、讲义
每章包含:
- 用于场景铺陈的朗读文本
- DM 信息与秘密
- 遭遇设计(战斗、社交、技能挑战)
- 带有性格与属性数据的 NPC
- 宝藏与奖励
- 与其他章节的关联
格式规范
遵循 modules/formatting-conventions.md 中的惯例:
朗读文本:
> Text the DM reads to players
> Detailed, evocative, multi-sensory
> Present tense, no secrets
**DM 备注:**使用常规文本描述游戏机制细节、秘密和应变方案
**属性数据:**尽可能参照《Monster Manual》,或提供自定义属性数据
**交叉引用:**使用 Markdown 链接:[Chapter 2](chapter-02.md) 或 [NPCs](npcs.md#npc-name)
**图像提示词:**在 art/ 文件夹中创建,并添加适当的元数据
快速参考
战役类型
- **线性:**按顺序展开的章节,路径清晰(最容易准备)
- **沙盒:**中心枢纽,多种选择(准备工作最多)
- **事件驱动:**按时间线展开事件,玩家行动会影响结果
- **设定驱动:**聚焦地点,鼓励探索
遭遇设计
- 每场战斗都要回答:“为何会发生这场战斗?战斗结束后会有什么变化?”
- 地形是第三个战斗者——环境应迫使玩家做出选择
- 为敌人设定“消灭队伍”之外的目标(逃跑、保护、拖延时间、捕获)
- 使用遭遇设计检查清单:戏剧性问题、利害关系、环境、多种应对方式、局势升级、关联
- 使用遭遇多样性矩阵(战斗/社交/探索/混合子类型)追踪多样性
- Boss 战需要包含多个阶段、传奇动作、情感利害关系和多种胜利条件
参见:modules/encounter-design.md
NPC 设计
- **第 1 级(过场角色):**一个特征、一项有用之处、一个容易记住的名字
- **第 2 级( recurring 角色):**想要与需要、对其他 NPC 的看法、一个秘密、说话习惯
- **第 3 级(主要角色):**完整的内心世界、独立的故事线、机制分量、声音特征、关系网络
- **反派:**动机、手段、弱点、升级、镜像
参见:modules/world-building.md、templates/npcs.md
地点设计
- 氛围(景象、声音、气味、感受)
- 历史与现状——运用环境叙事
- 在场的 NPC 和遭遇
- 可供发现的秘密——层层递进的谜题,让好奇心有所回报
参见:modules/world-building.md、templates/locations.md
基调与内容
根据 DM 要求的基调进行调整:
- 英雄史诗风
- 黑暗严肃风
- 幽默轻松风
- 悬疑与阴谋
- 恐怖
- 成人主题/NSFW(附带适当警告)
始终做到:
- 始终保持与所要求的基调一致
- 在简介中警告成熟内容
- 针对敏感话题提供 Session Zero 指引
使用 dndig 生成图像
使用 dndig(../dndig)根据提示词文件生成战役插图。完整文档请参阅 dndig-reference.md。
快速使用:
dndig campaigns/my-campaign/art/throne-room.md --verbose
提示词文件格式:
---
title: throne-room
aspect_ratio: "16:9"
resolution: 2K
temperature: 0.8
batch: 2
instructions: campaign-style.md
references:
- refs/gothic-castle.jpg
---
Detailed visual description based on scene read-aloud text...
Include: composition, lighting, mood, style, atmosphere.
主要功能:
- 风格一致性: 为战役的视觉风格创建一个共享的
instructions文件 - 参考图像: 最多可使用 14 张参考图像来辅助确定风格(角色一致性、建筑风格)
- 批量生成: 每个提示词生成 1–4 个变体
- 宽高比:
1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9 - 分辨率:
512px、1K、2K、4K
创建提示词:
- 关键地点和场景(
16:9或4:3,2K) - 重要的 NPC 和角色肖像(
2:3或3:4,2K) - 决定性遭遇(
16:9,2K) - 地图和地下城(
1:1或4:3,2K及以上) - 物品和神器(
1:1,1K)
实例演示
示例:开启新战役
DM: "I want to create a 3-session campaign about smugglers in a port city"
You:
1. TaskCreate: Create planning checklist
2. AskUserQuestion: Clarify tone, starting level, player count
3. Choose campaign type: Sandbox (city hub with multiple quest lines)
4. Create campaign-overview.md from template
5. Create 3 chapters, npcs.md, locations.md
6. Create README.md for players
7. Run quality checklist
8. Create image prompts and generate art with dndig
9. Deliver organized campaign
示例:更新现有战役
DM: "The players killed the quest-giver NPC. I need to adapt."
You:
1. Read campaign-overview.md and affected chapters
2. Read npcs.md to understand the NPC's role
3. Follow iteration-workflow.md
4. Options:
- Introduce heir/assistant to replace NPC
- Redistribute quests to other NPCs
- Show consequences of NPC death
5. Edit affected chapters
6. Update npcs.md and cross-references
7. Run consistency checklist
成功标准
满足以下条件时,战役即可准备就绪:
- 所有章节均已完成且内容详尽
- NPC 拥有鲜明的个性、动机和属性
- 地点的描述包含氛围和特色
- 每个问题都有多种解决方案
- 交叉引用准确无误
- 简报内容完整且不含剧透
- 质量检查清单审核通过
- DM 可以使用现有材料主持第 1 场游戏
获取帮助
遇到问题?
- 查看 modules/ 中的相关模块
- 查阅 workflows/ 中的工作流
- 参考 examples/the-stolen-flame/ 中的示例
- 使用 AskUserQuestion 向 DM 澄清问题
需要检查质量?
请记住
你正在帮助 DM 为玩家创造难忘的体验。请重点关注:
✓ 易用性 - 方便在游戏桌上主持 ✓ 灵活性 - 提供多种解决方案,赋予玩家自主权 ✓ 完整性 - 包含所有必要信息 ✓ 一致性 - 名称、事实和时间线彼此吻合 ✓ 质量 - 故事引人入胜、遭遇平衡、时刻令人难忘
祝你好运,愿你的战役名垂传奇!