mcpField
C
convex-monitor

convex-monitor

github.com/get-convex云与 DevOps6931.1k 次安装1 天前更新
代码仓库

关于 convex-monitor

convex-monitor 是一项技能,可等待来自本地错误日志、部署订阅和 Sentinel 生产错误记录的类型化事件。它返回最先到达的事件或静默心跳;仅在阻塞式 MCP 不可用或能力较弱时轮询。

主要功能

  1. 01等待下一个类型化事件
  2. 02竞速监听本地日志、部署和 Sentinel 错误
  3. 03无事件时返回静默心跳
  4. 04阻塞式 MCP 不可用时采用轮询

适用场景

  1. 01出现 Convex 本地错误时及时响应
  2. 02分诊 Sentinel 报告的生产错误
  3. 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 生产环境错误行;返回最先触发的事件(或静默心跳)。

工作流

  1. 使用 {project_dir, event_kinds, timeout_ms} 调用 wait_for_event。
  2. 对于 kind=convex_error/next_error:解码并修复。对于 kind=prod_error:分类处理(参见 Sentinel)并修复。对于 kind=feature_request:实现该功能。对于 kind=quiet:继续循环。
  3. 如果某个运行环境没有可阻塞的 MCP(例如 Copilot 云端),该工具包会运行轮询循环,并采用相同的事件契约——行为相同,机制不同。

规则

  • 优先使用阻塞工具;仅在阻塞式 MCP 支持较弱时才回退到轮询循环。
  • 事件架构固定且有版本控制——相同的触发条件会生成相同类型的事件。
  • 生产事件(kind=prod_error)需要已部署的云应用和 Sentinel。

评论

支持 Markdown