请求 MSW 标准游戏功能时先查 MSWPackages…

当用户要求在 MSW 中实现 Toast、排行榜、背包、商店、邮件、任务、对话、按键、事件、存档、图鉴、命令、虚拟列表、掉落表、全局配置、GM 消息、资源或 UI 组件等标准功能时，先检查官方包目录，匹配则拉取 README 并提议集成。

适用场景

解决思路

1. 收到用户功能请求 X 后，将 X 与 Feature → Package 映射表匹配；若有匹配，优先检查 MSW-Git/MSWPackages 官方预构建包，而不是从零编写。
2. 若多个包可能匹配（例如「ranking」对应 basic 与 advanced），拉取两个 README，让用户根据比较选择。
3. 若没有匹配，按正常 MSW 创作流程继续（msw-scripting、msw-search 等）。
4. 若匹配，先做 Scope-First 检查：确定用户要完整系统（数据+逻辑+UI）还是仅 UI 屏幕。
5. 若范围不明确，在拉取包文件前先问一个简短问题，按关键词选择：Ranking/leaderboard 问「你还需要分数保存和排名计算，还是只要排行榜屏幕？」；Inventory/bag 问「你还需要添加/移除物品逻辑，还是只要槽位屏幕？」；Shop/store 问「你还需要货币扣除和购买处理，还是只要商店屏幕？」；Mail/mailbox 问「你还需要发送/接收逻辑，还是只要邮箱屏幕？」；Quest/achievement 问「你还需要进度追踪和奖励，还是只要任务列表屏幕？」；Toast/notification 问「你还需要队列/计时系统，还是只要消息弹窗？」；Dialog/NPC conversation 问「你还需要分支对话和状态，还是只要对话框？」；Collection/dex 问「你还需要收集状态和进度追踪，还是只要图鉴屏幕？」；Player data/save 问「你还需要持久化和加载/保存流程，还是只要资料屏幕？」；其他/不清楚 问「你需要可工作的功能，还是只要 UI 屏幕？」。
6. 根据回答路由：若用户说「feature」「system」「logic」「save」「calculate」「handle」「process」，留在 msw-packages，进入 Fetch Protocol。
7. 若用户说「screen」「UI」「look」「visual」「just the layout」「show only」，路由到 msw-ui-system 技能（+ references/templates/）：选择样式模板，然后用 UI builder 构建。
8. 若用户问低层问题（anchor、组件属性、enum），路由到 msw-ui-system 技能：直接通过 references/component-api.md（含 §Enums）和 ui-fundamentals.md 回答，无需 fetch。
9. 当请求已明确时跳过 Scope-First 问题并直接路由：「from scratch」「just the UI」「only the screen」→ msw-ui-system 技能（+ references/templates/）；「full system」「with backend」「with data」「save score」→ 留在 msw-packages；纯低层 UI 问题（如「how do I set anchor?」）→ msw-ui-system 技能。
10. 仅在关键词匹配目录包且范围确实模糊时才问 Scope-First 问题。
11. 默认姿态：集成前询问用户；未经确认不要自动安装，因为包可能与用户项目中的现有 UUID、sprite RUID 或命名约定冲突。
12. 映射表：Toast/notification/banner → maplestory-toast-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/maplestory-toast-package。
13. 映射表：Ranking/leaderboard/scoreboard（基础）→ ranking-basic-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/ranking-basic-package。
14. 映射表：Ranking/leaderboard（高级——多榜单、赛季）→ ranking-advanced-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/ranking-advanced-package。
15. 映射表：Inventory/item bag/equipment → inventory-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/inventory-package。
16. 映射表：Shop/store/purchase → shop-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/shop-package。
17. 映射表：World shop/premium shop → worldshop-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/worldshop-package。
18. 映射表：Mail/mailbox → mail-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/mail-package。
19. 映射表：Quest/achievement/mission → quest-achievement-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/quest-achievement-package。
20. 映射表：Dialog/NPC conversation（typewriter style）→ dialog-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/dialog-package。
21. 映射表：Key binding/virtual button → key-binding-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/key-binding-package。
22. 映射表：Game event broadcast/pub-sub → game-event-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/game-event-package。
23. 映射表：Player data/save/profile → player-data-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/player-data-package。
24. 映射表：Collection/gallery/dex → collections-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/collections-package。
25. 映射表：Slash command/chat command → command-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/command-package。
26. 映射表：Virtualized scroll list/large list → recyclescrollview-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/recyclescrollview-package。
27. 映射表：Drop table/loot probability → droptable-resolver-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/droptable-resolver-package。
28. 映射表：Global config/shared settings → global-config-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/global-config-package。
29. 映射表：GM/system announcement → gm-message-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/gm-message-package。
30. 映射表：Game resource（currency、energy、refillable）→ resource-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/resource-package。
31. 映射表：UI components and prefab models → ui-component-package，路径 https://github.com/MSW-Git/MSWPackages/tree/main/ui-component-package。
32. Fetch Protocol：识别候选包后，始终先用 WebFetch 拉取 README：https://raw.githubusercontent.com/MSW-Git/MSWPackages/main/<package-name>/README.md；在继续前向用户总结 public API 和用例。
33. Fetch Protocol：集成可能性高时，用 GitHub tree API https://api.github.com/repos/MSW-Git/MSWPackages/git/trees/main?recursive=1；响应可能很大且被截断，在响应中 grep `<package-name>/` 提取文件列表；若截断，退回按目录调用 https://api.github.com/repos/MSW-Git/MSWPackages/contents/<package-name>/MyDesk。
34. Fetch Protocol：标准包布局为 <package-name>/README.md；<package-name>/<PackageName>.modpackage 是安装清单，视为不透明；MyDesk/<PackageName>/Core/ 是核心脚本/UI，要复制；MyDesk/<PackageName>/Sample/ 是示例用法，除非要求否则不要复制；MyDesk/Util/ 是共享工具（某些包有）。
35. Fetch Protocol：按需逐文件拉取，用 https://raw.githubusercontent.com/MSW-Git/MSWPackages/main/<path>；把浏览 URL github.com/.../blob/main/... 替换为 raw.githubusercontent.com/.../main/...。
36. Integration Workflow：用户确认集成后，映射文件到项目布局：MyDesk/<PackageName>/Core/*.mlua → RootDesk/MyDesk/<PackageName>/；MyDesk/<PackageName>/Core/*.ui → ui/；MyDesk/<PackageName>/Core/*.model → RootDesk/MyDesk/Models/<Category>/；MyDesk/Util/* → RootDesk/MyDesk/Util/（若已存在则复用）。
37. Integration Workflow：检查 UUID 冲突：传入 .ui/.model 文件中每个实体 id 和 EntryKey 不能已存在于用户项目；写入前 grep 工作区；若有冲突，用新的 hex UUID 重新生成。
38. Integration Workflow：检查 sprite RUID 依赖：扫描包文件中硬编码 RUID；它们引用 MSW 社区资源，通常没问题，但若有可疑或需要替代，用 msw-search 验证。
39. Integration Workflow：解决跨包依赖：有些包依赖其他包（如 ranking 可能基于 player-data）；读包 README 和源码头，先安装传递依赖，再安装本包。
40. Integration Workflow：用标准 MSW 工作流应用：stop → refresh_workspace → play；在构建日志和运行时日志中验证。
41. Integration Workflow：接入用户代码：大多数包暴露 _<PackageName> Logic 单例；从用户现有脚本调用其 API，例如 _MaplestoryToast:Show(...)。
42. Pitfalls：.modpackage 文件在此工作流中不是自动安装脚本，而是 Maker 编辑器元数据；实际集成靠手动复制文件。
43. Pitfalls：样本中硬编码 sprite RUID：包样本常引用特定 RUID 做装饰 sprite；它们可用但用户可能想替换；总结时说明。
44. Pitfalls：UI 文件使用 UIGroup 根实体；复制时通过 msw-ui-system（UIBuilder.read/load 检查，builder API 修改；设计规则 UIGroup 根配置、anchor 模式陷阱在同一技能）；不要手工编辑原始 .ui JSON。
45. Pitfalls：Sample/ 内容是示例而非生产；除非用户明确要求，不要复制 Sample/ 文件；样本脚本常绑定键盘快捷键，可能与用户控制冲突。
46. Pitfalls：没有包能替代对 mlua 的理解；包提供预构建功能，但用户仍需 msw-scripting 知识来扩展。
47. Pitfalls：不要推测性批量安装多个包；每个集成增加文件和表面积；一次安装一个功能，验证后再继续。
48. 当用户已经选择「build from scratch」：完全跳过集成，继续正常 MSW 创作（msw-scripting、msw-search 等）；不要默默继续推荐包。
49. 当 MSW-Git/MSWPackages 不可达：WebFetch 返回错误或 404 → 确认 URL 未变。
50. 当 MSW-Git/MSWPackages 不可达：沙箱网络可能阻止直接 curl 到 api.github.com；优先用 WebFetch 处理 raw 和 HTML URL。
51. 当 MSW-Git/MSWPackages 不可达：若全部失败，回退从零构建，并告诉用户包当前不可访问。
52. Cross-references：msw-general — 工作区、文件路径、MCP 工具、坐标系。
53. Cross-references：msw-scripting — .mlua 语法，用于把包 API 接入游戏逻辑。
54. Cross-references：msw-search — 替换包捆绑资源时查找 sprite/animation/sound RUID。

适用边界 · 注意事项

• 用户明确只要 UI 屏幕、布局或视觉样式，或问低层 UI 问题（anchor、组件属性、enum）时，不适用本技能的包集成流程，应路由到 msw-ui-system（+ references/templates/）。
• 用户已明确选择从零构建（build from scratch）时，不适用本技能，应跳过集成并继续正常 MSW 创作，不要继续推荐包。
• 请求与目录包无匹配，或 MSW-Git/MSWPackages 不可达且所有获取方式失败时，不适用本技能，应回退从零构建并告知用户包当前不可访问。