player-interaction-designlisted
Install: claude install-skill kiakun-collab/kiakun-skills
# 玩家互动设计
## 边界
本 skill 只触发玩家互动设计流程,不重复 `AGENTS.md`、任务包或项目 guide。
优先级:
1. 用户本轮指令
2. 具体任务包
3. `AGENTS.md`
4. 相关 `docs/agent_guides/**`
5. 本 skill
如果冲突,按更高优先级执行,并说明冲突点。
## 必读
优先读取当前项目内的同名规则;如果项目未提供对应文件,读取本 skill 打包资源:
- 玩家互动合同:`references/player_interaction_contract.md`
- 合同模板:`assets/templates/player_interaction_contract.md`
- 合同校验脚本:`scripts/validate_player_interaction_contract.py`
涉及玩法、UI、GDD、文案、引导、失败恢复或结算复盘,先读:
`docs/agent_guides/player_experience_first.md`;若项目没有该文件,则按本 skill 的玩家互动合同执行。
涉及玩家互动合同,读:
`docs/agent_guides/player_interaction_contract.md`;若项目没有该文件,读本 skill 的 `references/player_interaction_contract.md`。
涉及证据、截图、Playtest Bridge、visible-window 或体验结论,读:
`docs/agent_guides/evidence_levels_and_claims.md`;若项目没有该文件,至少按本 skill 的证据层级选择表收口。
## 合同粒度
写完整合同:
- 新入口、新面板、新弹窗、新挑战、新失败恢复、新结算反馈。
- 改变玩家目标、操作顺序、状态门槛、解锁路径或跨日链路。
- 需要声明“玩家能看见、点到、读懂、体验可理解”。
写短合同:
- 改动范围只涉及已有流程内的文案、标签、颜色或布局。
- 不新增入口、弹窗、状态门槛、主操作或恢复路径。
如有疑问,默认写完整合同。宁可多写,不漏失败恢复路径。
## 执行��求
实现、拆任务包或写验收前,先写玩家互动合同。
证据层级必须使用项目既有口径,并按 `player_interaction_contract.md` 的前置条件选择。只跑 headless/focused runner 时,不得声称玩家真实体验通过或自然通关。
`证据层级` 是结构化字段,只填写 `logic_runner`、`ui_contract`、`interactive_mcp`、`visible_capture`、`manual_canary` 或明确被任务要求的 `natural UI-only`。runner、fixture、加速、bridge helper、fallback 等支撑说明写到 `证据说明`、验收要求或 `not_proven`,不要塞进 `证据层级`。
写完合同或任务包后,运行:
```sh
python3 scripts/qa/validate_player_interaction_contract.py --mode auto <markdown...>
```
如果项目没有该脚本,改用本 skill 打包脚本:
```sh
python3 <skill-dir>/scripts/validate_p