mcpField
P
pubnub-presence

pubnub-presence

github.com/pubnub開発658 回インストール7 週間前に更新
リポジトリ

pubnub-presence について

pubnub-presenceは、PubNubのリアルタイムアプリ開発者向けのPresence専門スキルです。イベント処理、切断対応、複数デバイスの設計を扱い、APIの詳細はPubNub MCPまたは公式ドキュメントで確認します。

主な機能

  1. 01Presenceの有効化とチャンネルルールの設定
  2. 02初期の接続状況取得後にリアルタイムイベントを処理
  3. 03退出・タイムアウト・切断状態の区別
  4. 04ハートビート、タイムアウト、複数デバイスの設計資料
  5. 05大規模チャンネルでのイベント量管理

活用シーン

  1. 01チャンネル参加者のオンライン状態表示
  2. 02初期接続数と参加・退出イベントの統合
  3. 03切断と複数デバイスのPresence対応
  4. 04ステージング環境でのPresenceイベント検証

MCP 対応

SDKドキュメントの確認とステージングでのイベント検証にPubNub MCPツールを使用するよう案内します。API形式、制限、設定値、実運用操作の確認にはPubNub MCPが必要です。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pubnub/skills --skill pubnub-presence

インストール後、Claude Code で/pubnub-presenceを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

tile.json
evals/
instructions.json
summary_infeasible.json
summary.json
evals/scenario-0/
capability.txt
criteria.json
task.md
evals/scenario-1/
capability.txt
criteria.json
task.md
evals/scenario-2/
capability.txt
criteria.json
task.md
evals/scenario-3/
capability.txt
criteria.json
task.md
evals/scenario-4/
capability.txt
criteria.json
task.md
references/
dropped-connections.md
multi-device-sync.md
presence-patterns.md
presence-setup.md

詳細

PubNub Presence Specialist

優先順位： PubNub MCP ツールと pubnub.com/docs は、API の形式、制限、設定値に関する信頼できる情報源です。このスキルは、パターン、手順、設計上のトレードオフに関する信頼できる情報源です。

PubNub MCP ツールがない場合： このセッションに PubNub MCP ツール（通常は user-pubnub 名前空間）が存在しない場合に限り、PubNub MCP がないものとして扱ってください。ツールがすでに表示されている場合は、MCP を確認するようユーザーに尋ねないでください。ツールがなく、タスクで API の形式、制限、ツールスキーマ、設定値、またはライブのキューセット／ランタイム操作が必要な場合は、PubNub MCP を有効にする必要があることを一度だけユーザーに伝えてください（https://www.pubnub.com/docs/ai/pubnub-mcp-server）。このスキルでもパターン、手順、設計上のトレードオフについては引き続き案内できます。これらの事実について、学習データを信頼できる情報源として扱わないでください。SDK メソッドのシグネチャ、数値制限、MCP ツールの引数リストを記憶だけに頼って断定的に示さないでください。パターンレベルのガイダンスを続けるか、MCP が有効になるまで事実に依存する部分の回答を中断してください。チャットに関する質問は引き続き Chat SDK のドキュメント／MCP（get_chat_sdk_documentation）に誘導し、Core SDK には誘導しないでください。

コアワークフロー

  1. 有効化と範囲設定 — Presence アドオンと Presence Management のチャンネルルール（presence-setup.md）。
  2. presence を有効にしてサブスクライブ — get_sdk_documentation から API を取得します。
  3. 初期状態を取得してからストリーミング — 初期の接続数には hereNow を使用し、差分には join／leave／timeout イベントを使用します。
  4. heartbeat／timeout を調整 — レイテンシとイベント量のトレードオフを考慮します（presence-setup.md）。
  5. 切断に対処 — dropped-connections.md と backoff を参照してください。
  6. 複数デバイス — multi-device-sync.md を参照してください。

リファレンスガイド

リファレンス目的
presence-setup.mdポータルの前提条件、heartbeat の調整
presence-patterns.mdスケーラブルな presence パターン
dropped-connections.mdステータスカテゴリと presence leave の違い
multi-device-sync.md複数デバイス向けの userId 設計

イベントのオーケストレーション

フェーズアクション
初期接続後、空の UI を信用する前に接続数（hereNow）を取得します
ライブjoin／leave／timeout／state-change の差分を適用します — イベントの形式は SDK ドキュメントから取得してください
接続数が多い場合定期的なイベントを想定し、UI の更新をまとめます
leave の UX明示的な leave、timeout、disconnect を区別します（dropped-connections.md）

制約事項

  • チャンネルは Presence Management のルールで許可されている必要があります。
  • 永続的な userId が必要です。
  • Presence は接続ごとです — multi-device-sync.md を参照してください。
  • 大規模なチャンネルではイベント量に注意してください — コストとペイロードの適正化 を参照してください。

MCP ツール

  • get_sdk_documentation — presence API、hereNow、state
  • subscribe_and_receive_pubnub_messages — ステージングでイベントの流れを検証します

関連項目

コメント

Markdown 対応