mcpField
C
convex-monitor

convex-monitor

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

关于 convex-monitor

convex-monitor 是一项等待下一个类型化事件而非反复轮询的技能。它竞速接收本地错误日志、部署订阅和 Sentinel 生产错误记录,并返回最先到达的事件或静默心跳。

主要功能

  1. 01等待类型化事件
  2. 02汇集本地日志、部署订阅和 Sentinel 记录
  3. 03返回首个事件或静默心跳
  4. 04阻塞式 MCP 不可用时改用轮询

适用场景

  1. 01及时响应 Convex 错误
  2. 02分诊 Sentinel 生产错误
  3. 03通过统一事件流程处理功能请求

MCP 相关

该技能优先使用阻塞式 MCP 工具等待事件;若该方式不可用或能力不足,则使用保持相同事件契约的轮询循环。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/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