mabl CLIは「mablデバッガー」と呼ばれるデバッグスキルをサポートしています。このスキルをAIコーディングエージェントで使用することで、編集者を離れることなく、失敗したmablテストの調査、再現、修正を行えます。
mablデバッガーを使用すると、以下のことができます。
- 失敗を調査する：失敗した実行からステップのトレース、コンソール出力、ネットワークリクエスト（HAR）、DOMスナップショット、スクリーンショットを取得します。エージェントは、あなたが使用するのと同じ情報をもとに失敗を調査します。
- ライブデバッグ：エージェントが操作するローカルのChromeセッションを開きます。エージェントはテストをステップごとに実行し、ライブページを検査して修正を適用し、失敗したステップを再実行して成功することを確認します。
関連するアーティファクトのみを取得してリアルタイムで課題を確認することで、mablデバッガーはセッションをスリムに保ち、不要なトークン消費を最小限に抑えます。この記事では、mablデバッガーのセットアップ方法と使用方法について説明します。
セットアップ
前提条件
デバッガーをインストールする前に、以下の設定が完了していることを確認してください。
- Claude Code、Cursor、VSCode、GitHub Copilotなど、MCPをサポートするAIコーディングエージェント、またはAGENTS.mdファイルを読み込むその他のクライアント。
- mabl CLIの最新バージョン
mabl CLIにログインしていることを確認してください。
mabl auth loginデバッガーをインストールする
使用するエージェントに合わせて、以下のインストールコマンドを実行してください。
mabl agent install [client][client]の部分を、claude、cursor、vscode、copilot、またはその他のツール向けのagents-mdなど、使用するエージェントの名前に置き換えてください。たとえば、Claude Codeにデバッガーをインストールする場合は、次のコマンドを実行します。
mabl agent install claudeインストールコマンドを実行すると、3つのツールが追加されます。
- mabl debug skill - 失敗したmablテストからデータを抽出して課題を分析・解決する機能をエージェントに付与します。
- mabl MCP - mablワークスペースへのアクセスや、結果の取得、失敗の分析などのツールをエージェントに付与します。
- chrome-for-mabl MCP - ライブデバッグセッションの監視やブラウザとのインタラクション（アーティファクトの収集を含む）をエージェントに付与します。
オプションのインストールフラグ
必要に応じて、オプションのインストールフラグを使用して設定をカスタマイズできます。
| フラグ | 機能 |
|---|---|
--scope user|project |
ユーザー向けにインストールする（デフォルト）か、現在のプロジェクトディレクトリにスコープを限定してインストールする |
--force |
既存のmablスキルおよびMCPエントリを上書きする |
--skip-mcp |
スキルのみをインストールします。既存のMCP設定はそのまま維持されます。 |
--append-snippet |
エージェントのインストラクションファイル（CLAUDE.md、.cursorrules、AGENTS.mdなど）に「Testing: mabl」セクションを追記する |
テストをデバッグする
インストールが完了すると、mablデバッガーはエージェントに4ステップのデバッグループを習得させます。
| フェーズ | 内容 | コマンド例 |
|---|---|---|
| トリアージ | 失敗したステップのトレースを検査し、失敗したステップで取得されたアーティファクトを取得します。 | mabl agent debug steps [jr-id] |
| 仮説を立てる | 失敗を特定のコードまたは最近のデプロイと関連付けます。 | grep -r “[failing selectors]” src/ |
| 再現 | エージェントに接続された実際のChromeを起動し、テストをステップごとに実行します。 | mabl agent debug sessions start --run-id [jr-id] |
| 確認 | 修正後に失敗したステップを再実行する | mabl agent debug session run-step [sid] [step-id] |
利用可能なコマンドの完全なリストについては、mabl CLIコマンドリファレンスを参照するか、ターミナルでmabl agent -hを実行してください。
失敗を調査する
失敗を調査するには、最近のmablテストの失敗についてエージェントに確認し、プロンプトを使ってデバッグプロセスを開始します。
「このテストの実行をローカルでデバッグできますか？」
エージェントはトレースを取得し、アーティファクトを読み込んで、仮説を提示します。
ライブデバッグ
さらに詳しく調査するには、エージェントにローカルで失敗を再現するよう依頼します。
「これをローカルで再現できますか？」
エージェントはローカルのChrome for Testingセッションを開始し、テストをステップごとに実行します。完了後、エージェントは概要を提供し、テストの更新やコードの修正など具体的な解決策を提案します。これにより、エージェントセッションを離れることなく修正を完了できます。