Compétences debug-connection
🔌
CLIとFigJamプラグイン間のWebSocket接続はしばしばエラーなく失敗します。このスキルは、接続問題を迅速に特定して解決するための段階的な診断手順を提供します。
Prend en charge: Claude Codex Code(CC)
1
Télécharger le ZIP du skill
2
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
3
Activez et commencez à utiliser
Tester
Utilisation de "debug-connection". Debug why my FigJam plugin shows 'Connecting...' indefinitely
Résultat attendu:
- 接続拒否は通常、CLI serveが実行されていないことを意味します。次の手順に従ってください：
- 1. figram serveが実行されているかどうか確認する：ps aux | grep 'figram serve'
- 2. ポート3456の可用性を確認する：lsof -i :3456
- 3. でCLIを開始する：bun run packages/cli/src/index.ts serve diagram.yaml
- 4. WebSocketを手動でテストする：wscat -c ws://localhost:3456
- 5. WebSocketクローズイベントのためにプラグインUIコンソールを確認する
Audit de sécurité
Sûrv3 • 1/10/2026
This skill contains only documentation - a markdown file providing debugging guidance for WebSocket connection issues. No executable code, no file system access, no network operations, and no code execution capabilities. Pure informational content.
1
Fichiers analysés
193
Lignes analysées
0
résultats
3
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude Voir l’historique des audits →
Score de qualité
38
Architecture
100
Maintenabilité
83
Contenu
21
Communauté
100
Sécurité
78
Conformité aux spécifications
Ce que vous pouvez construire
ライブ同期の問題をデバッグする
YAMLの変更がFigJamキャンバスに表示されない場合、WebSocket通信の崩壊を診断します
接続の切断を調査する
WebSocket接続が開発セッション中に予期せず閉じる理由をトレースします
構成の問題を確認する
展開されたセットアップでポートの可用性、シークレットの不一致、認証問題を確認します
Essayez ces prompts
接続状態を確認する
私のFigJamプラグインが無限に「接続中...」と表示される理由をデバッグします。CLI serveが実行されていることを確認し、ポート3456が利用可能かどうかを確認するにはどうすればよいですか？
同期失敗を診断する
WebSocketは接続していますが、私のダイアグラムが同期されていません。パッチが適用されない理由を特定するために、どのような診断手順に従うべきですか？
認証を確認する
私の接続は確立されますが、すぐに閉じます。CLIとプラグイン間でシークレットの不一致があるかどうかを確認するにはどうすればよいですか？
プロトコルフレームを調査する
WebSocketプロトコルのメッセージ形式、HelloMessage、FullMessage、PatchMessage、およびパッチ操作がどのように構造化されているかを示してください。
Bonnes pratiques
- CLI serveをDEBUG=*で開始して、詳細なWebSocketフレーム出力を得る
- ブラウザの開発者ツールを使用して、WSフレームのネットワークタブを検査する
- 認証を使用する場合、CLIとプラグインのシークレット値を同期に保つ
Éviter
- 増分更新をブロックするYAML検証エラーを無視する
- 接続が切断されたときにコンソールログの検査をスキップする
- 接続失敗が常にネットワークレベルの問題であると想定する
Foire aux questions
このスキルはすべてのオペレーティングシステムでClaude Codeで動作しますか？
はい、デバッグ手順ではmacOSとLinuxで利用可能なps、lsof、bunなどの標準コマンドを使用します。WindowsユーザーはWSLが必要になる場合があります。
接続のタイムアウト制限は何ですか？
定義されたハードなタイムアウト制限はありません。WebSocket接続は、CLIプロセスが終了するか、ネットワークの割り込みが発生するまで存続します。
これを自動化されたテストパイプラインに統合できますか？
このスキルは診断ガイダンスのみを提供します。自動化されたテストについては、CIパイプラインにWebSocket健全性チェックを実装する必要があります。
デバッグ中にYAMLコンテンツは外部サーバーに送信されますか？
いいえ。すべてのデバッグはローカルです。WebSocket接続はlocalhostのみです（ws://localhost:3456）。データを外部に送信しません。
手動テストのためにwscatがインストールされていない場合はどうすればよいですか？
任意のWebSocketクライアントツールを使用できます。代替オプションには、websocat、ブラウザDevTools、またはシンプルなNode.js WebSocketテストスクリプトが含まれます。
汎用ネットワークデバッグツールと比較した場合、どのように異なりますか？
このスキルはFigramのWebSocketプロトコルに特化しており、メッセージタイプ、リビジョントラッキング、および汎用ツールが解釈できないパッチ操作が含まれます。