clipboard-to-shortcut

name	clipboard-to-shortcut
description	将剪切板中的 App 跳转链接制作成一个可复用的快捷指令 Skill，下次用户说出 Skill 名称即可一键直达对应 App 页面。 当用户说"把剪切板的链接做成skill"、"帮我保存这个链接为快捷方式"、"用剪切板内容创建一个skill XX"、"把这个链接制作成skill"、"帮我把复制的链接做成一键跳转"等意图时激活。 支持淘宝、拼多多、抖音、快手、知乎、小红书、美团、哔哩哔哩、高德、QQ音乐、支付宝、百度等主流 App 的分享链接。
metadata	{"xomniclaw":{"always":false,"emoji":"🔖","version":"1.0.0","category":"navigation"}}

Clipboard to Shortcut Skill

从手机剪切板读取 App 跳转链接，自动生成一个独立的快捷指令 SKILL.md，用户以后只需说出该 Skill 名称即可一键直达对应 App 页面。

🚫 绝对禁止（违反必崩溃）

禁止使用 exec / shell 执行以下任何命令，100% 报 SecurityException 崩溃：

# ❌ 全部禁止 — 没有例外
am start -a android.intent.action.VIEW -d "https://..."    # ← 最常见错误！
am start -n com.taobao.taobao/...
content query --uri content://clipboard/clipboard
service call clipboard 2
adb shell ...
input tap / input swipe / input text

已知崩溃日志（如果你看到类似报错，说明你用错了工具）：

java.lang.SecurityException: Permission Denial: package=com.android.shell does not belong to uid=...

---

✅ 读取剪切板唯一正确方式：

device(action = "clipboard")

✅ 跳转 App 唯一正确方式（必须带 package_name 防止跳浏览器）：

device(action = "open", uri = "https://...", package_name = "com.taobao.taobao")

⛔ 绝对不能用 exec 调 am start 作为替代或回退方案。失败时应告知用户，而非换成 shell。

🎯 When to Use

✅ "把剪切板的链接做成 skill 淘宝好物" ✅ "帮我用剪切板内容创建一个skill叫抖音搞笑视频" ✅ "把复制的链接保存为快捷跳转 skill" ✅ "制作一个skill，下次可以一键打开这个页面" ✅ "帮我把这个链接做成一键直达的skill XX"

📋 Workflow

0) 前置检查

检查 Device status：

• Accessibility: ✅ connected → 继续。
• Accessibility: ❌ not connected → 停止，回复用户：

设备当前未连接无障碍服务（Accessibility 未连接），暂时无法读取剪切板。
请先在 X-OmniClaw 中重新连接设备无障碍服务后重试。

1) 获取 Skill 名称

从用户 query 中提取 Skill 名称。用户通常会说"做成 skill XX"或"创建 skill 叫 XX"。

• 若用户未提供名称，根据链接对应的 App 和内容自动生成一个简短中文名称，例如 淘宝板鞋、抖音搞笑视频。
• 名称规范：直接使用中文名称，不超过 20 个字。文件夹名与 name 保持一致（均为中文）。禁止转换为拼音或英文。

2) 读取剪切板并提取 URL

val clipboardText = device(action = "clipboard")

val urlRegex = Regex("""https?://[^\s\u4e00-\u9fff\u3000-\u303f\uff00-\uffef]+""")
var url = urlRegex.find(clipboardText)?.value
    ?.trimEnd('，', '。', '、', '"', '"', ')', '）', ']', '】', '>', '》', '￥', ' ')
    ?: throw Exception("剪切板中未找到有效链接")

3) 识别 App 类型并获取 package_name

根据 URL 特征识别 App，同时确定 package_name。跳转时必须传 package_name，否则链接会被浏览器拦截。

App	URL 特征	package_name
淘宝	e.tb.cn、tb.cn、taobao.com	com.taobao.taobao
拼多多	yangkeduo.com、pinduoduo.com、pddurl.cn	com.xunmeng.pinduoduo
抖音	v.douyin.com、douyin.com	com.ss.android.ugc.aweme
快手	v.kuaishou.com、kuaishou.com	com.smile.gifmaker
知乎	zhihu.com	com.zhihu.android
小红书	xhslink.com、xiaohongshu.com	com.xingin.xhs
美团	dpurl.cn、meituan.com、dianping.com	com.sankuai.meituan
哔哩哔哩	b23.tv、bilibili.com	tv.danmaku.bili
高德	surl.amap.com、amap.com	com.autonavi.minimap
QQ音乐	y.qq.com	com.tencent.qqmusic
支付宝	render.alipay.com（含 alipays://）	com.eg.android.AlipayGphone
百度	mbd.baidu.com	com.baidu.searchbox

