resilient-ws-ui
バックエンドとの信頼性の高いWebSocket接続を維持し、接続状態をユーザーに明確に表示するアプリケーション構築のためのガイドラインです。このスキルは、ユーザーが明示的に名前で参照した場合(例:"/resilient-ws-ui"、「resilient-ws-ui スキルを使う」)にのみ実行します。トピックマッチに基づいて自動的に呼び出さないでください。
description の原文を見る
Guidelines for building applications that maintain reliable WebSocket connections to a backend and surface connection health clearly to the user. Invoke ONLY when the user explicitly references this skill by name (e.g. "/resilient-ws-ui", "use the resilient-ws-ui skill"). Do NOT auto-invoke based on topic match.
SKILL.md 本文
信頼できるWebSocket接続 + 可視的な接続状態
2つの関連する問題に対するエージェントガイドライン:
- 信頼性 — ページフリーズ、IP変更、NAT/プロキシタイムアウト、ブラウザバグ、不安定なネットワークを通じて、トランスポート層の
closeイベントに依存することなく、バックエンドへの論理チャネルを開いた状態に保つ - 可視性 — ユーザーに接続状態の簡潔で常時利用可能で正確な表示を提供し、詳細を確認したい場合はドリルダウン機能を提供する
このガイダンスはスタックに依存しません。具体例は本リポジトリの参照実装(src/client/、src/server.ts)から引用しています — TypeScript + ブラウザWebSocket + Node wsですが、パターンは他のランタイム(ネイティブアプリ、モバイル、SSE、ロングポーリング、gRPCストリーミング)にも適用できます。
パート1 — 信頼性
R1. トランスポート層の生存確認を信頼しない
WebSocket.readyState === OPENは、ピアが到達可能であることを意味しません。ブラウザがcloseを発火しない一般的な障害モード:
- Firefoxの古いWebSocketバグ([bugzilla 9200
...
詳細情報
- 作者
- pshirshov
- ライセンス
- unknown
- 最終更新
- 2026/4/22
Source: https://github.com/pshirshov/ws-reconnect-demo / ライセンス: unknown
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理(非同期ジェネレータを含む)、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。