SuperAPI AI 工具集

gm-dungeon

通用与其它

查看项目

更新于 10-21 16:54

技能介绍

用途

gm-dungeon 是 claude-code-game-master 技能集中的一个子技能,专门用于跑团(TRPG)中的地牢探索环节。当队伍进入地下城、需要逐房间推进或反复探索同一地点时加载该技能,由它来规范场景描述、出口处理、障碍判定与地图记录。

两种模式

技能提供两种运行模式,按场景需要选择:

  • 轻量模式(默认):适合快速、叙事驱动的探索。整个地下城作为一个主地点条目记录,内部使用 internal_layout 与 areas_visited 字段跟踪布局和已访问区域。
  • 结构化模式:适合战术性强、或队伍反复探索三次以上的地牢。每个房间作为独立地点条目,包含 dungeon 字段、出口(exits)与状态(state)。

主要能力

轻量模式流程

进入 → 描述入口与可见出口 → 探索(仅在战术上有必要时绘制地图,而非每个房间都画)→ 按区域进行战斗 → 离开时若情节重要则更新主记录。

结构化模式流程

校验出口(是否存在?是否上锁或隐藏?)→ 处理障碍(撬锁、强拆、钥匙;通过 Perception 检定发现密道)→ 将目的地标记为已发现或已访问 → 执行 gm-session.sh move "[Dungeon - Room]" → 以 2-4 句描述房间并列出出口与生物。

探索奖励

技能规定,一次探索上的突破应当像击杀敌人一样获得进度奖励,例如:解除致命陷阱、找到密道、惊险逃脱、穿越严酷危险地形、利用环境完成击杀。奖励需在叙述之前先持久化,命令为:

bash tools/gm-player.sh award --tier minor|major|legendary --reason "..."

该奖励机制会感知规则套件(kit-aware)、按等级缩放,并在 DCC 中同时奖励随从。相关设计理念参见 gm-craft 的“Reward the spectacle”部分。

ASCII 地图符号

技能定义了一套 ASCII 地图符号用于记录地牢:

  • @ 当前位置
  • + 门
  • # 上锁的门
  • △ 上行楼梯
  • ▽ 下行楼梯
  • ~ 已发现的密道
  • ▓ 战争迷雾

使用方式

该技能通过技能加载机制在需要时载入,配合 gm-session.sh 与 tools/gm-player.sh 等脚本使用。具体安装方式与完整依赖暂未提供。

适用场景

适用于任何需要地下城探索的跑团场景,尤其是需要区分快速叙事推进与逐房间战术推进的场合,以及需要记录已探索区域、出口状态和地图符号的长期战役。

限制

资料未说明该技能支持的具体规则系统范围、脚本运行环境要求、与其他技能的依赖关系,以及除上述命令外的其他接口。这些内容暂未提供。