gateway-diagnose について
gateway-diagnose は、ゲートウェイのリクエスト、イベント、実行、フローを調査するスキルです。障害の追跡、許可された復旧、配信確認を、プライベートデータを保護しながら進めます。
主な機能
- 01ゲートウェイ各段階のリクエスト追跡
- 02タイムスタンプ、ID、タイムアウトの比較
- 03障害原因の追跡
- 04許可された範囲限定の復旧
- 05動作確認と観測結果の報告
活用シーン
- 01ゲートウェイ配信失敗の調査
- 02キュー遅延とエージェント停止の判別
- 03プローブを行わない障害監査
- 04許可されたサービス復旧の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ joelhooks/ joelclaw --skill gateway-diagnoseインストール後、Claude Code で/gateway-diagnoseを入力して読み込まれたか確認します。
詳細
ゲートウェイの診断
失敗したリクエスト、イベント、実行、またはフローの ID と、期待される動作を特定します。既存の証拠から調査を始めてください。診断を行うこと自体は、プローブメッセージの送信を許可するものではありません。
現在のゲートウェイのエントリーポイント、サービス設定、オーナーシップと運用手順書を確認します。サポートされているステータス、イベント、診断コマンドについては、joelclaw gateway --help を使用してください。依存関係をプローブする前にサービスの配置先を確認します。ローカルクラスターが存在しないことは、リモートで管理されている依存関係が失敗した証拠にはなりません。
実際の経路を追跡します。イングレス、永続キュー、ポリシー、ゲートウェイセッション、アダプター、配信確認です。タイムスタンプ、相関 ID、進行状況、設定済みのタイムアウトを比較してください。キューの経過時間だけでは、エージェントがハングしているとは断定できません。依存関係が劣化していても、チャネルやセッションの診断に役立つ場合があります。
最初に見つかった関連する障害を原因まで追跡します。監査の場合は、その内容を報告してください。認可された修復の場合は、その障害を修正し、独立した診断を続けてください。最初のプローブが失敗したというだけで、タスク全体を止めないでください。
設定済みのモデル、プロバイダー、プロセスオーナー、現在の起動元を使用してください。過去のエラー文字列は手がかりであり、古い組み込みコントローラー、ポーリングオーナーのリース、モデルの固定状態を復元する指示ではありません。
単一のトランスポートオーナーとゲートウェイオーナーを維持してください。競合するポーラーやゲートウェイを起動したり、アクセス制御を弱めたり、名前でプロセスを終了したり、共有チェックアウトをリセットしたりしないでください。認可されている場合は、オーナーサービスの対象を限定した再起動または復旧手順を使用してください。
影響を受けた動作を検証し、正確な観測結果を報告してください。キューへの送信が成功しても、配信された証拠にはなりません。診断レポートにトークン、非公開メッセージの生データ、認証ファイルを決して記載しないでください。