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|label>
5. 지원되지 않거나 불확실한 경우, 대체 안내 전송:
   • 일반 경로 + 명령어
   • 문서화된 CLI 열기 명령어
   • 알려진 공식 딥 링크 형식이 없다는 설명

출력 규칙

• 파일/폴더 링크에는 절대 경로를 선호합니다.
• 레이블을 짧고 행동 지향적으로 유지하세요 (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를 사용하세요.