AgentSkillsCN

rpg-dm-kernel-protocol

基于文件系统，采用热/温/冷三种内存模式，运行长期运行的角色扮演游戏或 DM 会话；搭配精简代码的 HUD 界面、极简的 RAG 模型，以及 ARCHIVE_DELTA 的追加式/补丁式存档机制。

SKILL.md
--- frontmatter
name: rpg-dm-kernel-protocol
description: Run a filesystem-backed long-running RPG/DM session using HOT/WARM/COLD memory, short-code HUD, minimal RAG, and ARCHIVE_DELTA append/patch saves.

RPG DM Kernel Protocol (Filesystem-Backed)

Use this skill when the user is playing a text RPG / asking you to act as DM, and the project stores memory/state in markdown files (e.g. campaigns/<id>/index.md, campaigns/<id>/STATE_PANEL.json, campaigns/<id>/sessions/, cartridges/<id>/lore/, engine/mechanics/).

Hard rules (stable API)

  • •Kernel ≠ content: never embed world specifics into the kernel. Load them from content packs (files).
  • •Minimal load: prefer HOT summaries; WARM only when triggered; avoid COLD in-turn.
  • •Never decide for the PC: narrate, adjudicate, offer options.
  • •Conflict priority: campaigns/<id>/sessions/ > campaigns/<id>/STATE_PANEL.json/campaigns/<id>/index.md/campaigns/<id>/WORLD_STATE.md > object files > cartridges/<id>/lore/* > campaigns/<id>/Writing/*.
  • •Write only deltas: emit ARCHIVE_DELTA (HTML comment) with append/patch; never rewrite whole files.

Turn pipeline (single-agent)

  1. •Bootstrap: read minimal HOT state (time/location/indicators/clocks/active quest/NPC).
  2. •Parse input: accept either tag-style ([ACT]{...}) or command-style (@domain /cmd ...); infer intent if missing.
  3. •Fetch context: load at most 3 tiny snippets (≤12 lines each), obeying repo engine/mechanics/RAG_RULES.md.
  4. •Resolve: roll only if necessary; show formula; fail-forward; update indicators + clocks when appropriate.
  5. •Output: Scene (2–4 sentences) → Adjudication → Result/Consequences → 5 next suggestions → HUD → ARCHIVE_DELTA.
  6. •(Optional) also emit CONTEXT_PACK_NEXT for next-turn paste.

UI short codes (HUD)

Prefer: L# (location target), N# (NPC), I# (item/clue), Q# (quest), F# (faction). Short codes are UI-only and expire each turn; bind them internally to stable IDs (loc_*, npc_*, quest_*, ...).

References

  • •Turn protocol: see repo KERNEL_PROMPT.md
  • •Context pack schema: see repo engine/mechanics/CONTEXT_PACK.md
  • •State panel schema: see repo engine/mechanics/skills_repo/rpg-dm-function-calling-local/references/panels.json
  • •Retrieval rules: see repo engine/mechanics/RAG_RULES.md