本文档介绍了Skill技能创建的完整流程,您可按照文档内容指引进行Skill技能创建与发布。
一、创建Skill技能
首次使用Skill技能,请您先签署相关协议

勾选“我已完成阅读并同意上述协议内容”,点击确认签署完成协议签署

1、操作步骤
创建 Skill前,您需要准备好Skill名称和Skill介绍,以下是具体步骤:
①登录并前往小米澎湃OS开发者平台-管理中心,点击“创建Skill”按钮,即可开始应用首次创建。

②点击创建Skill后,您需要填写Skill名称和Skill介绍。创建的Skill技能仅支持在Miclaw中分发

2、填写规范
| 字段名称 | 字段释义 | 填写规范 |
| Skill名称 | Skill技能名称 | 不可超过15个汉字或者30个字符,不能带有空格、标点符号,命中校验时信息提示。 |
| Skill介绍 | 简单介绍应用的功能和亮点 | 不超过100个汉字或者200个字符 |
二、生成Skill技能
点击“AI快速开发”,会自动跳转至Skill在线开发平台。您也可以稍后在Skill技能-应用列表中,找到对应Skill,点击进入应用概览页


在Skill详情页中点击"继续开发"按钮继续生成Skill技能流程

已生成但未发布前,可以在Skill应用概览详情页里点击“Skill修改&调试”继续生成&修改Skill文件

1、操作步骤
①输入并发送自然语言生成Skill。点击“+”支持上传附件

点击暂停,支持暂停Skill生成过程

②点击“workspace”下的目录中对应的Skill.md子菜单,允许查看/修改生成的Skill.md文件。编写过程中,草稿内容会自动保存

点击“workspace”右侧按钮,分别对应上传、新增文件分类、新增文件夹分类、删除Skill文件等四个功能

③点击“预览”,使用云真机查看Skill在小米手机端的使用效果,开发者进入云真机页面后需自行前往skill技能中心下载安装已下发的测试包,然后进行功能调试。若您对云真机的操作有任何疑问,可查看【开发者Q&A】,若仍不能解决您的问题,请联系客服。
.png)
预览页面点击“手机端调试”,使用Miclaw扫描二维码在手机端快速调试。支持开发者打开Miclaw,进入Miclaw设置->进入Miclaw实验室->长按实验室title 5s后展示开发者选项菜单->选择开发调试->进行扫码。如无法进入开发者模式进行调试,请联系客服。
.png)
2、修改Skill技能信息
点击修改icon,支持修改Skill名称、Skill介绍。修改后点击“确认”,无需审核直接生效

3、AI对话版本回退
点击“回到该版本”,支持回退到对应版本生成的Skill

4、接入MCP服务
点击“接入MCP服务”,支持添加个人上传和MCP广场上的 MCP,点击“添加”,大模型自动接入MCP

三、上传Skill技能
若您本地已有Skill.md无需使用AI生成,则可以在创建Skill入口处/应用概览页上传,或在生成Skilll页面上传文件/文件夹,上传后支持在线修改
①Skill编辑页面上传包含Skill.md的文件、文件夹

②创建入口上传Skill文件

四、发布Skill技能
1、操作步骤
①点击“提交”,进入发布阶段。您可以在Skill在线开发平台页面点击“提交”,提交Skill技能

②确认Skill当前提交版本。点击“确认”后返回应用概览页,进入待发布阶段

③您可以在提交Skill文件后通过应用详情页点击“发布Skill”,进入发布阶段

填写基础信息&场景说明。基本信息包括Skill名称、分类标题、Skill图标和Skill介绍;场景说明包括核心能力、使用场景和示例提示,具体可查看第2节填写规范

⑤若需下载Skill文件到本地,可通过Skill技能-技能列表,进入应用概览页,点击“Skill下载”,则可下载Skill zip包

2、填写规范
| 字段名称 | 字段释义 | 填写规范 |
| Skill名称 | Skill技能名称 | 不可超过15个汉字或者30个字符,不能带有空格、标点符号,命中校验时信息提示 |
| 分类标签 | 选择技能的分类 | 下拉单选,选项包括通用、信息、沟通、生活、创作、办公 |
| Skill图标 | Skill | 图片尺寸为144*144px,仅支持 jpeg/jpg/png格式 |
| Skill介绍 | 简单介绍技能的功能和亮点 | 不超过100个汉字或者200个字符 |
| 核心能力 | 描述此技能的的核心能力 | 不超过500个字符 |
| 使用场景 | 描述此技能的的使用场景 | 不超过500个字符 |
| 示例提示 | 提供一些示例提示 | 不超过500个字符 |
五、提交审核
当所有信息都填写完成后,您可点击“提交审核”按钮,此版本Skill技能即会进入审核流程


若审核未通过,可在Skill技能-应用列表中,选择Skill技能进入应用概览页

①点击“重新提交此版本”重新填写Skill基本信息和场景说明

②点击“提交审核”,此版本Skill技能即会进入审核流程


我们将会在1~3个工作日内完成审核,推荐您关注应用商店开发者服务公众号,如有兴趣可了解Skill技能,成为我们的合作伙伴。 以上为小米澎湃OS开发者平台Skill技能发布操作指南,如有任何问题,可联系客服,与我们取得联系。
开发者Q&A
报错提示&原因
| 报错环节 | 报错提示 | 原因 |
| 上传 | 未检测到.md文档,请重新上传 | 上传的Skill ZIP包中缺少.md文件 |
| 未检测到Skill.md文档,请重新上传 | 上传的Skill ZIP包中缺少Skill.md文件 | |
| 提交 | 请补充Skill.md文档中xxx等关键参数信息 | 提交Skill时,Skill.md文档中缺失必填参数 |
云真机预览答疑
- 进入云真机页面后该如何操作?
当进入云真机页面后,我们会自动帮您启用手机端的Miclaw应用,开发者需要自行前往技能中心页面获取当前测试包并进行安装部署。一般情况下,通用分类下第一个skill是当前的测试skill。
Tip:请提前检查当前云真机是否已连接网络,若网络断开请手动连接wifi【Phonetest-lab】。
- 修改skill文件后如何安装最新的skill技能?
当修改skill文件后或大模型重新生成了新的版本skill文件,重新切换到预览页面后会提示您:“测试包已重新下发,请前往技能中心列表手动再次添加”。您需要先手动删除已安装的测试技能后,重新进入技能中心列表安装最新下发的测试版本。
- 修改文件后重新切换页签没有收到测试包重新下发通知?
可能是因为网络问题导致数据下发缓慢,建议您通过ctrl + s触发手动保存后,再次切换页签。
- 云真机的使用限制?
为保障所有开发者的功能体验,我们限制了云真机的使用条件:
- 每位开发者每天最多连接20次云真机,每次30min。超过限制后,当天无法再次使用云真机能力。
- 若您超过5min没有操作云真机,我们将自动释放当前云真机。
- 关闭预览页签或退出当前页面,默认关闭并释放云真机。
- 云真机排不到怎么办?
云真机数量有限,若您碰到排队时间过久的情况,建议您点击右上角手机端调试按钮,通过Miclaw进行扫码调试。