/install dnd5e-dm-skill
D&D 5e (2024版) 地下城主运行工具包 — DM Runner Toolkit
概述
本 Skill 为 D&D 5e 2024 版地下城主提供了一套完整的模组运行辅助工具,专为《博德之门:坠入阿弗纳斯》(Descent into Avernus)模组设计,但其中检定规则和DM流程规则可适配任意 5e 模组。
⚠️ 本 Skill 不包含以下文件:
- 《城主指南 (2024).md》— 请自行购买/获取 D&D 2024 版《Dungeon Master's Guide》
- 《玩家手册(2024).md》— 请自行购买/获取 D&D 2024 版《Player's Handbook》
- 《怪物图鉴(2025).md》— 请自行购买/获取 D&D 2024 版《Monster Manual》
- 模组剧本文件 — 请自行购买《Baldur's Gate: Descent into Avernus》冒险模组
上述文件是运行模组的基础依赖,本 Skill 只提供辅助运行工具。 用户需将上述文件下载后置于同一工作目录下,Skill 中的运行规则文件会自动引用它们。
文件结构
DMskill/
├── SKILL.md ← 本文件(技能说明)
├── references/
│ ├── DM_RULES.md ← DM运行流程规则(会话启动/检定流程/地图系统/支线控制/经验结算)
│ ├── 检定规则.md ← 常见动作-检定映射表与DC参考标准
│ ├── MODULE_INDEX.md ← 模组索引(文件结构速查/流程速查/怪物索引/技能速查/升级规划)
│ ├── MODULE_CHECKLIST.md ← 模组推进检查表(铁律护栏/流程图/跑偏修正指令)
│ └── MODULE_DISPATCH.md ← 模组运行调度规则(关键节点/自由填充/偏差纠正机制)
└── scripts/
└── (预留) ← 未来可添加骰子自动掷骰脚本、地图生成脚本等
规则文件说明
1. DM_RULES.md — DM运行流程规则
定义了以下关键规则系统:
- 规则0:会话启动协议 — 每次新对话时扫描存档、询问玩家载入/新开的流程
- 规则0.5:规则持续优化(玩家驱动) — 玩家可在游戏中随时提出改进意见并写入规则文件
- 规则1:检定交互流程 — "先问行动,再检定"的完整6步标准流程
- 规则1.5:动作-检定匹配 — 遇到需要检定的动作时,参考
检定规则.md确定技能和DC - 规则2:检定后给行动空间 — 检定完成后必须提供新的行动选项,不得直接跳到下一场景
- 规则3:玩家通过"问队友"推进主线 — 队友NPC总结信息并自然推动剧情
- 规则4:支线/填充剧情控制 — 3轮限制+支线标识+已用内容追踪(附
filled_content.md模板) - 规则5:经验结算自动触发 — 任何可能获得经验的事件后自动结算并展示
地图子系统(Excel核心): 定义了完整的网格地图标准(5尺/格、着色、Emoji图例、坐标轴)、更新规则和未来扩展预留接口。
2. 检定规则.md — 动作-检定映射表
包含6大类常见动作与对应检定的映射关系:
- 感知类: 察觉、调查、洞察、生存
- 隐匿类: 隐匿、巧手(开锁/拆陷阱/扒窃)
- 社交类: 说服、欺瞒、威吓、表演
- 知识类: 历史、奥秘、宗教、自然、传说
- 力量/体能类: 力量、运动(攀爬/游泳/跳跃)
- 特殊动作: 医疗、盗贼工具使用等
同时包含 DC 参考标准表(5 → 非常简单,10 → 普通, 15 → 困难, 20+ → 几乎不可能)
3. MODULE_INDEX.md — 模组索引
快速定位工具:
- 第一章流程速查图(石蜥门 → 佐迪 → 精灵之歌 → 公共浴室 → 地城 → 矮提灯 → 范萨姆普尔 → 烛堡)
- 第一章怪物索引(含附录D专属怪物)
- 当前队伍技能速查表(游荡者/圣武士/牧师/法师)
- 关键DC参考表
- 经验值/升级里程碑规划
4. MODULE_CHECKLIST.md — 模组推进检查表
铁律护栏:
- 不可跳跃的流程图
- 当前所在节点定位
- 模组原文引用区(每次回应前核对)
- 环境氛围和自由发挥的边界(✅ 允许 / ❌ 不允许 清单)
- 跑偏紧急修正指令
5. MODULE_DISPATCH.md — 模组运行调度规则
叙述控制引擎:
- 关键节点(Key Node) — 必须按顺序触发,不能跳过/颠倒/替换
- 自由填充(Free Fill) — 在两个关键节点之间的允许发挥空间
- 第一章关键节点清单(K1-K7,含触发条件和模组原文位置)
- 偏差纠正机制流程图
使用指南
第一步:准备依赖文件
将以下文件置于 Skill 工作目录根(即 SKILL.md 的同级或 references/ 同级的目录):
\x3C工作目录>/
├── 城主指南 (2024).md
├── 玩家手册(2024).md
├── 怪物图鉴(2025).md
├── 博德之门_ 坠入阿弗纳斯 - 关于冒险.md
├── 博德之门_ 坠入阿弗纳斯 - 地理志.md
├── 博德之门_ 坠入阿弗纳斯 - Ch. 1 两个城市的故事.md
├── 博德之门_ 坠入阿弗纳斯 - Ch. 2 深入埃尔托瑞尔.md
├── 博德之门_ 坠入阿弗纳斯 - Ch. 3 埃尔托瑞尔.md
├── 博德之门_ 坠入阿弗纳斯 - Ch. 4 破碎之地.md
├── 博德之门_ 坠入阿弗纳斯 - Ch. 5 坠入阿弗纳斯.md
├── 博德之门_ 坠入阿弗纳斯 - App. D 生物附件/ (文件夹内含怪物文件)
└── DMskill/ ← 本Skill所在的目录
├── SKILL.md
├── references/
└── scripts/
第二步:阅读并理解规则
首次使用时,DM 应完整阅读 references/ 目录下的所有规则文件,特别是:
DM_RULES.md— 核心运行流程检定规则.md— 动作-检定映射MODULE_DISPATCH.md— 关键节点调度逻辑
第三步:开始运行
- 使用
MODULE_CHECKLIST.md确认当前所在节点 - 打开对应模组章节文件,定位到当前节点位置的段落
- 仅使用该段落及之前已读取过的内容作为依据生成回应
- 每次检定遵循
检定规则.md的标准流程 - 每次经验结算遵循
DM_RULES.md规则5
预留脚本接口
scripts/ 目录为空,预留用于未来自动化扩展:
- 自动骰子脚本: 自动从4个角色卡中读取角色技能调整值并掷骰(PowerShell/Python)
- 地图生成脚本: 从模组的文字描述自动生成 Excel 网格地图(使用 openpyxl)
- 角色卡管理脚本: 自动更新角色卡和经验值
- 存档/加载脚本: 一键存档/加载队伍状态
欢迎贡献者在 ClawdHub 上提交 PR 或 issue。
版本信息
- 规则基准:D&D 5e 2024 版
- 模组适配:Baldur's Gate: Descent into Avernus(博德之门:坠入阿弗纳斯)
- 语言:中文
- 适用场景:AI 辅助地下城主运行 D&D 桌面角色扮演游戏
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install dnd5e-dm-skill - 安装完成后,直接呼叫该 Skill 的名称或使用
/dnd5e-dm-skill触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
dnd5e-dm- Descent Into Avernus 是什么?
为D&D 5e 2024版地下城主提供《坠入阿弗纳斯》模组专用的检定规则、流程控制、地图管理及经验结算辅助工具。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 67 次。
如何安装 dnd5e-dm- Descent Into Avernus?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install dnd5e-dm-skill」即可一键安装,无需额外配置。
dnd5e-dm- Descent Into Avernus 是免费的吗?
是的,dnd5e-dm- Descent Into Avernus 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
dnd5e-dm- Descent Into Avernus 支持哪些平台?
dnd5e-dm- Descent Into Avernus 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 dnd5e-dm- Descent Into Avernus?
由 ackiles(@ackiles)开发并维护,当前版本 v1.0.0。