convex-monitor

get-convex/agent-skills/convex-monitor

此技能用于监视 Convex 应用中的下一个开发或生产错误或请求，并对其做出反应。它通过阻塞等待下一个类型化事件（而非轮询）来工作，同时竞争本地错误日志、部署订阅和 Sentinel 生产错误行，返回最先触发的事件（或静默心跳）。工作流程包括：调用 wait_for_event 并指定项目目录、事件类型和超时时间；根据事件类型（如 convex_error、prod_error、feature_request 或 quiet）进行相应处理。在无阻塞 MCP 的环境中，技能会使用轮询循环，但保持相同的事件契约。

安装量 · 491查看来源

Installation

npx skills add https://github.com/get-convex/agent-skills --skill convex-monitor

技能文件

SKILL.md

最近同步 · 2026年8月29日

SKILL.md›

---
name: convex-monitor
description: "Watch for the next dev/prod error or request in a Convex app and react to it."
---

<!-- GENERATED from convex-agents content/capabilities/monitor.json — do not edit by hand. -->

# Watch for the next thing to react to

Block on the next typed event instead of polling. Races local error logs, deployment subscriptions, and Sentinel prod-error rows; returns the first to fire (or a quiet heartbeat).

## Workflow

1. Call `wait_for_event` with {project_dir, event_kinds, timeout_ms}.
2. On kind=convex_error/next_error: decode and fix it. On kind=prod_error: triage (see sentinel) and fix. On kind=feature_request: build it. On kind=quiet: loop.
3. Where a harness has no blocking MCP (e.g. Copilot cloud), the pack runs a poll loop with the SAME event contract — same behavior, different mechanism.

## Rules

- Prefer the blocking tool; fall back to a poll loop only where blocking MCP is weak.
- The event schema is fixed and versioned — the same trigger yields the same typed event.
- Prod events (kind=prod_error) require a deployed cloud app plus Sentinel.