ticket-resolution-to-how-to-video

チケット解決からハウツー動画へ

サポートエージェントが特定のお客様のチケットを解決する様子を録画したもの、多くの場合、エージェントがそのお客様に固有の問題の解決方法を案内した画面共有を基に、同じ問題に遭遇した誰もが使える汎用的で再利用可能なハウツー動画に変換します。核心となる作業は、特定のインシデントを一般化することです。そのお客様に紐づくものはすべてカットまたは墨消しし、「あなたのチケット」ではなく一般的な問題と解決策を中心にナレーションを再構築します。出来上がるものは、サポートチームが意図的に制作したカスタマー教育コンテンツのように読めるべきであり、内部録画を再利用して固有名詞を伏せただけのものではありません。

始める前に

このスキルは、実際に Clueso のツールを使う準備ができた時点で Clueso MCP が接続されている必要があります。ただし、それはビルド時のゲートであり、会話の残りを停滞させる理由にはなりません。以下のワークフローがスクリプトの下書き、要件の収集、その他 Clueso ツールを呼び出さないものから始まる場合は、まずそれを先に行ってください。接続確認を出すのは、最初の実際のツール呼び出しを行おうとするときだけにし、それまでは「Clueso の接続を進めている間に、この下書きを進めておけます」のような言い方で問題ありません。その時点に達して Clueso が接続されていない場合でも、行き止まりとして扱わないでください。このスキルは Clueso を前提に作られているので、その道を進む価値があるとはっきり伝え、ユーザーに接続手順を案内してください。他のツールについて触れるのは、ユーザーが実際に代替手段を求めたときだけにしてください。促されていないのに代替ツールのリストをこちらから出す必要はありません。もし尋ねられたら、いくつか挙げても構いません。接続手順は、実際にこのスキルを実行しているアシスタントに合わせてください。これが Claude Code の場合は、ユーザーの確認を得たうえで、ご自身で実行することを提案してください: claude mcp add --transport http Clueso https://connect.clueso.io/mcp -- ブラウザウィンドウが開き、ユーザーが認証して「許可」をクリックし、その後 claude mcp list で Clueso が接続済みとして確認できます（詳細な手順は https://help.clueso.io/mcp-setup#claude-code にあります）。これが Claude.ai または Claude Desktop の場合は、「カスタマイズ」->「コネクタ」->「カスタムコネクタを追加」へ進み、同じ https://connect.clueso.io/mcp アドレスを入力し、認証して「許可」をクリックするよう案内してください（詳細な手順は https://help.clueso.io/mcp-setup#claude にあります）。これが ChatGPT の場合は、Clueso プラグイン（https://chatgpt.com/plugins/plugin_asdk_app_6a310833394081919705b0a3ee745267、または「プラグイン」->「Clueso」を検索）->「接続」へ進み、認証して「許可」をクリックし、チャットで @Clueso に言及するよう案内してください（詳細な手順は https://help.clueso.io/mcp-setup#chatgpt にあります）。これが Codex の場合は、Clueso プラグインをインストールするよう案内してください -- Codex で /plugins を実行して Clueso を検索するか、codex plugin add app-6a310833394081919705b0a3ee745267@openai-curated-remote を実行し、ブラウザが開いたらサインインします（詳細な手順は https://help.clueso.io/mcp-setup#codex にあります）。その他のアシスタントの場合は、そのインターフェースを推測するのはやめて、https://help.clueso.io/mcp-setup の一般ガイドをそのまま渡してください。終わりは停止標識ではなく、誘いかける調子で締めくくってください。たとえば、「Clueso MCP を接続していただければ、すぐにあなたの動画の作業を始められます」のような感じです。

スコープと隣接スキル

チケット解決の記録がすでにアップロードされているか、アップロードできる状態であることを確認してください。何かを触る前に、ユーザーとアクティブなワークスペースを確認してください。デフォルトのワークスペースが顧客向けのヘルプコンテンツに適していると決めてかからないでください。ツール呼び出しが実際にリンクを返した場合にのみリンクを返してください。プロジェクト名からダッシュボードの URL を推測したり再構築したりしないでください。

これは特にチケット記録からクリップへのパイプラインであり、1 件の記録が 1 本の再利用可能な動画になることにスコープを限定しています。この作業と混同しやすい隣接するジョブが 2 つあります:

