AgentSkillsCN

rpg-dm-maps

以“渲染+数据+逻辑”三位一体的方式,生成并维护 ASCII 地图内容包,同时融入迷雾效果、版本迭代,以及 ARCHIVE_DELTA 的持久化机制。

SKILL.md
--- frontmatter
name: rpg-dm-maps
description: Generate and maintain ASCII maps as a content pack (render+data+logic triad) with fog-of-war, version bumps, and ARCHIVE_DELTA persistence.

RPG Maps (Content Pack)

Use this skill when the user asks to create/update/query maps, reveal fog-of-war, or ensure spatial consistency across sessions.

Files (authoritative)

  • Index: cartridges/<id>/maps/MAP_INDEX.md
  • Macro maps: cartridges/<id>/maps/macro/*
  • Micro maps: cartridges/<id>/maps/micro/*
  • Session instances (temporary reveals): campaigns/<id>/maps/runtime/*

Each map is a triad:

  • *.md (render)
  • *.data.yaml (structured data)
  • *.logic.md (constraints, derivations, update reasons)

Workflow (stable)

  1. Resolve which map_id is relevant (or create one) and register it in cartridges/<id>/maps/MAP_INDEX.md.
  2. Update the triad minimally; bump version on any change.
  3. Enforce fog-of-war: unknown stays ?; rumored POI is a point, not a full layout.
  4. Persist via ARCHIVE_DELTA (append/patch only). Never rewrite whole map files.

References

  • Full map protocol: Map-Gen.md
  • Reboot protocol: HOT_START.md (maps are WARM; don’t load unless needed)