# 小游戏 SDK 接入 Skill
小游戏 SDK 接入 Skill 是面向 AI Agent 的小游戏 JS-SDK 接入能力包，用于辅助接入方在游戏项目中完成小游戏 JS-SDK 的下载、部署、初始化、接口接入、版本升级和静态检测等工作。
该 Skill 不属于开放市场中的通用 Skill，而是 DHMiniSDK 业务配套的专用 Skill。接入方可将该 Skill 下载地址提供给自己正在使用的 AI Agent，由 Agent 自动下载、解压并安装到用户级全局 Skill 目录，使其对后续所有游戏项目生效。
# 基本信息
| 项目 | 内容 |
|---|---|
| Skill 名称 | dh-sdk-minigame-integrator |
| 适用对象 | 使用 AI Agent 接入小游戏 JS-SDK 的客户端项目 |
| 适用平台 | 微信、QQ、抖音、快手、B站、支付宝、淘宝、OPPO、VIVO、小米、华为、芒果tv等小游戏平台 |
| 下载地址 | https://docs.open.17m3.com/v2/skills/dh-sdk-minigame-integrator.zip (opens new window) |
| 版本信息 | https://docs.open.17m3.com/v2/skills/dh-sdk-minigame-integrator/version.json (opens new window) |
# 使用前提
使用该 Skill 的 AI Agent 需要具备以下能力：
- 支持本地 Skill、插件或工具包机制。
- 能读取本地文件和目录。
- 能在游戏项目中创建或修改文件。
- 能执行 Node.js 脚本。
- 能将 Skill 安装到用户级全局目录，使其对多个项目生效。
- 本地已安装 Node.js v16 或更高版本。
- 能访问 SDK 开放平台文档站点，用于下载 SDK 文件和 Skill 更新包。
如果当前工具不支持本地 Skill、文件读写、命令执行和项目修改，则不适合使用该 Skill 完成自动化接入。
# 安装方式
接入方无需手动下载、解压或复制 Skill 文件。推荐直接将以下下载地址交给正在使用的 AI Agent，并要求 Agent 自动完成安装。
下载地址：
https://docs.open.17m3.com/v2/skills/dh-sdk-minigame-integrator.zip
可直接向 Agent 发送如下指令：
请下载安装如下小游戏 SDK 接入 Skill。
下载地址：
https://docs.open.17m3.com/v2/skills/dh-sdk-minigame-integrator.zip
要求：
1. 下载并解压该 Skill。
2. 将 Skill 安装到当前 Agent 的用户级全局 Skill 目录中，而不是安装到当前游戏项目目录。
3. 安装完成后确认 Skill 根目录下存在 SKILL.md、version.json、references/、scripts/。
4. 安装完成后告诉我是否需要重启 Agent 或重新打开会话才能生效。
安装完成并重启或重新打开 Agent 会话后，即可在任意游戏项目中触发该 Skill，例如：
使用 dh-sdk-minigame-integrator 帮我接入微信小游戏 SDK。
# 适用场景
该 Skill 主要支持以下接入场景：
| 场景 | 说明 |
|---|---|
| 新项目接入 | 根据平台、版本、引擎和能力选择，完成 SDK 下载、配置生成和接口接入 |
| 存量项目纳管 | 检测项目中已有 SDK 接入情况，并生成或补齐 Skill 所需配置 |
| 单接口接入 | 仅接入指定能力，例如只接入 login、pay 或 uploadRoleInfo |
| 版本升级 | 对比当前版本和目标版本差异，辅助完成 SDK 替换和接口适配 |
| 多平台共存 | 在同一游戏项目中维护多个小游戏平台的接入配置 |
| 静态检测 | 接入完成后扫描 SDK 方法调用链，输出检测结果或报告 |
# 如何触发使用
在 AI Agent 中使用时，建议明确说出 Skill 名称、目标平台、SDK 版本、游戏引擎、接入能力和游戏项目路径。信息越明确，Agent 需要反复确认的内容越少。
# 新项目接入
使用 dh-sdk-minigame-integrator 帮我接入微信小游戏 SDK；项目路径是 E:\workspace\my-game，游戏引擎是 Cocos Creator；SDK 版本使用最新版本，需要接入 login、pay、uploadRoleInfo。
# 指定平台和版本接入
使用 dh-sdk-minigame-integrator 帮我接入淘宝小游戏 2.1.0 SDK；项目路径是 E:\workspace\my-game，需要接入 login、pay、uploadRoleInfo。
# 只接入单个能力
使用 dh-sdk-minigame-integrator，在当前项目中只接入 uploadRoleInfo 接口，不要处理其他接口。
# 存量项目检测和纳管
这是一个已经接过小游戏 SDK 的存量项目。请使用 dh-sdk-minigame-integrator 检测当前接入情况，并生成后续接入所需配置。
# SDK 版本升级
使用 dh-sdk-minigame-integrator 帮我评估微信小游戏 SDK 从 2.2.4 升级到 2.3.0 的影响。确认差异后，再辅助完成升级适配。
# 多平台共存接入
当前项目已经接入微信小游戏 SDK。请使用 dh-sdk-minigame-integrator 继续接入淘宝小游戏 SDK，并保持多平台配置共存。
# 接入后静态检测
小游戏 SDK 接入已经完成，请使用 dh-sdk-minigame-integrator 运行静态检测，并输出检测报告。
# 重要说明
该 Skill 的目标是辅助 AI Agent 更准确地接入小游戏 JS-SDK，减少人工查阅多平台、多版本文档的成本。它不会替代接入方对自身游戏业务逻辑、平台后台配置、登录验证、支付测试和真机调试结果的最终确认。