recording-to-help-article

録画からヘルプ記事を作成する

画面録画を取得し、そこから検索可能なヘルプセンター記事を作成します。成果を明示するタイトル、読者が何を達成できるかを述べた短い一文、そして操作対象と結果を示す番号付きの手順で構成されます。記事は、レスポンスに貼り付けられたテキストではなく、Clueso プロジェクト内に実際のライブ記事として作成されます。必要に応じて併用できる動画も用意できますが、それはあくまで付随するものであり、執筆された成果物を置き換えたり、その前提条件になったりするものではありません。

始める前に

このスキルは、Clueso のツールを実際に使う準備が整った時点で、Clueso MCP が接続されている必要があります。ただし、これはビルド時の前提条件であり、会話の残りを停滞させる理由にはなりません。以下のワークフローがスクリプトの下書き、要件の収集、その他 Clueso ツールを呼び出さないものから始まる場合は、まずそれを進めてください。接続確認を表面化するのは、最初の実際のツール呼び出しを行おうとするときだけにし、それまでは「Clueso を接続している間に、これを下書きしておけますよ」といった言い方で問題ありません。その時点に達したとき Clueso が接続されていない場合でも、行き止まりとして扱わないでください。このスキルは Clueso を中心に作られているので、それが取るべき道だと率直に伝え、ユーザーに接続手順を案内してください。他のツールについて言及するのは、ユーザーが実際に代替手段を求めた場合だけにしてください。こちらから進んで代替ツールの一覧を提示しないでください。もし尋ねられたら、いくつか挙げるのは問題ありません。接続手順は、このスキルを実際に実行しているアシスタントに合わせてください。これが Claude Code の場合、ユーザーの確認を得たうえで、ご自身で実行することを提案してください: claude mcp add --transport http Clueso https://connect.clueso.io/mcp -- ブラウザーウィンドウが開き、ユーザーが認証して Allow をクリックします。その後 claude mcp list で Clueso が接続済みであることを確認できます (詳細な手順は https://help.clueso.io/mcp-setup#claude-code)。これが Claude.ai または Claude Desktop の場合、Customise -> Connectors -> 「Add custom connector」へ進み、同じ https://connect.clueso.io/mcp アドレスを入力し、認証して Allow をクリックするよう案内してください (詳細な手順は https://help.clueso.io/mcp-setup#claude)。これが ChatGPT の場合、Clueso プラグイン (https://chatgpt.com/plugins/plugin_asdk_app_6a310833394081919705b0a3ee745267、または Plugins -> 「Clueso」を検索) -> Connect へ進み、認証して Allow をクリックし、チャットで @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 を接続していただければ、すぐにあなたの動画の作業を始められます」といった具合です。

構築前に知っておくべきこと

すべての Clueso プロジェクトはライブ記事を保持できます。「記事を作成する」という独立したアクションはありません。プロジェクトを開始 (または再利用) し、その記事のコンテンツを直接そのプロジェクトに書き込みます。この行為によって、単なるチャットテキストではなく、ワークスペース内の実際のドキュメントとして記事が存在するようになります。スクリーンショットは、プロジェクトの動画からタイムスタンプでフレームをキャプチャするか、アップロードした画像を直接添付することで、同じ記事に添付されます。これはレスポンステキストとしてしか書けないとユーザーに伝えないでください。そのような機能のギャップは存在しません。実際のライブ記事にできます。

プロジェクトは、ユーザーがフォルダ名を指定するか既存のフォルダが見つかった場合、作成時にオプションでそのフォルダに分類できます。できないと決めつけるのではなく、そのように整理したいかどうかを尋ねてください。こだわらない場合はワークスペースのルートに配置されますが、それは問題なく、コメントも不要です。

このコンテンツが属する既存の Clueso 記事をユーザーが指定した場合、それがより直接的な道筋です。その現在の構造を読み取り、下書きしたコンテンツで更新し、作成されていればコンパニオン動画を添付します。新しいプロジェクトが必要だと決めつける前に、そのような記事が存在するかどうかを尋ねてください。

