validate-module-playability

name	validate_module_playability
description	检查模组是否具备开场、场景、探索区域、隐藏真相和推进节点。
scenarios	["authoring"]
metadata	{"author":"meathill","version":"1.1.0","group":"module","execution-mode":"native"}

检查模组可玩性

检查模组是否具备开场、场景、探索区域、隐藏真相和推进节点。

When to use

• 模组草稿整理完成后做可玩性验收。
• 开团前确认不会因为缺线索或缺场景直接卡死。

Do not

• 模组信息不足时直接开团。
• 仅检查结构完整性而忽略线索可达性——结构完整但线索断链同样会卡死。

完整验收清单

结构层

• 开场入口：有明确触发条件和委托人
• 场景数量：≥2 个可探索场景
• 探索区域：每个场景有可互动地点
• 隐藏真相：存在且对 AI 守秘人明确
• 推进节点：各场景之间有明确流转条件

线索链层（重点，最容易出问题）

• 核心解法线索：不依赖任何检定，至少有一条必经线索直接指向解法
• 触发词设计：NPC 觉醒/触发条件不要求玩家先知道答案才能触发
• 角色替代路径：神秘学/法律等专业技能为 0 的角色有非检定的替代解法
• 可选场景保底：被标为「可选」的场景若含关键线索，必须在必经场景中也提供该线索的简化版

角色适配层

• 关键 NPC 卡牌：type: "key_npc" 和 card_ref 已在模组 npcs 中标注
• 选项池：已调用 patch_options 定义出身/装备/buff/debuff

开团准备层

• 玩家简报：player_briefing 存在（不含隐藏真相）
• 守秘人速查：keeper_quickref 存在（时间线 + 检定汇总 + 必触发线索）
• 房规：house_rules 存在（哪怕只有 1-2 条轻松团简化规则）

Contract

当前 skill 的参数、边界与返回要求以本文件说明为准。

Usage

1. 先理解用户当前意图是否真的需要此 skill。
2. 根据本技能的说明填写参数。
3. 不要在正文里伪造 tool 调用结果。
4. 如果宿主支持执行层，可把该 skill 映射到项目内的同名实现。