Deep Links para Agentes
Visão Geral
Use esta habilidade quando um usuário solicitar links clicáveis que devem abrir diretamente em um aplicativo (geralmente a partir do Slack). Isso inclui verificar se o aplicativo de destino suporta deep links, selecionar o formato de URL correto e fornecer alternativas quando os deep links não forem suportados.
Fluxo de Trabalho
- Identifique o aplicativo de destino + o objeto alvo:
- Thread/conversa
- Arquivo/pasta
- Configurações/nova janela
- Leia
references/deep-link-matrix.mdpara obter formatos de link conhecidos e níveis de suporte. - Se o suporte for desconhecido, verifique localmente antes de enviar:
- Verifique os esquemas de URL no pacote do aplicativo:
/usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist - Faça um teste de inicialização:
open '<scheme>://...'
- Verifique os esquemas de URL no pacote do aplicativo:
- Construa a sintaxe de link segura para o Slack:
<url|label>
- Se não for suportado ou houver incerteza, envie uma alternativa:
- Caminho absoluto + comando
- Comando de abertura via CLI documentado
- Declaração de que nenhum formato oficial de deep link é conhecido
Regras de Saída
- Prefira caminhos absolutos para links de arquivos/pastas.
- Mantenha os rótulos curtos e orientados à ação (
Abrir no Cursor,Abrir no Codex). - Não afirme suporte a deep links a menos que esteja na matriz ou tenha sido verificado agora.
- Para rotas de aplicativos incertas, marque claramente como inferido/experimental.
Modelos Comuns
- Thread do Codex:
<codex://threads/<thread-uuid>|Abrir no Codex>
- Arquivo do Cursor:
<cursor://file/<caminho-absoluto>:<linha>:<coluna>|Abrir no Cursor>
- Arquivo do VS Code:
<vscode://file/<caminho-absoluto>:<linha>:<coluna>|Abrir no VS Code>
- Arquivo do VS Code Insiders:
<vscode-insiders://file/<caminho-absoluto>:<linha>:<coluna>|Abrir no VS Code Insiders>
Use references/deep-link-matrix.md para obter a matriz completa entre aplicativos e notas de suporte.