关于 agent-deep-links
用于创建可点击链接、直接在应用中打开指定内容的技能,常用于 Slack。它会检查已知深链格式,并在支持情况未知或不支持时提供备用方式。
主要功能
- 01识别目标应用和内容
- 02查阅深链支持矩阵
- 03在本地验证未知协议
- 04生成 Slack 链接格式
- 05提供路径或 CLI 备用方式
适用场景
- 01链接到对话或线程
- 02在编辑器中打开文件
- 03引导至应用设置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ composio-community/ awesome-codex-skills --skill agent-deep-links安装后在 Claude Code 中输入/agent-deep-links确认已加载。
附带文件agents/openai.yamlreferences/deep-link-matrix.md
详细介绍
Agent 深层链接
概述
当用户需要可点击的链接,以便直接在应用中打开时(通常来自 Slack),请使用此技能。这包括确认目标应用是否支持深层链接、选择合适的 URL 格式,以及在不支持深层链接时提供替代方案。
工作流
- 确认目标应用和目标对象:
- 线程/对话
- 文件/文件夹
- 设置/新窗口
- 阅读
references/deep-link-matrix.md,了解已验证的链接格式和支持级别。 - 如果支持情况未知,请在发送前在本地验证:
- 检查应用包中的 URL scheme:
/usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist - 简单测试启动行为:
open '<scheme>://...'
- 检查应用包中的 URL scheme:
- 构造 Slack 安全的链接语法:
<url|label>
- 如果不支持或不确定,请提供替代方案:
- 纯文本路径 + 命令
- 有文档说明的 CLI 打开命令
- 声明目前没有已知的官方深层链接格式
输出规则
- 文件/文件夹链接优先使用绝对路径。
- 标签应简短且以操作为导向(
在 Cursor 中打开、在 Codex 中打开)。 - 除非支持情况已在矩阵中列出或刚刚验证过,否则不要声称支持深层链接。
- 对不确定的应用路由,请明确标记为推测/实验性。
常用模板
- Codex 线程:
<codex://threads/<thread-uuid>|在 Codex 中打开>
- Cursor 文件:
<cursor://file/<absolute-path>:<line>:<column>|在 Cursor 中打开>
- VS Code 文件:
<vscode://file/<absolute-path>:<line>:<column>|在 VS Code 中打开>
- VS Code Insiders 文件:
<vscode-insiders://file/<absolute-path>:<line>:<column>|在 VS Code Insiders 中打开>
完整的跨应用矩阵和支持说明请参阅 references/deep-link-matrix.md。
评论
支持 Markdown