agent-deep-links

用途

agent-deep-links 用于在用户（通常来自 Slack）请求可点击链接、且希望链接能直接在某个应用中打开时提供帮助。它覆盖三类任务：验证目标应用是否支持深度链接、选择合适的 URL 形式、以及在深度链接不受支持时给出回退方案。

主要能力

• 识别目标应用与目标对象，对象类型包括：线程/会话、文件/文件夹、设置/新窗口。
• 通过 references/deep-link-matrix.md 查询已知可用的链接格式与支持级别。
• 在支持情况未知时，先在本地验证再发送链接。
• 构造 Slack 安全的链接语法：<url|label>。
• 在不受支持或不确定时提供回退内容。

使用方式

工作流程如下：

1. 识别目标应用与目标对象（线程/会话、文件/文件夹、设置/新窗口）。
2. 阅读 references/deep-link-matrix.md，获取已知可用的链接格式与支持级别。
3. 若支持情况未知，在发送前本地验证：
   • 检查应用包中的 URL scheme： /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
   • 冒烟测试启动行为： open '<scheme>://...'
4. 构造 Slack 安全的链接语法：<url|label>。
5. 若不受支持或不确定，发送回退方案：
   • 纯路径 + 命令
   • 有文档记录的 CLI 打开命令
   • 声明没有已知的官方深度链接格式

输出规则：

• 文件/文件夹链接优先使用绝对路径。
• 标签保持简短且面向动作（如 Open in Cursor、Open in Codex）。
• 除非在矩阵中或刚刚验证过，否则不要声称支持深度链接。
• 对于不确定的应用路由，明确标注为推断/实验性。

常见模板：

• 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。

适用场景

适用于需要在 Slack 等环境中分享可直接在 Codex、Cursor、VS Code、Visual Studio 等工具中打开的链接的场景，尤其是涉及线程、文件、文件夹或特定窗口的跳转。

限制

• 不得声称支持深度链接，除非该支持已记录在矩阵中或刚刚经过验证。
• 对于不确定的应用路由，必须明确标注为推断/实验性。
• 关于具体收费、价格、平台支持范围等信息，资料暂未提供。