ディープリンク構築・検証スキル（ComposioHQ/agent-deep-links）

エージェントディープリンク

概要

このスキルは、ユーザーがアプリで直接開くべきクリック可能なリンク（通常はSlackから）を求めた場合に使用します。これには、対象アプリがディープリンクをサポートしているかどうかの確認、適切なURL形式の選択、およびディープリンクがサポートされていない場合の代替手段の提供が含まれます。

ワークフロー

1. 対象アプリと対象オブジェクトを特定する：
   • スレッド/会話
   • ファイル/フォルダ
   • 設定/新しいウィンドウ
2. references/deep-link-matrix.mdを参照して、既知の適切なリンク形式とサポートレベルを確認する。
3. サポートが不明な場合は、送信前にローカルで確認する：
   • アプリバンドル内のURLスキームを確認する：

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

   • 起動動作を簡易テストする：

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

4. Slackで安全なリンク構文を作成する：
   • <url|ラベル>
5. サポートされていないか不明な場合は、代替手段を送信する：
   • プレーンなパスとコマンド
   • 文書化されたCLIのopenコマンド
   • 公式のディープリンク形式が不明であるという記述

出力ルール

• ファイル/フォルダリンクには絶対パスを優先する。
• ラベルは短くアクション指向にする（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を参照してください。