4) 特殊链接处理（支付宝）

if (url.contains("render.alipay.com") && url.contains("scheme=")) {
    val schemeParam = Regex("""scheme=([^&]+)""").find(url)?.groupValues?.get(1)
    if (schemeParam != null) {
        url = java.net.URLDecoder.decode(schemeParam, "UTF-8")
    }
}

5) 验证链接可用性

先尝试跳转一次，确认链接有效。必须带 package_name 参数，强制在原生 App 中打开，避免跳浏览器：

device(action = "open", uri = url, package_name = "{对应App的package_name}")
device(action = "act", kind = "wait", timeMs = 1000)
device(action = "snapshot")

snapshot确认已成功打开目标 App 页面（而非浏览器）。若链接失效/App 未安装，告知用户无法创建 Skill 并说明原因。

6) 生成快捷指令 SKILL.md

确认链接有效后，在 /sdcard/.xomniclaw/workspace/skills/{skill-name}/ 目录下生成 SKILL.md。{skill-name} 直接使用中文名称（如 淘宝板鞋），文件夹名与 SKILL.md 中的 name 字段保持一致。

⚠️ YAML Frontmatter 格式强制约束（必须严格遵守）

生成的 SKILL.md 必须以 YAML frontmatter 开头，格式要求如下：

1. frontmatter 必须位于文件最顶部第一行，以 --- 开始，以 --- 结束
2. 禁止把 frontmatter 放在文件中间或底部（如"## 元数据"章节下），SkillParser 只解析文件顶部的 frontmatter
3. frontmatter 中只包含三个字段：name、description、metadata
4. name：使用中文名称（如 淘宝板鞋），禁止转为英文或拼音（如 cheap-braised-duck-chaoyang）
5. description：使用 YAML block scalar（|），包含功能描述和触发词
6. metadata：必须使用 JSON 格式（花括号包裹），禁止使用 YAML 嵌套格式

✅ 正确的 metadata 格式（JSON）：

metadata:
  {
    "xomniclaw": {
      "always": false,
      "emoji": "🛒",
      "version": "1.0.0",
      "category": "navigation"
    }
  }

❌ 错误的 metadata 格式（YAML 嵌套，SkillParser 无法解析）：

metadata:
  xomniclaw:
    always: false
    emoji: 🛒
    version: 1.0.0
    category: navigation

生成的 SKILL.md 完整模板

严格按照以下模板生成，不得调整 frontmatter 位置或格式：

---
name: {skill-name（中文名称）}
description: |
  一键直达{App名称}指定页面的快捷指令。从剪切板链接自动创建。
  当用户说"打开{skill-name}"、"使用{skill-name}"、"用{skill-name}"时激活。
metadata:
  {
    "xomniclaw": {
      "always": false,
      "emoji": "{对应App的emoji}",
      "version": "1.0.0",
      "category": "navigation"
    }
  }
---

# {skill-name（中文名称）}

一键直达{App名称}指定页面。

## 🚫 绝对禁止（违反必崩溃）

> **禁止使用 exec / shell（包括 `am start`），100% 报 SecurityException。**
>
> **✅ 跳转 App 唯一正确方式（必须带 package_name）：**
> ```kotlin
> device(action = "open", uri = "...", package_name = "{package_name}")
> ```

## 📋 执行步骤

### Step 1: 跳转目标页面

```kotlin
device(action = "open", uri = "{url}", package_name = "{package_name}")

Step 2: 等待并确认

device(action = "act", kind = "wait", timeMs = 1000)
device(action = "snapshot")

snapshot后根据页面内容向用户简洁汇报：

已跳转到{App名称}，当前显示{页面内容描述}。

⚠️ 注意事项

• 必须使用 device(action="open", uri="...", package_name="...") 跳转，禁止用 shell am start
• 必须带 package_name 参数，不带会跳浏览器而非原生 App。参见步骤 3 的包名表
• 若 App 未安装，snapshot并告知用户
• 若链接过期，告知用户链接已失效
• 原始链接来源：{clipboardText 的摘要信息}
• 创建时间：{当前日期}

#### 生成前自检清单

生成 SKILL.md 前，逐项检查：

- [ ] 文件第一行是 `---`（frontmatter 起始标记）
- [ ] `name` 字段使用中文名称
- [ ] `description` 使用 `|` block scalar 格式
- [ ] `metadata` 使用 JSON 格式（花括号），不是 YAML 嵌套格式
- [ ] frontmatter 以 `---` 结束后，紧接 Markdown 正文（`# 标题`）
- [ ] 文件中没有第二处 `---` 包裹的 frontmatter 块

