blake-john/agent-config/websocket-engineer
Claude Code and agent skill by blake-john/agent-config
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
当使用 WebSocket 或 Socket.IO 构建实时通信系统时使用。适用于双向消息通信、Redis 水平扩展、在线状态追踪、房间管理。
Install
npx vskill@latest install blake-john/agent-config/websocket-engineerSKILL.md
WebSocket 工程师
核心工作流程
- 分析需求 — 确定连接规模、消息量、延迟需求
- 设计架构 — 规划集群、pub/sub、状态管理、故障转移
- 实现 — 构建带认证、房间、事件的 WebSocket 服务器
- 本地验证 — 在扩展前测试连接处理、认证和房间行为(例如
npx wscat -c ws://localhost:3000);确认缺少/无效 token 时的认证拒绝、房间加入/离开事件以及消息投递 - 扩展 — 在启用 adapter 前验证 Redis 连接和 pub/sub 往返;配置 sticky sessions 并通过跨多个实例的测试连接确认;设置负载均衡
- 监控 — 追踪连接数、延迟、吞吐量、错误率;为连接数峰值和错误率阈值添加告警
参考指南
根据上下文加载详细指导:
| 主题 | 参考文件 | 何时加载 | |
|---|---|---|---|
| 协议 | references/protocol.md | WebSocket 握手、帧、ping/pong、关闭码 | |
| 扩展 | references/scaling.md | 水平扩展、Redis pub/sub、sticky sessions | |
| 模式 | references/patterns.md | 房间、命名空间、广播、确认机制 | |
| 安全 | references/security.md | 认证、授权、速率限制、CORS | |
| 替代方案 | references/alternatives.md | SSE、长轮询、何时选择 WebSocket |
代码示例
服务端设置(带认证和房间管理的 Socket.IO)
客户端重连(指数退避)
约束条件
必须执行
- 使用 sticky sessions 进行负载均衡(WebSocket 连接是有状态的 — 请求必须路由到同一服务器实例)
- 实现心跳/ping-pong 以检测死连接(仅靠 TCP keepalive 不够)
- 使用房间/命名空间进行消息范围控制,而非在应用逻辑中过滤
- 在断线窗口期间对消息进行排队,避免静默丢数据
- 在水平扩展前规划每个实例的连接限制
禁止执行
- 在没有集群策略的情况下在内存中存储大量状态(应使用 Redis 或外部存储)
- 未做显式升级处理就在同一端口混用 WebSocket 和 HTTP
- 忘记处理连接清理(在线状态记录、房间成员、进行中的定时器)
- 在生产前跳过负载测试 — 连接数峰值的行为与 HTTP 流量峰值不同
输出模板
实现 WebSocket 功能时,提供:
- 服务端设置(Socket.IO/ws 配置)
- 事件处理器(connection、message、disconnect)
- 客户端库(连接、事件、重连)
- 扩展策略的简要说明
知识参考
Socket.IO、ws、uWebSockets.js、Redis adapter、sticky sessions、nginx WebSocket 代理、JWT over WebSocket、房间/命名空间、确认机制、二进制数据、压缩、心跳、背压、水平 Pod 自动扩展
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingopencode/skills/websocket-engineer/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/blake-john/agent-config/websocket-engineer)