ComposioHQ/agent-deep-links

Agent Deep Links

Übersicht

Verwende diese Fähigkeit, wenn ein Nutzer nach klickbaren Links fragt, die direkt in einer App geöffnet werden sollen (normalerweise von Slack aus). Dies umfasst die Überprüfung, ob eine Ziel-App überhaupt Deep Links unterstützt, die Auswahl der richtigen URL-Form und die Bereitstellung von Fallbacks, wenn Deep Links nicht unterstützt werden.

Arbeitsablauf

1. Identifiziere Ziel-App + Zielobjekt:
   • Thread/Unterhaltung
   • Datei/Ordner
   • Einstellungen/neues Fenster
2. Lies references/deep-link-matrix.md für bekannte, funktionierende Link-Formate und den Unterstützungsgrad.
3. Wenn der Support unbekannt ist, überprüfe lokal vor dem Senden:
   • Überprüfe URL-Schemata im App-Bundle:

     /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
     

   • Teste das Startverhalten mit einem Smoke-Test:

     open '<scheme>://...'
     

4. Erstelle Slack-sichere Link-Syntax:
   • <url|label>
5. Wenn nicht unterstützt oder unsicher, sende einen Fallback:
   • Klaren Pfad + Befehl
   • Dokumentierten CLI-Öffnungsbefehl
   • Aussage, dass kein offizielles Deep-Link-Format bekannt ist

Ausgaberegeln

• Bevorzuge absolute Pfade für Datei-/Ordner-Links.
• Halte Beschriftungen kurz und handlungsorientiert (In Cursor öffnen, In Codex öffnen).
• Behauptere keine Deep-Link-Unterstützung, es sei denn, sie ist in der Matrix enthalten oder gerade verifiziert.
• Markiere unsichere App-Routen klar als abgeleitet/experimentell.

Häufige Vorlagen

• Codex-Thread:
  • <codex://threads/<thread-uuid>|In Codex öffnen>
• Cursor-Datei:
  • <cursor://file/<absoluter-pfad>:<zeile>:<spalte>|In Cursor öffnen>
• VS-Code-Datei:
  • <vscode://file/<absoluter-pfad>:<zeile>:<spalte>|In VS Code öffnen>
• VS-Code-Insiders-Datei:
  • <vscode-insiders://file/<absoluter-pfad>:<zeile>:<spalte>|In VS Code Insiders öffnen>

Verwende references/deep-link-matrix.md für die vollständige app-übergreifende Matrix und Support-Notizen.