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

ルール

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

コメント

Markdown 対応