SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场hz-quest-verify-first

hz-quest-verify-first

智能体与模型

查看项目

更新于 10-15 18:06

技能介绍

用途

该技能是 Meta Quest VR/MR 开发相关的强制前置核查流程。其定位是一个硬性门禁（hard gate），而非可选建议：在回答任何 Quest 相关问题或编写任何 Quest 目标代码之前，必须先完成验证。

技能适用的触发条件包括：用户提及 Meta Quest、Quest 2 / 3 / 3S / Pro、Oculus、Horizon OS、MR、VR、XR、OpenXR（Quest 端）、Meta SDK、Meta XR、OVR、Spatial SDK、IWSDK、MRUK、Movement SDK、Voice SDK、Presence Platform、Horizon Platform SDK、手部追踪、透视、锚点、场景网格、投屏、眼动追踪、身体追踪、控制器，或平台合规 / 商店政策；仓库中包含 OVRPlugin、Meta XR All-in-One SDK、com.meta.xr.、Spatial SDK gradle 插件、含 com.oculus. / com.meta.quest.* 或 horizon 特性声明的 AndroidManifest、com.meta.* / com.oculus.* 包 ID、.meta 文件或 Quest_*.uplugin / *.unrealhxr 文件；用户问题引用 Meta 开发者文档 URL；智能体即将推荐任何 Meta SDK API、命名空间、包或 AndroidManifest 权限项；即将回答应用审核、Meta Horizon Store 提交、商店就绪或发布要求、内容分级、分发相关问题；即将编写针对特定设备的 adb 命令；即将断言用户 Meta VR 设备上安装了或未安装什么。若不确定是否适用，按“是”处理并运行验证流程。

主要能力

技能围绕 metavr（Meta VR CLI）及其 MCP 服务器提供的工具展开。相关工具包括：

  • vr_docs_search — 搜索 Meta 官方开发者文档
  • vr_docs_get_page — 获取特定文档页面的全文
  • device — 查询与控制已连接的 Meta VR 设备与 Quest 头显（列表、信息、连接、重启、电量、控制器、接近传感器等）
  • app — 查询与管理已安装应用（列表、信息、安装、卸载、启动、停止、清除）
  • files — 连接设备上的文件操作（ls、push、pull、rm、mkdir）
  • run — 无专用工具的 metavr 子命令的兜底入口（perf、ovrmetrics、ui、audio、casting、window、unity、sideload、asset、config 等）
  • cli_help — 以 markdown 形式发现 metavr 子命令与参数

metavr 是由 Meta 发布的 Rust CLI 工具，提供独立二进制与 npm 包，可通过 metavr <args> 调用，或用 npx -y metavr <args> 免安装运行。它封装了 adb 与 Meta 开发者 API，是 Meta VR 开发工作的主要操作层。

技能还解释了相关背景概念：Meta Quest 是基于 Android 的独立 VR / 混合现实头显系列；Horizon OS 是该操作系统名称，从 Android 分叉而来，Meta 按自己的节奏更新，许多 API 为 Horizon OS 独有；Meta SDK 家族（Meta XR All-in-One SDK、Meta XR Core / Interaction / Platform / Voice / Movement SDKs、Meta Spatial SDK、IWSDK、MRUK、Presence Platform、Horizon Platform SDK）有独立发布节奏；OVR 命名空间与 “Oculus Integration” Unity 包已弃用，但多数训练数据仍推荐这些弃用名称。

使用方式

技能规定的验证流程分为四步。

第 1 步 — 识别构建路径。 先分类项目，再选择 SDK、文档范围与专项技能。信号与路由对应如下：标准 Android（Activities、Views、Compose、React Native、Expo 或现有手机/平板应用渲染在系统面板中）路由到 hz-android-2d-porting，React Native 或 Expo 走 hz-react-native-expo，新应用走 hz-new-project-creation；Meta Spatial SDK（含 com.meta.spatial 依赖或沉浸式 Kotlin/Android 场景）路由到 hz-spatial-sdk；Unity 路由到 hz-unity-project-analyzer（现有项目）或 hz-unity-meta-core-sdk（核心 SDK 设置）；Unreal Engine 新应用走 hz-new-project-creation，否则无专用技能，使用第 2 步并设 scope="unreal"；原生 OpenXR 无专用技能，使用第 2 步并设 scope="native"；WebXR 路由到 hz-iwsdk-webxr，PWA 分发走 hz-store-pwa。不要仅因面向 Quest 就给标准 Android 应用添加 Meta Spatial SDK。信号重叠时按特定优先级分类。

