mcpField
P
proxyman-debugging-tools

proxyman-debugging-tools

github.com/proxymanapp開発22212 回インストール10 週間前に更新
リポジトリ

proxyman-debugging-tools について

proxyman-debugging-toolsは、Proxymanのデバッグ手順を計画するドキュメント中心のスキルです。最新の公式資料を参照し、GUI、MCP、CLIの経路を区別して、検証とロールバックを重視します。

主な機能

  1. 01最新の公式ドキュメントを取得
  2. 02症状に合うドキュメントを特定
  3. 03GUI、MCP、CLIの経路を区別
  4. 04検証とロールバックの指針
  5. 05機密トラフィックに関する安全指針

活用シーン

  1. 01Proxymanのトラフィックデバッグ手順の計画
  2. 02機能の最新セットアップ手順の確認
  3. 03タスクがMCPまたはCLIに対応するかの判断
  4. 04安全な変更と検証方法の記録

MCP 対応

MCPによる操作とドキュメント検索を区別し、実行が必要な場合は該当するProxyman MCPツールへ案内します。組み込みのMCPドキュメント検索はセットアップとトラブルシューティングを対象とし、公開ドキュメント全体は網羅しません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/proxymanapp/proxyman-skill.md --skill proxyman-debugging-tools

インストール後、Claude Code で/proxyman-debugging-toolsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
debugging-tool-index.md
protocol-decoding-and-key-logging.md
replay-and-routing.md
request-response-modification.md

詳細

Proxyman デバッグツールとドキュメント

公式の Proxyman ドキュメントを使って、デバッグワークフローの説明や計画を行います。このスキルはドキュメントを優先するため、同じ名前の MCP または CLI アクションが存在するとは限りません。

MCP を今すぐ操作することが主なタスクであれば、proxyman-traffic-debugging を使います。Settings タブの監査や設定変更には proxyman-app-settings、ローカルのルート証明書/カスタム証明書のライフサイクル管理や Help メニューの Debug Mode/Factory Reset には proxyman-certificates-recovery、デバイス/ランタイムのキャプチャ設定には proxyman-https-capture、シェルの自動化には proxyman-cli、ライセンスには proxyman-license-management を使います。

最新のドキュメントを取得する

最新の動作が重要なタスクでは、毎回次の手順を行います。

  1. https://docs.proxyman.com/llms.txt を取得します。
  2. ユーザーの機能や症状に合う公式の .md エントリを選びます。
  3. 選択した .md ページを直接取得します。インデックスに記載されている場合、記憶を頼りにページのパスを再構築しないでください。
  4. 取得した URL から末尾の .md だけを削除し、公開 HTML URL として引用します。
  5. ページで、手順に大きく影響する前提条件やトラブルシューティングのページがリンクされている場合、そのページも取得します。

信頼できる情報源として、公式の Proxyman 所有ドメイン docs.proxyman.com、docs.proxyman.io、proxyman.com、proxyman.io と、稼働中の Proxyman MCP サーバーを使います。新たに取得した公式ページが外部のリンク先を参照している場合、そのリンク先は、その製品やサービスについてのみ信頼できる情報源として扱います。ただし、ユーザーがサードパーティの案内を求めている場合は除きます。

インターネットにアクセスできない場合は、最新のページを確認できなかったことを伝えます。ナビゲーションの代替手段として、同梱されているデバッグツールインデックスを使用できますが、スナップショットであることを明記してください。

組み込み MCP ドキュメントを理解する

search_docs、answer_setup_question、docs://search/{query}、および静的 MCP リソースは、Proxyman に同梱されているセットアップとトラブルシューティングのナレッジベースを検索します。バージョンが一致しており、キャプチャの診断に最適ですが、docs.proxyman.com のドキュメント全体を網羅しているわけではありません。

製品全体に関する機能の質問では、search_docs が結果を返した場合でも、公開インデックスを取得します。MCP の入力を正確に確認する場合は、公開 MCP ページやこのスキルではなく、tools/list を信頼してください。

回答やガイドを作成する

  1. ユーザーの目的、対象トラフィック、プラットフォーム、および説明、GUI 手順、MCP の実行、CLI の自動化のどれを求めているかを特定します。
  2. 最新の公式ページを読み、前提条件、対応プラットフォーム、制限、動作確認方法を確認します。
  3. デバッグツールインデックスを確認し、機能とインターフェースを対応付けます。
  4. 対応が確認できている方法だけを提示します。
    • GUI: 最新のページに基づくメニュー/画面と、順序に沿ったユーザー操作。
    • MCP: 現在のツール名、検出の要件、状態の読み取り、変更、検証。
    • CLI: proxyman-cli に案内し、正確なフラグを提示する前に、インストール済みのヘルプを確認します。
  5. 具体的な検証方法を含めます。想定されるフロー、ルールの一覧、ステータスフィールド、レスポンスの変更、またはエクスポートされた成果物などです。
  6. 永続的なルール、プロキシの変更、証明書の信頼設定、またはキャプチャの自動化については、元に戻す方法も含めます。

ドキュメントで GUI 専用とされている機能については、その旨を伝えます。MCP/CLI でも同等に使えると推測してはいけません。

ガイドの構成

次の簡潔な構成を使います。

Goal
Prerequisites
GUI steps
MCP steps (if exposed)
CLI steps (if exposed)
How to verify
How to undo
Limits / platform notes
Official docs

内容のないインターフェースのセクションは、無理に埋めず省略します。

安全性

  • 読み取り専用の調査とトラフィックの確認から始めます。
  • プロキシのルーティング、信頼ストア、グローバルなツールの状態、外部プロキシの認証情報、その他のアプリケーションを変更する前に、確認を得てください。
  • 削除、セッションのクリア、証明書のアンインストール、破壊的なインポート、取り消し不能なポータル操作の直前に、確認を得てください。
  • MCP の秘匿化を有効にしておきます。エクスポートされた元のトラフィックは、MCP のプレビューによる秘匿化ではサニタイズされないことを警告してください。
  • ユーザーが明示的に求め、その情報が露出することを理解している場合を除き、ライセンスキー、TLS セッションキーのログ、トークン、パスワード、Cookie、キャプチャされた秘密情報をガイドやツール入力に貼り付けないでください。
  • このタスク中に取得していないページを、最新であると主張しないでください。

対象範囲

リファレンスでは、キャプチャ/表示/フィルターツール、Repeat/Compose、Breakpoint、Map Local/Remote、Block/Allow List、Scripting、No Caching、External/Reverse/SOCKS プロキシ、SSL Proxying、証明書、WebSocket、Protobuf/GraphQL、Network Conditions、DNS Spoofing、エクスポート、コード生成、差分、OpenAPI、TLS Key Logging、および関連する GUI ツールを対象とします。

最新のインデックスに新しいデバッグページが追加されている場合は、スナップショットに含まれていなくてもそのページを使用し、製品で現在利用できるインターフェースを明記してください。

コメント