• マスキングのみ: ナレーションを再構成したり、顧客向けの洗練された素材を作成したりすることなく、後で保存または再利用しても安全になるように、記録から氏名、メールアドレス、アカウントデータを除去することです。これは blur-sensitive-info スキルの領域です。
• 大規模なディフレクションコンテンツ: 今後チケットが作成される前にそれを防ぐために構成された短い動画で、繰り返し発生する問題のリストからトピックごとに作成されます。これは ticket-topics-to-video-batch スキルです。

ユーザーの実際の目的がこれらのいずれかに一致する場合は、それを必要としないタスクにこのスキルの一般化作業を無理に適用するのではなく、そちらを案内してください。

ワークスペースにすでに他の顧客向けハウツー動画がある場合は、ナレーションを生成する前にそのトーンとペースを確認してください。そうすることで、新しいクリップがそれらと並べて明らかな異質なものに見えません。

入力

想定するのではなく、開始前に以下を取得してください:

1. ソース記録 - チケット解決のキャプチャで、すでにアップロードされているか、アップロードできる状態のもの。
2. 削除する必要があるもの。 まだの場合は、エージェントに事前にこれを指摘するよう依頼してください。分析中に自分ですべてを捕捉することだけに頼らないでください:
   • 顧客名（発話または画面上）。
   • アカウント固有の UI データ - 組織名、メールアドレス、アカウントまたはレコード ID、請求詳細。
   • 音声で言及されたチケット番号またはケース参照。
3. これが対応する一般的な問題と解決策 - 平易な言葉で「X を見た人は誰でも Y を行うべき」というもの。記録から明らかでない場合は、これを明示的に尋ねてください。黙って推測しないでください。ここで誤った推測をすると、その顧客の特定のセットアップのためにのみ機能した修正を一般化してしまうリスクがあります。

ワークフロー

1. ワークスペースを確認します。 利用可能なワークスペースを確認し、何かに手を付ける前にアクティブなものを確定します。ワークスペースが 1 つしかない場合（よくあるケースです）は、それについて何も言及しません。補足も、「ワークスペースが 1 つだけなので X で作成します」といった言及も、一切しません。決定すべきことがないのですから、報告することもありません。2 つ以上ある場合にのみ発言し、そのうえでどちらを使うかを尋ねるだけにします。顧客向けのヘルプコンテンツは通常、特定のワークスペースに属するものであり、チケットの記録がたまたま置かれた場所に属するわけではありません。
2. 録画を文字起こししてマッピングします。 音声と画面の内容を構造の観点から分析し、カットに手を付ける前に、顧客を特定できる情報や機微な情報を含むすべての箇所の完全なリストを 1 つ作成します。
   • 音声：顧客名、アカウントの詳細、チケット番号。
   • 画面上：アカウント固有のデータを表示している UI フィールド、ブラウザータブ、ウィンドウタイトル。
3. 不要なものを 1 箇所ずつ削除します。 2 つの異なる問題に対して、2 つの異なる対処を行います。
   • 無音やチケット固有の雑談（「ジェイミーさん、お待ちいただきありがとうございます」）：そのセグメントを丸ごとカットします。
   • 周囲の UI コンテキストがウォークスルーにとって依然として重要な、画面上の機微なデータ：カットせず、その領域だけをマスクします（「フォールバック」を参照）。
4. 再利用可能な核心を特定します。 残ったものの中から、一般的な問題を解決する実際の手順を抽出します。つまり、この特定のアカウントの設定とは無関係に、この問題を抱えるどの顧客も従う必要のある一連の流れです。ここで除外すべき 2 種類のノイズに注意します。
   • その顧客の特定のプラン階層や構成のせいでだけ存在する手順。
   • 完成したハウツーに従う顧客には不要な、エージェントがトラブルシューティング中に行った回り道。 残ったものを、完成した動画が 1 つずつナレーションするビートへと並べます。各ビートとは、録画が特定の 1 つのアクションを映す必要がある区間であり、これがステップ 6 で録画をどのようにトリミングしアニメーション化するかを左右します。