### 7) App Emoji 映射

生成 SKILL.md 时，根据识别到的 App 类型选择 emoji。生成的 SKILL.md 中的 `device(action="open")` 也必须带上 `package_name`：

| App | Emoji | package_name |
|-----|-------|-------------|
| 淘宝 | 🛒 | `com.taobao.taobao` |
| 拼多多 | 🍊 | `com.xunmeng.pinduoduo` |
| 抖音 | 🎵 | `com.ss.android.ugc.aweme` |
| 快手 | 🎬 | `com.smile.gifmaker` |
| 知乎 | 💡 | `com.zhihu.android` |
| 小红书 | 📕 | `com.xingin.xhs` |
| 美团 | 🍜 | `com.sankuai.meituan` |
| 哔哩哔哩 | 📺 | `tv.danmaku.bili` |
| 高德 | 🗺️ | `com.autonavi.minimap` |
| QQ音乐 | 🎶 | `com.tencent.qqmusic` |
| 支付宝 | 💰 | `com.eg.android.AlipayGphone` |
| 百度 | 🔍 | `com.baidu.searchbox` |
| 未知 | 🔗 | （不传 package_name） |

### 8) 回复用户

创建完成后，向用户确认：

✅ 已成功创建快捷指令 Skill「{skill-name}」！

📋 链接来源：{App名称} - {内容摘要} 🔗 目标地址：{url}

下次您只需说「打开{skill-name}」或「使用{skill-name}」，即可一键直达该页面。

## 💡 Complete Examples

### 示例 1：将淘宝商品链接制作为 Skill

**用户 query**: "把剪切板的链接做成 skill 淘宝板鞋"

**剪切板内容**:

【淘宝】https://e.tb.cn/h.io9Fd5S?tk=fNSL55NU59K CZ009 适配Nike SB Dunk Low低帮板鞋

**执行流程**:
```kotlin
// 1. 读取剪切板
val clip = device(action = "clipboard")
// → "【淘宝】https://e.tb.cn/h.io9Fd5S?tk=fNSL55NU59K CZ009 ..."

// 2. 提取 URL
val url = "https://e.tb.cn/h.io9Fd5S?tk=fNSL55NU59K"

// 3. 识别为淘宝链接

// 4. 验证链接 - 带 package_name 强制在淘宝 App 打开
device(action = "open", uri = url, package_name = "com.taobao.taobao")
device(action = "act", kind = "wait", timeMs = 1000)
device(action = "snapshot")
// → snapshot确认：淘宝商品页 Nike SB Dunk Low（在淘宝 App 中打开，非浏览器）

// 5. 生成 SKILL.md → /sdcard/.xomniclaw/workspace/skills/淘宝板鞋/SKILL.md

生成的 SKILL.md（注意：frontmatter 在文件最顶部，metadata 用 JSON 格式，name 用中文）:

---
name: 淘宝板鞋
description: |
  一键直达淘宝商品页面（Nike SB Dunk Low板鞋）的快捷指令。
  当用户说"打开淘宝板鞋"、"使用淘宝板鞋"时激活。
metadata:
  {
    "xomniclaw": {
      "always": false,
      "emoji": "🛒",
      "version": "1.0.0",
      "category": "navigation"
    }
  }
---

# 淘宝板鞋

一键直达淘宝 Nike SB Dunk Low 板鞋商品页面。

## 🚫 绝对禁止（违反必崩溃）

> **禁止使用 exec / shell（包括 `am start`），100% 报 SecurityException。**
>
> **✅ 跳转 App 唯一正确方式（必须带 package_name）：**
> ```kotlin
> device(action = "open", uri = "...", package_name = "com.taobao.taobao")
> ```

## 📋 执行步骤

### Step 1: 跳转目标页面

```kotlin
device(action = "open", uri = "https://e.tb.cn/h.io9Fd5S?tk=fNSL55NU59K", package_name = "com.taobao.taobao")

