用途:为 AI Developer Workflow(ADW)可观测性设计 WebSocket 事件广播,适合把工作流事件流式传输到外部仪表盘或监控系统的场景。调用参数为 $ARGUMENTS,包含 event-type(如 ToolUseBlock、StepComplete)和可选的 payload-description。
主要能力:覆盖 TextBlock、ToolUseBlock、ThinkingBlock、StepStart、StepEnd、ADWComplete 等事件类型及其来源与载荷;定义标准 ADW 事件消息结构(type、adw_id、step、event_type、timestamp、summary、payload);设计摘要策略(对工具调用、文本、思考内容可用 Haiku 生成 15 词以内摘要,对步骤开始/结束与 ADWComplete 采用固定格式直通);给出基于 FastAPI 与 asyncio 的 WebSocket 服务端规范(含按 adw_id 分组的 ConnectionManager);设计客户端订阅消息(可按 adw_id、steps、event_types 过滤);设计弹性模式,包括指数退避重连(最大延迟 30 秒、最大尝试 10 次)与心跳(间隔 30 秒、超时 90 秒)。
使用方式:按指令分五步产出规范——定义消息格式、设计摘要策略、设计 WebSocket 服务端、设计客户端订阅、设计弹性模式,并以 markdown 输出事件广播规范,含服务端端点(ws://localhost:8000/ws/{adw_id})、订阅消息与集成方式(钩子脚本通过 HTTP POST 广播)。后续步骤为实现 WebSocket 服务端(adws/websocket_server.py)、集成钩子、构建泳道 UI、可选事件持久化。
限制:资料说明完整 WebSocket 集成需要生产级后端,该命令只提供规范,实现需要 FastAPI/asyncio 环境;未提供收费、价格或平台支持等具体信息。