Back to Details

agent-deep-links

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Deep Links

Agent Deep Links

Overview

概述

Use this skill when a user asks for clickable links that should open directly in an app (usually from Slack). This includes verifying whether a target app supports deep links at all, selecting the right URL shape, and providing fallbacks when deep links are unsupported.
当用户需要可直接在应用中打开的可点击链接（通常来自Slack）时，使用此技能。这包括验证目标应用是否支持deep links、选择正确的URL格式，以及在不支持deep links时提供替代方案。

Workflow

工作流程

  1. Identify target app + target object:
    • Thread/conversation
    • File/folder
    • Settings/new window
  2. Read 
    references/deep-link-matrix.md
    for known-good link formats and support level.
  3. If support is unknown, verify locally before sending:
    • Check URL schemes in the app bundle:
      bash
      /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
    • Smoke test launch behavior:
      bash
      open '<scheme>://...'
  4. Construct Slack-safe link syntax: 
    • <url|label>
  5. If unsupported or uncertain, send a fallback:
    • Plain path + command
    • Documented CLI open command
    • Statement that no official deep-link format is known
  1. 确定目标应用 + 目标对象：
    • 线程/对话
    • 文件/文件夹
    • 设置/新窗口
  2. 查阅
    references/deep-link-matrix.md
    获取已知可用的链接格式及支持级别。
  3. 若支持情况未知，先在本地验证后再发送：
    • 检查应用包中的URL协议：
      bash
      /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
    • 启动行为冒烟测试：
      bash
      open '<scheme>://...'
  4. 构建Slack兼容的链接语法： 
    • <url|label>
  5. 若不支持或存在疑问，发送替代方案：
    • 纯路径 + 命令
    • 已文档化的CLI打开命令
    • 声明暂无官方deep-link格式

Output Rules

输出规则

  • Prefer absolute paths for file/folder links.
  • Keep labels short and action-oriented (
    Open in Cursor
    , 
    Open in Codex
    ).
  • Do not claim deep-link support unless it is in the matrix or just verified.
  • For uncertain app routes, clearly mark as inferred/experimental.
  • 文件/文件夹链接优先使用绝对路径。
  • 标签保持简短且面向操作（如
    Open in Cursor
    、
    Open in Codex
    ）。
  • 除非已在矩阵中记录或刚验证过，否则不要声称支持deep links。
  • 对于不确定的应用路由，明确标记为推断/实验性。

Common Templates

常用模板

  • Codex thread: 
    • <codex://threads/<thread-uuid>|Open in Codex>
  • Cursor file: 
    • <cursor://file/<absolute-path>:<line>:<column>|Open in Cursor>
  • VS Code file: 
    • <vscode://file/<absolute-path>:<line>:<column>|Open in VS Code>
  • VS Code Insiders file: 
    • <vscode-insiders://file/<absolute-path>:<line>:<column>|Open in VS Code Insiders>
Use 
references/deep-link-matrix.md
for the full cross-app matrix and support notes.
  • Codex线程： 
    • <codex://threads/<thread-uuid>|Open in Codex>
  • Cursor文件： 
    • <cursor://file/<absolute-path>:<line>:<column>|Open in Cursor>
  • VS Code文件： 
    • <vscode://file/<absolute-path>:<line>:<column>|Open in VS Code>
  • VS Code Insiders文件： 
    • <vscode-insiders://file/<absolute-path>:<line>:<column>|Open in VS Code Insiders>
查阅
references/deep-link-matrix.md
获取完整的跨应用矩阵及支持说明。