clipboard-to-shortcut

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，否则链接会被浏览器拦截。