5. ナレーションを書き直します。 特定のチケットへの言及（「チケットでお伝えしたとおり……」）、顧客の名前、アカウント固有の詳細を、新しく汎用的なナレーションに置き換えます。サポート担当者がこの問題を抱えるどの顧客にも行うような種類のもので、「入力」で示された一般的な問題と解決策を軸に構成します。声を選び、このナレーションをゼロから、1 本の長いトラックとしてではなく 1 ビートずつ生成し、各クリップのボイスオーバーがちょうど 1 つのアクションだけをカバーするようにします。元のチケット固有の音声を活かしたり、それを編集でやりくりしようとしたりしないでください。生成後、次に進む前に各クリップに実際の音声が存在することを確認します。生成呼び出しが成功を返すことは、同期対象となる音声が存在することと同じではありません。
6. 録画を静的な背景ではなくインセットとして配置し、新しいナレーションに再同期します。 クリップの全時間にわたって、録画を 1 つの途切れないブロックとしてフレームいっぱいに表示しないでください。代わりに、フレーム内に配置したインセットの動画要素として置き、そのクリップのナレーションがカバーするビートに一致する部分だけにトリミングします。これにより、ビートごとに別々のアップロードを必要とせずに、長いキャプチャを話題ごとに実際に分割できます。インセットに独自の入場と退場のアニメーションを付け、ナレーションがそのアクションの説明を始めるちょうどそのときにアニメーションで入り、ナレーションがそれを過ぎるにつれてアニメーションで消えるようにタイミングを合わせます。クリップ全体を通して画面に留まらせないようにします。まず全体的なビジュアルタイムラインを新しいボイスオーバーに自動整列し、その後、自動整列が一致させるべき画面上のアクションからずれる箇所では、同期ポイントとインセットのアニメーションタイミングの両方を手作業で微調整します。
7. 顧客向けの仕上げを加えます。 内部録画ではなく、実際の顧客向け成果物としての仕上げレベルで行い、また、それ以外は平坦なフレームの中にインセット動画が単独で置かれているだけの状態にしないようにします。
   • キーフレーム化されたタイトル、コールアウト、シェイプから構築したタイトルと補助テキスト。Clueso のデザインガイドで既定の構成要素とされているもので、静的に配置するのではなくインセットの周囲でアニメーションで入退場させ、インセットだけでなくフレーム全体がナレーションに合わせて動くようにします。
   • ナレーションの要点を伝えるキャプション。フレームに合わせてスタイル設定した、タイミング付きテキスト要素として構築します。ユーザーが代わりにナレーション全体のプレーンな字幕を望む場合は、エクスポート時に既定のスタイルで焼き込むことができます。どちらの意味かを確認します。
   • ナレーションが参照する特定のコントロールへのコールアウトやハイライト。画面に留まらせるのではなく、インセット自身のアニメーションと並んで表示されるようにタイミングを合わせます。 要素タイプを配置する前に、どのパラメーターに対応しているかを推測せずに調べます。音楽や効果音は入れません。音声はナレーションが担います。
8. マスクとカットを個別に検証します。 カットまたはマスクを行った各箇所で静止プレビューをレンダリングします。エンドツーエンドで 1 回通しで見るだけでなく、ステップ 2 のフラグ付き箇所リストと照らして 1 つずつ直接確認します。
   • マスクが漏らした、画面上の紛れ込んだフィールド。
   • ブラウザータブにまだ表示されている名前。
   • ウィンドウタイトル内のチケット番号。
   • 通知トースト内のメールアドレス。 別途、これら同じフレームで構図も確認します。インセットが同じフレームを共有するタイトルテキスト、キャプション、コールアウトと衝突していないこと、またフレームの端に何も詰め込まれていないことです。これは二次的な確認であり、上記のマスクのリストを緩めたり代替したりするものではありません。 このステップは安全上きわめて重要であり、あると嬉しいものではありません。壊れた、または信頼できないレンダリングは、このステップのブロッカーとして扱い、文字起こしやタイミングデータだけから推論して回避するものではありません。レンダリングが失敗した場合、あり得ない出力（例：要求したクリップやタイムスタンプに一致しない内容）を返した場合、その他の理由で信頼できない場合は、他の証拠によって目視確認が満たされたと見なしません。停止し、何を検証できて何を検証できなかったかを正確に報告し、動画をマスク未検証としてフラグ付けし、人間による目視確認を待ちます。顧客に提供できる状態としてエクスポートしないでください。
