mcpField
A
agent-deep-links

agent-deep-links

github.com/composio-community生产力17.1k467 次安装14 周前更新
代码仓库

关于 agent-deep-links

用于创建可点击链接、直接在应用中打开指定内容的技能,常用于 Slack。它会检查已知深链格式,并在支持情况未知或不支持时提供备用方式。

主要功能

  1. 01识别目标应用和内容
  2. 02查阅深链支持矩阵
  3. 03在本地验证未知协议
  4. 04生成 Slack 链接格式
  5. 05提供路径或 CLI 备用方式

适用场景

  1. 01链接到对话或线程
  2. 02在编辑器中打开文件
  3. 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 格式,以及在不支持深层链接时提供替代方案。

工作流

  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 打开命令
    • 声明目前没有已知的官方深层链接格式

输出规则

  • 文件/文件夹链接优先使用绝对路径。
  • 标签应简短且以操作为导向(在 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