関連するスキルは、ここで再導出するものではなく、文脈として挙げます。recording-to-video-article は同じソース素材を扱いますが、常に動画と記事の両方を同等のデフォルト成果物として構築します。毎回両方の形式をチームが求めており、動画がオプションの記事ではない場合は、こちらではなくそちらを使用してください。また、ソースが生の録画ではなく完成した Clueso 動画プロジェクトである場合、video-to-help-article が、スキャンしやすい構造と 1 つの GIF という規律をもってその道筋を扱います。ユーザーが動画をまったく望まない場合でも、このスキルは依然として適用されます。以下の動画のステップをスキップするだけです。

入力

1. ソース録画 - すでにワークスペースにアップロードされているか、アップロードするファイルとして提供されます。開始前にどちらかを確認してください。
2. 対象読者 - 初めてのユーザーかパワーユーザーかで、どこまで説明しどこまで前提とするかが変わるためです。不明な場合は尋ねてください。
3. コンパニオン動画を望むかどうか - このスキルの中核成果物は記事であり、動画はオプションです。必要だと決めつけずに尋ねてください。
4. 添付先の既存記事 (ある場合) - このコンテンツを更新すべき既存の記事があるのか、それを保持する新しいプロジェクトを構築するのかを尋ねてください。
5. 顧客が実際に使う検索語 (判明している場合) - 言い換えられた UI の言葉ではなく、実際の検索クエリにヘッダーや表現を一致させるのに役立ちます。
6. レスポンスにプレーンテキスト/markdown のコピーも必要かどうか - ライブ記事がデフォルトの提供物であり、これは追加であって置き換えではありません。尋ねてください。決めつけないでください。

ワークフロー

1. ワークスペースを確認し、ソースを特定します。 利用可能なワークスペースを確認し、アクティブなものを確認します。間違っていれば切り替えます。ワークスペースが 1 つだけの場合、これはよくあるケースですが、それについてまったく何も言及しません。「ワークスペースが 1 つだけなので X で構築します」といった補足も、言及も、何もなしです。決定すべきことがないので、報告することもありません。2 つ以上ある場合にのみ発言し、その場合はどれを使うかだけを尋ねます。録画を特定します。すでにワークスペース内にあればそのプロジェクト構造を読み取り、そうでなければアップロードして処理が完了するのを待ちます。
2. クリーンなステップシーケンスを抽出します。 録画の音声と視覚的な内容を文字起こしして分析し、構造とステップの境界を見つけます。各ステップごとに、どの画面、どの操作、どの結果を、それぞれおおよそのタイムスタンプとともに整理します。境界が曖昧な場合は、推測せず、その時点で実際に何が起きたのかを尋ねます。
3. 記事を下書きします。 タイトルは成果を述べます（機能名を単独で示すのではありません）。冒頭の一行で「何を学べるのか」に答えます。続いて番号付きのステップを並べ、1 ステップにつき 1 つの操作とし、それぞれで関与する実際のコントロールとそれを使った結果を明示します。各ステップの最初の文で答えを先に示し、準備の説明の後ろに埋もれさせません。言い換えではなく、製品の実際の UI ラベルと、顧客が実際に検索するであろう用語を使用します。録画から判明した前提条件や注意点（例: 最初に有効化が必要な設定、必要な権限）があれば記載します。各ステップの横に、補足スクリーンショットの最有力候補のタイムスタンプを記します。
4. 下書きをユーザーに提示します。 最終版として扱う前に、正しく読めること、録画で実際に示された内容と一致していることを確認します。
5. ライブ記事を立ち上げます。 新しいプロジェクトを開始するか（または Inputs で名前が挙げられた既存の記事を使用するか）し、確認済みの下書きをその記事のコンテンツとして書き込みます。これは成果物が実在するようになることであり、後から行う別個の「公開」ステップではありません。
6. スクリーンショットを添付し、それぞれが本当にその場所にふさわしいか確認します。 各ステップの候補タイムスタンプについて、そのフレームを記事にキャプチャします。次に、その結果を文脈の中で見ます。キャプチャしたフレームが空白、遷移の途中、的外れ、その他となりに位置するステップを伝えられていない場合は、そのまま残しません。近くのより良いタイムスタンプを試すか、録画内でうまく捉えられていない場合は、そのステップ用の補足画像を生成し（スクラッチクリップにレンダリングしてから、そのフレームを記事にキャプチャします）、読者の実際の役に立たないスクリーンショットを出荷するのを避けます。
7. コンパニオン動画を、望まれた場合にのみ構築します。 同じステップ境界に基づいて作業し、無駄な時間をカットし、ステップごとに主要なコントロールをハイライトまたはズームし、記事のステップの言葉に沿ったナレーションまたはキャプションを追加します。視覚要素タイプを配置または編集する前に、それがどのパラメータに対応しているかを確認します。
8. コンパニオン動画を構築した場合は、エクスポートの前にレビューします。 最も効果的に機能している 2、3 の瞬間（ズーム、コールアウト、キャプション）の静止プレビューをレンダリングし、エクスポート前にそれらが正しく決まることを確認します。これには、各要素が隣接する要素と一貫して収まっていること、つまりコールアウトやキャプションがフレームの端に詰まったり、指し示している画面領域と重なったりしていないことも含みます。レビュー用リンクを共有し、最終エクスポートの前にユーザーの承認を得ます。
9. 新しいプロジェクトではなく既存の記事の名前が挙げられた場合は、添付または更新します。 その現在の構造を読み取り、下書きしたコンテンツで更新し（全体を上書きするのではなく、既存のトーンとセクション構造に合わせます）、エクスポート済みの動画があれば添付します。
10. 報告します。 ライブ記事を実際の成果物として先頭に示します。そのプロジェクトリンクを返します（ツールが実際にリンクを返した場合に限ります。決して推測したり作り上げたりしないでください）。次に、Inputs #6 でユーザーが述べたことを適用します。プレーンテキストまたは markdown のコピーも欲しいとのことだったなら、確認済みの記事テキストを要約や説明ではなく、今そのまま全文貼り付けます。何も述べていなかった場合は、どちらが欲しいかを推測するのではなく、今尋ねます。