Step 2: 等待并确认

device(action = "act", kind = "wait", timeMs = 1000)
device(action = "snapshot")

snapshot后回复：已跳转到淘宝，当前显示 Nike SB Dunk Low 板鞋商品详情页。

⚠️ 注意事项

• 必须使用 device(action="open", uri="...", package_name="com.taobao.taobao") 跳转，不带 package_name 会跳浏览器
• 原始链接来源：淘宝分享 - Nike SB Dunk Low低帮板鞋
• 创建时间：2026-04-13

**回复**:

✅ 已成功创建快捷指令 Skill「淘宝板鞋」！

📋 链接来源：淘宝 - Nike SB Dunk Low低帮板鞋 🔗 目标地址：https://e.tb.cn/h.io9Fd5S?tk=fNSL55NU59K

下次您只需说「打开淘宝板鞋」或「使用淘宝板鞋」，即可一键直达该商品页面。

---

### 示例 2：将抖音视频链接制作为 Skill

**用户 query**: "帮我把剪切板里的链接创建成skill 搞笑相声"

**剪切板内容**:

3.33 复制打开抖音，看看【西溪历史的作品】1993年录像... https://v.douyin.com/Sw2BOwYSsp4/ [e-mail]

**执行流程**:
```kotlin
// 1. 读取剪切板
val clip = device(action = "clipboard")

// 2. 提取 URL
val url = "https://v.douyin.com/Sw2BOwYSsp4/"

// 3. 识别为抖音链接

// 4. 验证链接 - 带 package_name 强制在抖音 App 打开
device(action = "open", uri = url, package_name = "com.ss.android.ugc.aweme")
device(action = "act", kind = "wait", timeMs = 1000)
device(action = "snapshot")

// 5. 生成 SKILL.md → /sdcard/.xomniclaw/workspace/skills/搞笑相声/SKILL.md

生成的 SKILL.md 中的核心跳转指令:

device(action = "open", uri = "https://v.douyin.com/Sw2BOwYSsp4/", package_name = "com.ss.android.ugc.aweme")

回复:

✅ 已成功创建快捷指令 Skill「搞笑相声」！

📋 链接来源：抖音 - 西溪历史 1993年历史录像
🔗 目标地址：https://v.douyin.com/Sw2BOwYSsp4/

下次您只需说「打开搞笑相声」或「使用搞笑相声」，即可一键直达该视频。

---

示例 3：将支付宝链接制作为 Skill（含特殊解码）

用户 query: "把剪切板链接做成skill 支付宝活动"

剪切板内容:

https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2Fstartapp%3FappId%3D20000793%26url%3D...

执行流程:

// 1. 读取剪切板
val clip = device(action = "clipboard")

// 2. 提取 URL
var url = "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2F..."

// 3. 支付宝特殊处理：解码 scheme 参数
url = "alipays://platformapi/startapp?appId=20000793&url=..."

// 4. 验证链接 - 支付宝用 alipays:// scheme 直接跳转，自动匹配支付宝 App
device(action = "open", uri = url, package_name = "com.eg.android.AlipayGphone")
device(action = "act", kind = "wait", timeMs = 1000)
device(action = "snapshot")

// 5. 生成 SKILL.md，跳转 uri 使用解码后的 alipays:// 深链接

生成的 SKILL.md 中的核心跳转指令:

device(action = "open", uri = "alipays://platformapi/startapp?appId=20000793&url=...", package_name = "com.eg.android.AlipayGphone")

🔄 Error Handling

剪切板为空或无 URL

剪切板内容为空，或未找到有效链接。请先复制 App 分享的链接再试。

目标 App 未安装

已尝试验证链接，但手机未安装{App名称}。请先安装该 App 后再创建快捷指令。

链接已过期

该链接已过期或已失效，无法创建快捷指令。请复制一个有效的链接后重试。

Skill 名称冲突

若目标目录已存在同名 Skill，提示用户：

已存在名为「{skill-name}」的 Skill。是否要覆盖？或请提供一个新名称。

用户未提供 Skill 名称

根据 App 类型和剪切板内容摘要自动生成名称，并告知用户：

未指定 Skill 名称，已自动命名为「{auto-name}」。您可以随时要求重命名。