第 2 步 — 对照权威文档验证。 在编写或推荐任何 Quest 特定内容前，调用 vr_docs_search（MCP）或 metavr docs search（CLI），查询即将做出的具体主张或 API，scope 可设为 auto 或 unity / unreal / spatial_sdk / android / native / web / policy / distribution / design，mode 设为 verify。若需确切措辞（manifest 条目、完整 API 签名、商店政策文本、代码片段），用 vr_docs_get_page（MCP）或 metavr docs fetch（CLI）获取全文，不要转述截断片段。

第 3 步 — 验证用户实际环境。 在建议针对哪台设备、声称应用已安装、推荐 adb 命令或编写安装/启动/sideload 步骤之前，查询 metavr 管理的实际环境：device(action="list") 始终作为起点，然后 device(action="info")、app(action="list")、app(action="info")、run(subcommand=["config", "show"])；对应 CLI 为 metavr device list、metavr device info <serial>、metavr app list -d <serial>、metavr app info <package>、metavr config list。用户可能连接零台、一台或多台 Meta VR 设备（通过 USB 与 WiFi），训练数据对此毫无可见性。

第 4 步 — 不确定时发现 metavr 能力。 若不知道哪个 metavr 子命令适用，先调用 cli_help（MCP）或 metavr --markdown-help（CLI），不要臆造参数或子命令。run 工具的输入 schema 通过 JSON Schema oneOf 枚举了每个子命令路径及其类型化参数，可直接从工具定义中读取。

适用场景

技能适用于 Meta Quest 与 Horizon OS 相关的问答和代码编写场景，尤其是：推荐 Meta SDK API、命名空间、包或 AndroidManifest 权限项；回答应用审核、Meta Horizon Store 提交、商店就绪或发布要求、内容分级、分发问题；编写针对特定设备的 adb 命令；断言用户设备的安装状态。技能也列出了可通过跳过验证避免的具体故障模式：弃用 API 能编译但运行时无操作；AndroidManifest 权限项导致应用被商店拒绝；Meta SDK 包名不存在；Unity 菜单路径过时；Spatial SDK 类名在公开发布前被重命名；在上一个 Horizon OS 版本可用的透视/锚点/场景网格设置失效；OpenXR 扩展在 Quest 运行时列出但不受支持；目标设备错误；商店政策主张过时。

限制与注意事项

技能明确禁止以下反模式：不先调用 vr_docs_search 就凭记忆回答 Quest 问题；不先调用 device(action="list") 就推荐 adb shell 命令；凭训练数据猜测包名、命名空间或类名；在需要确切措辞时转述验证结果片段；在官方 Meta 文档一次工具调用即可获得时去搜索开放网络；以“文档大概说的是 X”为由跳过验证；假设 metavr 没有用户所需子命令而不先查 cli_help。

当呈现验证后的答案时，技能要求附带引用与简短的新近性说明。若 metavr MCP 工具不可用，回退到 metavr CLI（同一权威后端，使用 npm 分发时加 npx -y 前缀），并告知用户如何安装 MCP 服务器（metavr mcp install <your-tool> 或 metavr mcp install project）。验证步骤是必需的而非可选，即使 MCP 服务器尚未接入，也要通过 metavr docs search 运行。

相关技能

metavr-cli（完整 CLI 参考）、hz-vr-debug（设备日志与截屏调试）、hz-perfetto-debug（Perfetto trace 分析）、hz-store-submit（Meta Horizon Store 提交）、hz-android-2d-porting、hz-react-native-expo、hz-new-project-creation、hz-spatial-sdk、hz-platform-sdk、hz-xr-simulator-install-and-configure、hz-unity-project-analyzer、hz-unity-meta-core-sdk、hz-iwsdk-webxr、hz-store-pwa。

关于该技能的具体收费、价格等信息，资料中暂未提供。