返回 Skills
剧本逻辑校验与死局排查
全方位体检：拓扑图扫描 → 选项死局检查 → 语法与变量审计 → 诊断报告与一键干跑修复，杜绝上线后翻车。
校验时建议先通读诊断报告，优先处理阻断性错误（悬空场景、死局）；任何修复需先经 dryRun 验证无误后再写库。
1
第 1 步：读取剧本与拓扑初始化
获取目标剧本的完整 DSL，解析所有场景节点、选项跳转、重定向与变量声明。
用到的工具：
listGamesgetGameInfogetDsl请调用 listGames 列出我的游戏，待我选定后提取目标剧本的完整 DSL 正文，并梳理出场景列表、变量列表与跳转关系图谱。
完成标准：成功读取 DSL，提取全部场景 ID、选项跳转目标与声明变量集合。
2
第 2 步：图连通性与死局排查
排查缺失 # start、悬空跳转目标、无条件选项缺失导致的死局、以及孤岛未引用场景。
用到的工具：
getDsl请审查剧本的连通性：1. 是否存在 # start 场景；2. 所有选项和重定向的目标场景是否都存在（杜绝悬空跳转）；3. 分支场景是否至少有一个无条件选项兜底（防死局）；4. 是否存在没有任何入口的孤岛场景。
完成标准：列出所有悬空引用、死局场景及孤立场景的详细列表。
3
第 3 步：变量与表达式语法严谨性审计
检查未声明变量、表达式文法合规性（= vs ==）、插值与条件模板语法。
用到的工具：
getDsl请检查所有变量与逻辑语法：1. 条件判定 (if:) 与状态更新 (set:) 中的变量是否已在 initialState 声明；2. 是否误用单个 = 进行比较，或赋值语句缺少等号；3. {{ variable }} 与 {{ if }} 模板语法是否合法。完成标准：列出所有未声明变量、表达式语法错误及模板拼写问题。
4
第 4 步：角色设定与对白匹配度核验
排查正文中所有 @角色ID 对白行，确认其已在 ai.characters 注册，并具备稳定外貌描述。
用到的工具：
getDslgetGameInfo请核对剧本中的角色对白：提取所有 @角色ID 对话行，比对 ai.characters 注册表，找出未注册的角色 ID，并检查重要角色是否配有用于生图的 image_prompt。
完成标准：核对全部说话人 ID，输出未注册角色预警与设定补全建议。
5
第 5 步：出具诊断报告与安全一键修复
出具结构化体检报告，对错误提出修复建议；确认修复后先 dryRun 校验，再安全写库。
用到的工具：
setGameDslupdateSceneTextaddChoiceaddVariableupdateGameMeta请汇总前四步结果，输出清晰的《剧本逻辑健康诊断报告》（阻断错误、体验警告、修复建议）。经我确认后，执行修复并调用 setGameDsl(dryRun: true) 验证，通过后正式落库。
完成标准：输出规范报告，修复后剧本 100% 通过语法与逻辑验证，线上播放正常。