Skill
最近更新:2026/11/15
Skill 是写给 AI 助手看的一组说明:一份 SKILL.md 加上几份参考资料,告诉助手怎样用 yunyoo 的工具把一类事情做对,比如先看屏幕再点、哪些操作要先问你、出了错怎么处理。Skill 自己不运行任何程序,真正动手的仍是助手调用的 yunyoo 工具,能做什么由你的账户权限和 token 的作用域决定。
目前有两个官方 Skill:
| 名称 | 用途 |
|---|---|
yunyoo-automation | 用 MCP 工具或命令行操作云手机的通用做法 |
yunyoo-app-smoke | 在云手机上安装并打开一个应用,走一遍你给的路径,逐步附截图出报告 |
Skill 只负责教助手怎么做。助手要真的操作云手机,还需要接上 yunyoo 的 MCP 服务或装好命令行,见本文「连接 MCP」一节。
三种获取方式
从桌面端的 Skill 市场安装(推荐)
- 打开桌面端(1.1.0 起),在侧栏进入「Skill 市场」。
- 在「浏览」里点开一个 Skill,先看它的说明、「权限」里会用到的权限与工具、「文件」里包含的文件,以及「审核与签名」。
- 点「安装」,选安装目标,确认后完成。
桌面端在写入之前会核对包的签名和摘要,核对不过不会安装。装好的 Skill 在「已安装」里能看到位置、版本和是否有更新。
用 npx skills 安装
如果你不用桌面端,可以用开源的 skills 命令行从官网的公开索引安装(需要 Node.js 22.20 或更高版本):
npx skills add https://www.yunyoo.ai
按提示选好要装的 Skill 和 AI 助手后,它把 Skill 装到当前项目目录下的 .agents/skills/(选了 Claude Code 时另复制一份到 .claude/skills/)。
skills是第三方工具,不由 yunyoo 提供。它的使用统计由该工具的提供方处理;不想上报时,先设置环境变量DISABLE_TELEMETRY=1或DO_NOT_TRACK=1。- 这种方式按索引里的摘要核对下载内容,不核对 yunyoo 的签名。
- 桌面端只管理它自己安装的目录:这样装的 Skill 不会出现在「已安装」里,也不会被桌面端更新或卸载。
导出 ZIP,上传到 claude.ai
在 Skill 的详情里点「导出 ZIP」,把得到的文件在 claude.ai 的设置里作为自定义 Skill 上传(是否可用取决于你的 claude.ai 套餐)。claude.ai 在云端运行,只能通过远程 MCP 地址使用 yunyoo,用不了你电脑上的命令行。
两个安装目标
| 安装目标 | 位置 | 谁会读 |
|---|---|---|
| 通用 Skill 目录 | ~/.agents/skills/ | Codex、Cursor、Gemini CLI 等多数支持 Skill 的 AI 助手 |
| Claude Code 的 Skill 目录 | ~/.claude/skills/ | Claude Code |
有些 AI 助手两个目录都读,两处都装会把同一个 Skill 列出两次。不确定时只装一处:主要用 Claude Code 就选它的目录,其它情况选通用目录。
同名目录已经存在而不是桌面端装的(比如你手动放的,或用 npx skills 装在主目录里的),桌面端不会覆盖它。请先自行移走,或改装另一个目标。
更新、卸载与撤回
- 更新:「已安装」里有新版本时会标出来。更新前会列出变化的文件;新版本要用到更多权限或工具时,需要你逐项确认。
- 本地改动:你改过已安装的文件时,更新和卸载都会先列出这些改动,要你确认后才覆盖或删除。
- 卸载:只删除桌面端自己安装的目录。
- 撤回:某个版本被发现有问题时,我们会撤回它。桌面端收到后会提示你更新或卸载;问题严重时会把这个版本停用,把它的目录移到旁边的
.yunyoo-quarantine/里,助手不再读到它(你改过的目录不会被移动,只提示)。已撤回的版本不能再安装。
连接 MCP
Skill 里写的工具来自 yunyoo 的 MCP 服务,接入有三种方式,用的是同一套工具,只有少数工具和参数因方式不同而有差别(工具参考里逐个标明),详见 MCP:
| 方式 | 适合 | 凭据 |
|---|---|---|
本机(yunyoo --local mcp) | 只操作这台电脑上桌面端能管理的环境 | 桌面端的登录,不需要 token |
命令行(yunyoo mcp) | 助手和命令行在同一台电脑上 | 命令行登录时用的 token |
| 远程 MCP 地址 | 助手在别处运行,例如 claude.ai | 机器 token |
桌面端 Skill 市场的「AI 助手与 MCP」页签会找出这台电脑上装了哪些 AI 助手,可以把连接配置一键写好,也可以只看要写入的内容自己动手。写入前会给你看改动,写入后可以点「测试连接」。
关于 token:
- 配置文件里不写 token 本身,只引用环境变量;本机方式根本不需要 token。
- 签发 token 时只勾选用得到的作用域和云手机。Skill 的详情里列出了它需要哪些作用域,照着勾选即可,见自动化概览。
- 不要把 token 贴进对话,也不要让助手替你保管。
常见问题
侧栏里没有「Skill 市场」。 这个功能在桌面端 1.1.0 起提供,并在逐步开放;你的账户还没有开放、或团队角色没有查看 Skill 的权限时不会显示。先确认桌面端的版本。
装好了,助手却没有用它。 多数助手只在启动时读取 Skill 目录,装完后重新打开助手。再确认装到了助手会读的那个目录,并且已经连上 MCP 或装好命令行。
安装时提示签名或摘要不对。 桌面端不会安装核对不过的包。稍后重试;仍然不行请联系我们,不要改用别的来源下载同名文件。
Skill 会不会背着我操作? Skill 只是说明文字,不会自己运行。助手每次操作都经过 yunyoo 的工具,受你的账户权限和 token 作用域限制;会改动数据或花钱的操作,官方 Skill 要求助手先向你确认。Skill 通过了扫描和复核,也不等于它在任何情况下都安全,安装前请看清它会用到什么。
怎么知道装的是官方发布的版本? 在 Skill 的详情里看「审核与签名」:签名的密钥、包的摘要、扫描与评测的结论都列在那里。