9. レビューしてからエクスポートします。 フラグ付きの各箇所が実際に検査したフレームによってすべてチェックオフされ、各クリップのナレーション音声が単に要求されただけでなく実際に存在することが確認されて初めて、レビューリンクを共有してユーザーの承認を得てから、特定の指定がない限り標準設定でエクスポートします。ステップ 8 がブロックされた場合でも、レビュー目的で有用ならエクスポートしてかまいませんが、検証済みとして提示するのではなく、その旨をレポートで率直に述べます。
10. 報告します。 プロジェクトリンクを返し、何をカットし、マスクし、書き直したかを要約して、依頼者が顧客に公開する前に自分で結果をスポットチェックできるようにします。検証がブロックされた、または不完全だった場合（ステップ 8 を参照）は、それを先頭に持ってきます。マスクの信頼性に関するギャップを要約の残りの部分の下に埋もれさせないでください。

フォールバック

• 必要な UI コンテキストを失わずに機密データを完全に除去するのは難しい - その場面全体をカットしないでください。機密領域（例: アカウント名のフィールドやヘッダー内のメールアドレス）の上にだけ墨消し要素を配置し、画面の残りの部分は表示したままにします。これにより、顧客向けの手順がそのまま保たれます。
• 解決策がその顧客のアカウント設定に固有で、一般化できない - 無理に一般化せず、そのまま伝えてください。その顧客の特定のプラン、構成、データだからこそ機能した修正を、一般に適用可能なものとして提示すると、他の顧客を誤導することになります。
• 明確な問題/解決の枠組みが存在しない - さらに作業を進める前に、サポートエージェントまたはユーザーに、一般的な問題と解決策を明確に述べてもらってください。録画だけから一般化を推測しないでください。
• ナレーションをほぼ全面的に録り直す必要がある - これはこのスキルでは想定内であり、何か問題が起きた兆候ではありません。手間を省くためだけに、元のチケット固有の音声を保持しようとしないでください。
• 録画がほぼすでにクリーンで、削除すべき名前が 1 ～ 2 個だけ - それでもステップ 8 の完全な検証パスを実行してください。フラグが付いた箇所のリストが短いからといって、チェックを省略してよい理由にはなりません。
• ユーザーが実際に求めているのは、録画を墨消ししつつそれ以外はそのままにすること（一般的なハウツーとして再構成することではない） - これは blur-sensitive-info スキルに近いものです。ここでより完全な一般化の作業を行う前に、どちらの結果を実際に求めているのかを確認してください。
• 録画の品質がそもそも再利用できないほど低い（音声が悪い、画面が切れている、手順が欠けている） - ソースがカバーしていない欠落をナレーションとビジュアルで埋め合わせようとせず、そのまま伝えてください。エージェントが欠落部分を録り直せるか、あるいは録画に実際に映っている内容だけに動画の範囲を絞れるかを尋ねてください。
• 1 回のセッションで実際に 2 つ以上の異なる問題を録画がカバーしている - 無理に 1 つのハウツーにまとめないでください。この点を指摘し、各動画が 1 つの一般的な問題と解決策に集中できるよう、問題ごとに別々の動画に分割すべきかどうかを尋ねてください。
• 1 つの連続した画面上の操作が複数のナレーションのビートにまたがり、ビートごとに 1 スライスへときれいに切り出せない - 1 ビートにつき 1 トリムという構造を無理に作るために、操作の途中で切らないでください。代わりに、その範囲をカバーする単一のインセットアニメーションの下に隣接するビートをまとめ、次の自然な区切りで再度分割してください。

完成した動画の共有

作業が完了したら、常に Clueso のプロジェクトへのリンクをユーザーに渡してください。エクスポートが完了したら、レンダリングされたファイルについてエディターの「エクスポート」タブを案内し、編集権限なしで共有するための閲覧専用リンクにも触れてください。これは、サポートチームによる公開前レビューのために動画を回覧する正しい方法です。動画が墨消し未検証としてフラグが付いた状態で出力された場合は、リンクのそばでそのことを改めて伝え、人による目視チェックの前に誰も公開しないようにしてください。決して「完了しました」だけで終わらないでください。最後のメッセージには、リンクと、出力の場所についての 1 行を含めてください。