mcpField
H
hwc-realtime-streaming

hwc-realtime-streaming

github.com/lucianghinda開発43039 回インストール今日更新
リポジトリ

hwc-realtime-streaming について

Turbo Streams と Stimulus によるプッシュ型 Hotwire インターフェース実装を支援するスキルです。転送方式やストリーム操作の選択に加え、順序や複数タブでの動作確認を扱います。

主な機能

  1. 01WebSocket、SSE、ストリームタグの選択
  2. 02標準 Turbo Stream 操作の選択
  3. 03順序と冪等性の管理
  4. 04遅延・順不同メッセージの確認

活用シーン

  1. 01Hotwire のリアルタイム更新経路の設計
  2. 02Turbo Stream 操作の実装
  3. 03複数タブでの更新動作の確認

インストール

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

$npx skills add https://github.com/lucianghinda/superpowers-ruby --skill hwc-realtime-streaming

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

同梱ファイル

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

references/
2023-08-01-turbo-streams-inline-stream-tags.md
2023-08-15-turbo-streams-custom-stream-actions.md
2023-10-10-turbo-streams-custom-stream-actions-video-playlist-management.md
2023-11-21-stimulus-inter-tab-communication.md
2024-01-30-turbo-streams-custom-stream-actions-localstorage.md
2024-03-12-hotwire-combobox-with-real-time-data.md
2025-06-10-turbo-streams-list-animation-view-transitions.md
INDEX.md

詳細

リアルタイムとストリーミング

Turbo Streams と Stimulus を使って、プッシュ駆動型の Hotwire の動作を実装します。

コアワークフロー

  1. トランスポートと配信形式を特定します。WebSocket、SSE、インラインのストリームタグ、またはサーバーのレスポンスストリームから選びます。
  2. まずデフォルトの Turbo Stream アクションを選びます。デフォルトでは不十分な場合に限り、カスタムアクションを追加します。
  3. ストリームアクションは小さく決定的なものにします。ストリームのペイロードに任意のスクリプトを埋め込まないでください。
  4. ストリームのオーケストレーションを、フォーム、メディア、ナビゲーションといったドメイン固有の UI 懸念事項から分離します。
  5. すべてのリアルタイム更新について、順序、冪等性、複数タブでの動作を検証します。

ガードレール

  • カスタムアクションを使う前に、append/prepend/replace/update/remove/before/after/refresh を優先してください。
  • タブ間の同期は明示的に(BroadcastChannel/localStorage)行い、同じデバイス内のセマンティクスに限定してください。
  • 状態変化を明確に伝えるうえでアニメーションが有意義な場合に限り、ビュー遷移を使用してください。
  • メッセージが遅延した場合や順序どおりに届かない場合の動作を検証してください。

必要なリファレンスのみを読み込む

現在のリクエストに必要なファイルだけを開いてください。

  • クライアント側のインラインストリームタグ:references/2023-08-01-turbo-streams-inline-stream-tags.md
  • カスタム Turbo Stream アクション:references/2023-08-15-turbo-streams-custom-stream-actions.md
  • カスタムアクションによる高度なプレイリストのオーケストレーション:references/2023-10-10-turbo-streams-custom-stream-actions-video-playlist-management.md
  • LocalStorage によるストリーム状態の管理:references/2024-01-30-turbo-streams-custom-stream-actions-localstorage.md
  • View Transitions によるリストのアニメーション:references/2025-06-10-turbo-streams-list-animation-view-transitions.md
  • リアルタイムのコンボボックス更新:references/2024-03-12-hotwire-combobox-with-real-time-data.md
  • タブ間通信のパターン:references/2023-11-21-stimulus-inter-tab-communication.md

カタログ全体は references/INDEX.md を参照してください。

関連スキルに切り替える

  • プル型のナビゲーションや履歴に関する懸念事項:hwc-navigation-content を使用してください
  • フォーム検証や送信ライフサイクルに関する懸念事項:hwc-forms-validation を使用してください
  • メディアの再生やアップロードに関する操作:hwc-media-content を使用してください
  • 汎用的な読み込み、進行状況、トランジションの UX:hwc-ux-feedback を使用してください
  • ストリーミング以外の Stimulus 基本 API に関する質問:hwc-stimulus-fundamentals を使用してください

コメント