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. 01Convex のローカルエラー発生時に対応
  2. 02Sentinel が報告した本番エラーのトリアージ
  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. Copilot cloud のようにブロッキング MCP がないハーネスでは、パックが同じイベント契約（動作は同じで、仕組みは異なります）を使ったポーリングループを実行します。

ルール

  • ブロッキングツールを優先し、ブロッキング MCP が弱い場合に限りポーリングループにフォールバックします。
  • イベントスキーマは固定され、バージョン管理されています。同じトリガーからは、常に同じ型のイベントが生成されます。
  • 本番イベント（kind=prod_error）には、デプロイ済みのクラウドアプリと Sentinel が必要です。

コメント

Markdown 対応