概述

2026-11-02评分加载中…

Open Pilot Wizard(简称 OPW)是一套帮助你用 AI 开发 Pilot 开放插件的工具包。将 OPW 安装到 AI 编程工具(下文简称 AI 工具)后,你只需用自然语言描述需求,AI 就会借助 OPW 提供的插件开发知识和工作流程,帮你创建工程、开发功能、迁移 MSDK 应用或解答能力问题。

一句话需求加上 AI 编程工具和 OPW,生成可在遥控器 Pilot 中运行的开放插件

OPW 目前支持 OpenCode、Claude Code 和 Codex 三种 AI 工具。想直接上手,见快速开始。

为什么需要 OPW

Pilot 开放插件是独立安装在遥控器上的 Android 应用,与 Pilot 运行在两个进程中,通过 SDK 建立连接。除了业务代码,你还需要处理插件身份声明、App Key 绑定、MSDK 与 UXSDK 版本匹配、带屏遥控器调试等一系列配置和约束。

通用 AI 模型并不掌握这些领域细节。直接让它写插件代码,常见的结果是代码看起来正确,却编译不通过,或者安装后 Pilot 识别不到插件。

OPW 把这些领域知识和开发流程沉淀为 AI 可以直接调用的能力:AI 在动手前先查依据,按固定步骤推进,并在交付前完成校验。理解需求和编写代码仍由 AI 负责,关键决策仍由你确认。

层次结构

OPW 由四层组成:编排层接收需求并分派给 Skill 层;知识库层和 OpenSpec 层并列在 Skill 层之下,分别为它提供查询依据、记录开发过程。

OPW 分层架构:编排层、Skill 层、知识库层与 OpenSpec 层

下面四节各用一个具体例子,说明这一层解决什么问题、起什么作用。

编排层

编排层是 OPW 的统一入口。你描述需求后,编排层先识别当前目录的工程状态(空目录、普通 Android 工程、MSDK 应用或已有的 Pilot 开放插件),再结合你的意图,把任务交给唯一对应的 Skill。工程状态与意图不匹配时,例如在已有插件工程中提出迁移 MSDK 应用,编排层会先向你确认,不会自行猜测。

同一句需求在空目录和 MSDK 应用目录里,编排层的路由结果不同

编排层同时约束 AI 的基本行为:涉及接口、错误码和组件属性时,必须先查知识库,不凭记忆编写;Skill 规定的检查必须执行,不能跳过。

不同 AI 工具进入编排层的方式不同:

  • OpenCode:按 Tab 切换到 pilot-plugin-dev 智能体,或在消息中使用 @pilot-plugin-dev。
  • Claude Code:执行 /output-style pilot-plugin-dev 切换到该输出样式,执行 /output-style default 切回默认模式。
  • Codex:不需要切换。opw Skill 即编排层入口,直接描述需求或调用 opw Skill 即可。

CodeBuddy、Trae 等其他 AI 工具,可以让 AI 参照 OPW 的安装内容自行适配,见在其他 AI 工具中使用。

你也可以跳过编排层的路由,直接调用对应的任务 Skill(如 opw-plugin-create)。此时由你指定任务类型,Skill 内部仍按 OpenSpec 工作流执行,方案批准和交付前检查照常进行。具体方式见使用。

Skill 层

每个 Skill 对应一类开发任务,规定 AI 先做什么、后做什么,哪些节点必须等你批准,以及交付前必须通过哪些检查:

四个 Skill 的适用任务,以及每个 Skill 内部的固定步骤与两道闸门

知识库层

知识库是 AI 查询依据的来源,安装 OPW 时同步到本机,多个项目共用一份。主要包括:

  • API 参考:MSDK 与 Pilot 开放插件的接口定义,与模板使用的 SDK 版本保持一致。
  • 能力文档:各项 MSDK 能力和 Pilot 开放能力的用法说明。
  • 运行纪律:调用时序、资源释放、错误处理等易错点。
  • 最佳实践:工程架构、编码规范,以及插件原生页面和 Pilot 内嵌 UI 的设计规范。
  • 常见问题:SDK 初始化、权限、构建等问题的排查方法。

AI 按需检索与当前任务相关的内容,不会一次性加载整个知识库。

同一个任务:凭记忆写会编译不过,先查知识库则拿到准确定义

OpenSpec 层

OpenSpecopen in new window 是一个开源的规格驱动开发框架。OPW 基于 OpenSpec 管理每一个开发任务,把任务拆分为方案说明、需求规格、设计方案、设计确认、编码实现、验证和归档收尾等阶段,并将各阶段的文档保存在工程的 openspec/ 目录中。

这一层带来三点好处:

  • 方案先确认,再动代码:设计方案经你批准后,AI 才开始编码实现。
  • 中断后可以继续:会话中断后,AI 根据已保存的文档恢复进度,不需要从头开始。
  • 过程可追溯:需求规格、设计方案和验证记录可以提交到 Git,供团队评审。

会话中断后,AI 读 openspec/ 恢复进度,从中断处接着做

OpenSpec 由 Skills 在内部调用,你不需要学习或执行 OpenSpec 命令。对话中 AI 会用「任务」「设计方案」「设计确认」等名称称呼这些阶段;只做能力咨询时,不会创建开发任务。

使用预期

  • OPW 能减少你查阅文档和搭建工程的时间,但不会自动保证业务逻辑正确。需求范围、验收标准和是否发布,仍然由你决定。
  • 构建通过、安装成功和运行正常是三个独立的结果,需要分别确认。
  • 涉及性能、飞行安全和深度定制的核心模块,建议你重点审查 AI 生成的代码。

下一步

  • 按照快速开始,完成安装并创建你的第一个插件。
  • 查看使用,了解各类开发任务的对话方式、完整案例和常用命令。
最近修改: