game-manager-skill

游戏主控技能 (Game Manager Skill)

概述

本技能是整个武侠世界的“天道”，负责管理所有 Skill 的生命周期、状态持久化以及世界线的重置工作。

核心职责

1. 持久化管理：通过 persistence.py 驱动 SQLite 存档与读档。
   • SQLite 中心化: 所有 Skill 的 references/ 数据在存档时必须同步至 assets/saves/wuxiaX.db。
   • 差异同步原则: 读档时，必须以数据库为准，自动识别并强制覆盖本地有差异的 Skill 实体文件。
   • 指令调用:
     • /game-save: 触发全量数据库存档。
     • /game-load: 从数据库恢复状态。
2. 全局同步：确保所有 Skill 实体文件（.md）与中心数据库保持 100% 同步。
3. 世界重置：处理 /game-restart 指令，通过 reset_game_state() 还原所有数据至初始模板。

指令逻辑：/game-restart

当玩家输入重置指令时，必须执行以下流程：

1. 物理重置：调用 python .agent/skills/game-manager-skill/scripts/manager.py --reset。
   • 这将还原所有 references/*.md 至初始模板，并清空数据库与章节历史。
2. 建立新缘：物理重置完成后，说书人（story-engine）必须立刻发起引导式对话：
   • 确定主角的基本属性（姓名、性别、出身）。
   • 让玩家选择性格特质（正、邪、狂、狷倾向）。
   • 选择初始武学流派。
   • 设定世界难度。
3. 铭刻初始：将玩家的选择写入 protagonist-skill/references/character_sheet.md，然后正式开启“圣堂觉醒”第一回。

脚本索引

• scripts/manager.py: 核心管理逻辑。
• scripts/persistence.py: 数据持久化接口。
• scripts/db_init.py: 数据库初始化。