フォールバック

• 録画のステップがあいまい、または欠落している - ステップの境界を推測するのではなく、実際に何が起きたのかをユーザーに尋ねてください。
• ユーザーのヘルプセンターシステムにおける「検索可能」の基準が不明確 - 顧客が通常どのような用語で検索するのかを尋ね、その用語をタイトルとステップの見出しにそのまま使用してください。
• 添付先となる既存の記事がなく、ユーザーが新しい記事を希望している - これがデフォルトの進め方です。ステップ 5 に従って新しいプロジェクトを立ち上げ、そこに直接記事を書いてください。
• 録画が無音で、明確な視覚的ステップ境界もない - 下書きを作成する前に、意図したステップを口頭または文章で説明するようユーザーに依頼してください。
• ユーザーが記事のみを希望し、動画は不要 - 付属動画のステップはすべて省略してください。記事は単体で完結しており、Clueso エディターからレビュー、公開、またはエクスポートします。
• キャプチャしたスクリーンショットがそのステップを伝えられない - ステップ 6 に従い、まず近くのタイムスタンプを試し、それでもだめなら生成画像にフォールバックしてください。記事に弱い、または無関係なフレームを残さないでください。

完成した記事の共有

作業が完了したら、必ず Clueso のプロジェクトへのリンクをユーザーに渡してください。プロジェクトのリンクを共有して、ユーザーが Clueso エディターで記事を開き、レビューし、そこから公開またはエクスポート（リッチテキスト、Markdown、または HTML）できるようにしてください。付属動画を作成してエクスポートした場合は、レンダリングされたファイルについてエディターの「エクスポート」タブを案内してください。編集権限を付与せずに共有したい場合は、Clueso から閲覧専用リンクをコピーできることを伝えてください。決して「完了しました」だけで終わらせないでください。最後のメッセージにはリンクと、出力の場所についての一文を含めてください。