关于 convex-monitor
convex-monitor 是一项技能,可等待来自本地错误日志、部署订阅和 Sentinel 生产错误记录的类型化事件。它返回最先到达的事件或静默心跳;仅在阻塞式 MCP 不可用或能力较弱时轮询。
主要功能
- 01等待下一个类型化事件
- 02竞速监听本地日志、部署和 Sentinel 错误
- 03无事件时返回静默心跳
- 04阻塞式 MCP 不可用时采用轮询
适用场景
- 01出现 Convex 本地错误时及时响应
- 02分诊 Sentinel 报告的生产错误
- 03处理事件流中的功能请求
MCP 相关
该技能使用阻塞式 MCP 工具 wait_for_event 接收类型化事件。在阻塞式 MCP 不可用或能力较弱的环境中,它改用轮询循环,并保持相同的事件契约。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-monitor安装后在 Claude Code 中输入/convex-monitor确认已加载。
详细介绍
等待下一个待处理事件
阻塞等待下一个已触发的事件,而不是轮询。竞速监听本地错误日志、部署订阅和 Sentinel 生产环境错误行;返回最先触发的事件(或静默心跳)。
工作流
- 使用 {project_dir, event_kinds, timeout_ms} 调用
wait_for_event。 - 对于 kind=convex_error/next_error:解码并修复。对于 kind=prod_error:分类处理(参见 Sentinel)并修复。对于 kind=feature_request:实现该功能。对于 kind=quiet:继续循环。
- 如果某个运行环境没有可阻塞的 MCP(例如 Copilot 云端),该工具包会运行轮询循环,并采用相同的事件契约——行为相同,机制不同。
规则
- 优先使用阻塞工具;仅在阻塞式 MCP 支持较弱时才回退到轮询循环。
- 事件架构固定且有版本控制——相同的触发条件会生成相同类型的事件。
- 生产事件(kind=prod_error)需要已部署的云应用和 Sentinel。
评论
支持 Markdown