replay-triageスキルは、PendoのPendoリプレイをコードに結びつけ、訪問者が経験したバグから提案されたコード修正案へと単一のワークフローで移行できるようにします。どこまで進めるかは、AIクライアントがどのツールに接続されているかによって異なります（前提条件を参照）。
ユースケース
Pendoリプレイトリアージスキルを使用して次のことを行えます：
- バグを記録したリプレイから、訪問者が体験したバグを診断する。
- プロジェクト管理ツール（JiraやLinearなど）で、Pendoリプレイにリンクされたバグレポートから開始する。
- フラストレーションが溜まったり失敗したセッションで何が間違っていたのかを発見する。
- 報告された問題からレビュー済みのコード修正に迅速に移行する。
仕組み
PendoリプレイURLやそれにリンクするチケットが与えられると、スキルは毎回同じ順序に沿って進めることができます：
- 原因を解決する。リプレイリンクを直接受け付けるか、リンクされたチケットから取得します。
- 開発日誌のイベントを集める。セッション中に捕捉されたコンソールエラーや失敗したネットワークリクエストを収集します。
- エラーのトリアージ。この機能では、関連するエラーを、深刻度順にランク付けした短い個別の問題リストにまとめて表示し、すべてのログ行を返すことはありません。
- エラーをコードにマッピングする。これは、現在のプロジェクト内で最も深刻な問題に関連するファイルを特定します。
- 修正案を提案する。編集作業を行う前に、変更点を簡単な差分で表示して確認できるようにします。
- プルリクエストのメッセージを表示する。承認して変更が適用されると、結果の概要が表示され、プルリクエストを開くように促されます。
注：スキルの機能の範囲は、AIクライアントの接続によって異なります。エラーをコードにマッピングしたり修正を提案するには、接続コードホストが必要で、チケットから始めるにはJiraやLinearのような接続されたチケット作成ツールが必要です。これらがなければ、スキルはセッションのエラーを取得してトリアージすることはできますが、関連するコードを特定したり、修正案を提案することはできません。接続に関係なく、このスキルは確認なしで編集を適用したり、プルリクエストを開くことはありません。
前提条件
PendoリプレイTriageスキルを使うには、以下が必要です：
- トリアージしているアプリでセッションリプレイが有効になり、アプリ設定でコンソールまたはネットワークログの取得が有効になっています。スキルはこれらのログを読み取るため、少なくとも1つはオンになっている必要があります。
- MCP 経由の Pendo 接続。スキルはPendoからPendoリプレイ開発ログデータを読み取るため、アクティブなPendo MCP接続が必要です。スキルはそれなしでは動かせません。
- スキルを実行する作業ディレクトリにあるプロジェクトのコードにアクセスできるようにすることで、エラーをファイルと照合し、修正案を提案できます。
- ClaudeやCursorのようなスキルをサポートするAIクライアント。
以下の接続は任意で、ワークフローのさらなる要素を解き放ちます：
- AI 環境に接続されたチケット発行ツール。AI クライアントがチケットツール（Atlassian MCP 経由の Jira や Linear MCP 経由の Linear など）に接続されている場合は、リプレイリンクではなくチケットから開始できます。スキルはチケットからリプレイリンクとバグコンテキストを引き出します。
- AI 環境に接続されたコードホスト。スキルがセッションのエラーをコードベースと照合できるように、コードホスト（GitHubなど）を接続してください。
スキルをインストールする
replay-triageスキルファイルをダウンロードして、お好みのAIコーディングアシスタントに追加してください。インストール手順については、お使いのツールのマニュアルを参照してください。以下はその例です。
Pendoリプレイトリアージスキルを使用する
スキルをダウンロードしてAIクライアントに提供した後：
- リプレイリンクやチケットを提供する。リプレイプレイヤーのURL、保存されたクリップURL、またはリプレイリンクを含むチケット参照（JiraキーやURL、GitHub発行のURLなど）を提供してください。
- フォーカスのヒント（任意）を追加する。問題の簡単な説明（例：「ログイン失敗」や「保存時に500エラー発生」）を含めることで、トリアージ担当者が適切なエラーを特定できるようになります。チケットから開始すると、スキルはチケットの説明をこのコンテキストに使用します。
- スキルを使用する。スキルはPendoリプレイを解析し、開発ログのイベントを取得し、それらをランク付けしたショートリストにまとめます。ログの取得には少し時間がかかることがあります。
- 問題点と提案された修正案を見直す。このスキルは、主要な問題点とその裏付けとなる証拠を提示し、コードが特定できた場合は、簡単な差分とともに修正案を提示します。続ける前に提案書を確認してください。
- 変更を承認する。修正内容が適切であれば承認してください。承認すると、スキルがローカルファイルに編集内容を適用します。調整が必要なら、変更を求めて再度見直してください。
- 確認してプルリクエストを開く。変更が適用されると、スキルはプロジェクトに設定されている既存の型チェックまたはテストを実行し、変更内容を要約します。準備ができたらご自身でプルリクエストを開いてください。
ヒント：フォーカスヒントを使用すると、ノイズの多いセッションでのトリアージがより迅速かつ正確になります。症状が分かっている場合は、名前 — 例えば「セーブ後にUIがフリーズする」と挙げてください。
スキルができないこと
このスキルは、コードとチケットの変更を管理できるように設計されています：
- プルリクエストは開かない。変更を準備し、準備ができたらプルリクエストを開くように促します。
- チケットは変更されない。文脈を把握するためにリンクされたチケットを読み込むが、コメントを追加したり、遷移させたり、変更したりはしない。
- 大きな変更を行わない。修正はPendoリプレイのバグに限定されており、無関係なリファクタやクリーンアップはありません。
- ファイルの場所を推測するわけではない。スタックトレースがミニファイされている場合、またはエラーが一般的な場合、ファイルを選択するのではなく、エラーをマッピングできない旨を通知します。
- 実行するにはPendoリプレイURLが必要。バグの説明だけではトリアージを始めるには不十分です。
トラブルシューティング
セッション中にエラーが見つからなかった場合。スキルは、より低いログレベルとすべてのネットワークトラフィックを含むように検索範囲を広げます。セッションの記録期間内にエラーや障害が捕捉されなかった場合、その旨がスキルによって通知され、別のPendoリプレイを試したり、時間範囲を広げたりすることができます。
リプレイリンクに時間範囲がない場合。セッションリプレイからプレイヤーリンクを再度コピーしてください。PendoからエクスポートされたプレイヤーURLには、スキルが必要とする開始時間と終了時間が含まれます。
一つのチケットが複数のPendoリプレイにリンクされなかった場合。このスキルは、コンテキストとともに候補となるリプレイを一覧表示し、どれをトリアージするかを尋ねます。
エラーがコードに一致されなかった場合。スタックトレースが難読化されている場合や、エラーメッセージが汎用的な場合、このスキルは推測せず、ソースを特定できないと回答します。アプリのどの部分が関係しているかを示すフォーカスヒントを追加して、もう一度実行してください。