小游戏首包与分包优化

以“冷启动到首次可交互”的总耗时为目标，不把主包字节数最小当作唯一目标。主包只承担启动闭环，其余内容按使用阶段和功能生命周期拆分，并以真实构建产物验证。

工作流

1. 确认目标平台、Creator 版本、构建目录、平台限制和首次可交互定义。涉及发布时先读 references/platform-adapters.md，并重新核验平台官方文档。
2. 读取启动 Scene、入口代码、资源索引、Bundle 根目录 .meta 和构建配置，识别启动阻塞依赖。涉及 Prefab/Scene/meta/asset-index 时组合 cocos-asset-json。
3. 按 references/cocos-bundle-strategy.md 分类资源。按加载时机和功能闭环拆分，不按文件类型机械拆分。
4. 先给出主包预算、Bundle 清单、资源迁移、加载时序、释放策略和验证方案。移动资源或改变生成规则前按项目 SDD 门禁取得批准。
5. 修改源资产和 Bundle 配置后，通过项目既有生成器刷新资源索引；禁止手改构建产物或生成产物掩盖源问题。
6. 启动只等待首次交互必需资源；首帧稳定后限并发预取高概率下一阶段资源；低频内容进入功能前懒加载。加载路径需要有失败、重试、取消或降级语义。
7. 执行干净的目标平台构建。产物使用 game.json 与 subpackages/ 布局时运行本 skill 的两个脚本；其他平台按官方 schema 选择参数或扩展校验器。

边界

• 平台主包、单分包和总包限制由调用方按本次官方文档显式传入，不在脚本中固化。
• 主包不得静态引用非启动必需的大资源；检查 Scene、Prefab、Atlas、Material、字体和音频的传递依赖。
• 共享 Bundle 只收纳确实被多个延迟功能复用的资源，避免“公共包”无限膨胀。
• 禁止在启动时加载全部 Bundle 或预加载全部资源。
• 分包下载与内存释放分别设计，继续遵守项目的 addRef/decRef、自动 holder 和 Bundle 生命周期。
• 不因远端 RPC 或网络超时迁移资源；先区分本地构建错误、平台包体校验与平台服务故障。

确定性检查

以下命令适用于使用 game.json 和 subpackages/ 的构建产物：

node .agents/skills/optimize-minigame-packages/scripts/analyze-package-size.mjs `
  <platform-build-dir> `
  --main-limit-mb <main-limit> --subpackage-limit-mb <subpackage-limit> --total-limit-mb <total-limit>

node .agents/skills/optimize-minigame-packages/scripts/validate-bundle-layout.mjs `
  <platform-build-dir> `
  --asset-index <asset-index.json>

两个脚本退出码非零时不得宣称验证通过。参数不确定时先运行 --help。

验收

• Creator 目标平台干净构建成功。
• 主包、各分包与总包满足本次核验的平台限制，并保留项目约定余量。
• 包配置、分包目录与资源索引 Bundle 一致，无重复逻辑名、空分包或漏声明目录。
• 冷启动到达首次交互；核心路径和至少一个延迟功能完成加载、退出与重进验证。
• 弱网/失败路径可重试或降级；后台下载不阻塞操作，不造成明显帧率或内存回归。
• 最终报告真实包体、限制来源、未验证项与剩余风险。

参考路由

• 设计 Bundle、判断首包归属或安排加载时序时读取 references/cocos-bundle-strategy.md。
• 处理平台构建、限制、分包 API 或开发者工具错误时读取 references/platform-adapters.md，再核对目标平台官方文档。