CodeDraig/CodexMonitor

CodexMonitorとCodexアプリサーバーのプロトコル整合性を維持します。サポートされている/欠落しているアプリサーバーの通知・リクエストの監査、イベントルーティングの追跡、スキーマドリフトの診断、上流のCodex変更後のdocs/app-server-events.mdの更新を求められたときに使用します。

CodexMonitor とは?

このスキルは、CodexMonitorとインストールされているCodex CLI間のアプリサーバープロトコルの同期を保ちます。主な目的は、通知/リクエストメソッドの差分を監査し、JSONスキーマのドリフトを検出し、正規のランブックdocs/app-server-events.mdを更新することです。ワークフローは、上流のベースライン(codexのバージョンとオプションのチェックアウトハッシュ)の確認から始まり、通知メソッドとリクエストメソッドをCodexMonitorのルーティングコードと比較し、該当するドキュメントセクションを更新します。スキーマドリフトの調査では、生成されたスキーマや上流のソースを直接検査し、パーサーや正規化のコードの不整合を特定します。新しいサポートを追加する際は、まずパースエッジでメソッド/タイプを追加し、イベントフックでルーティングし、必要に応じてスレッドアイテム/リデューサーを更新し、重複ロジックを避けます。検証はプロトコルチェックスクリプト、単体テスト、型チェック、Tauriバックエンドビルドで行われます。このスキルは、監査や更新の依頼に対して、具体的なメソッド差分、編集が必要なファイル、およびdocs/app-server-events.mdの該当変更箇所を報告します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/CodeDraig/CodexMonitor/tree/HEAD/.codex/skills/app-server-events-sync

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アプリサーバーイベント同期

このスキルを使用して、インストールされているCodex CLIの進化に合わせてCodexMonitorのアプリサーバー統合を正確に保ちます。

正規ソース

以下から始めてください:

  • docs/app-server-events.md

そのファイルを正規のランブックとして扱い、動作が変わったときに更新します。

ワークフロー

  1. 上流ベースラインを確認:

    • codex --version を記録し、新しい一時ディレクトリに実験的スキーマを生成します。選択した実行可能ファイルを互換性ターゲットとします。
    • ../Codex が存在する場合、フェッチやプルーニングを行わずにチェックアウトされたハッシュを記録します。サイドチェックアウトはオプションです。
  2. 通知メソッドを比較:

    • Codex v2 通知メソッドのセットを、src/utils/appServerEvents.ts および src/features/app/hooks/useAppServerEvents.ts のCodexMonitorルーティングと差分比較します。
    • docs/app-server-events.md の サポートされているイベント と 欠落しているイベント のセクションを更新します。
  3. リクエストメソッドを比較:

    • Codex v2 クライアント/サーバーリクエストセットを、CodexMonitorの送信および受信ハンドリングと差分比較します。
    • サポートされているリクエスト、欠落しているクライアントリクエスト、サーバーリクエスト のセクションを更新します。
  4. リストが変わらない場合のスキーマドリフトを調査:

    • 生成されたJSONスキーマを検査します。上流ソースを使用する場合は、codex-rs/app-server-protocol/src/protocol/v2/ を検査します。
    • src/utils/appServerEvents.ts、src/features/app/hooks/useAppServerEvents.ts、および src/features/threads/utils/threadNormalize.ts のパーサーと正規化のエッジを比較します。
  5. 要求されたときのサポートを実装:

    • 最初にパースエッジでメソッド/タイプのサポートを追加します。
    • アプリイベントフックでルーティングします。
    • 必要に応じてのみ、スレッド/アイテムリデューサーとレンダリングを更新します。
    • アプリ/デーモンのパリティを維持し、重複ロジックを避けます。
  6. 検証:

    • python3 scripts/check-codex-protocol.py --schema-dir <生成ディレクトリ> を実行します(Python jsonschema が必要)。
    • 触れたファイルに対してターゲットテストを実行します。
    • npm run typecheck を実行します。
    • フロントエンドの動作変更に対して npm run test を実行します。
    • バックエンドの変更に対して cd src-tauri && cargo check を実行します。

主要ファイル

  • ルーティング/タイプ: src/utils/appServerEvents.ts
  • イベントルーター: src/features/app/hooks/useAppServerEvents.ts
  • ハンドラー構成: src/features/threads/hooks/useThreadEventHandlers.ts
  • アイテム/ターンハンドラー: src/features/threads/hooks/useThreadItemEvents.ts、src/features/threads/hooks/useThreadTurnEvents.ts
  • 正規化: src/features/threads/utils/threadNormalize.ts
  • 状態: src/features/threads/hooks/useThreadsReducer.ts
  • 送信リクエスト: src/services/tauri.ts、src-tauri/src/shared/codex_core.rs
  • デーモンRPC: src-tauri/src/bin/codex_monitor_daemon/rpc.rs および rpc/*

参考文献

  • クイックコマンドセット: references/quick-commands.md
  • 正規ランブック: docs/app-server-events.md

出力期待値

監査や更新が要求された場合:

  • 具体的なサポート済みおよび欠落メソッドの差分を報告します。
  • 編集が必要な正確なファイルを引用します。
  • 動作が変わったときは、同じ変更で docs/app-server-events.md を更新します。
  • 意図的な非サポート(例:非推奨のメソッド)を明示的に指摘します。

関連スキル