video-to-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 を接続していただければ、すぐにあなたの動画の作業を始められます」のように。

このスキルを使う場面

ソフトウェアを使用している画面収録の場合は、姉妹スキルである video-to-help-article を使用してください。そちらは番号付きの UI 手順とコントロール名を中心に作られており、この種のソース素材には合いません。コンテンツ系に見えた動画が実際にはソフトウェアの操作解説であった場合は、このスキルの構造を無理に当てはめるのではなく、そちらへ誘導してください。

基本ルール

すべての Clueso プロジェクトには、直接書き込めるライブ記事の側面があります。記事のコンテンツをプロジェクトに書き込むことが、それを実際のドキュメントとして存在させる所以であり、返信の中に残されたテキストではありません。フレームは、プロジェクトの動画からタイムスタンプでキャプチャするか、アップロードした画像を直接添付することで、同じ記事に紐付けられます。

実在する企業や人物の肖像、ロゴ、実際のデータを想像で捏造しないでください。何かが実在のものとして提示される場合は実際のスクリーンショットと実際の映像のみを使用し、生成されたものはすべて、動画が明確に捉えきれなかった特定の実在コンテンツについての主張ではなく、例示として読めるものでなければなりません。

入力

1. ソース動画 - ユーザーに確認してください。すでに Clueso プロジェクトになっているのか（名前またはリンクを挙げてもらう）、あるいはこれからアップロードする生の録画なのか。それに応じて分岐します。
2. それがソフトウェアの操作説明ではなく、コンテンツであることを確認します。 誰かが製品の UI を手順を追って実演している場合は、いったん止めて video-to-help-article のほうを案内してください。曖昧なときは推測せず、質問してください。
3. 目標とする長さと深さ - 簡潔な要約か、より充実した扱いか。不明確なら確認してください。本文に含めるビートの数が変わります。
4. これを統合する既存の記事があるなら、その記事。
5. 返信にプレーンな Markdown のコピーも希望するかどうか - 公開記事が既定の成果物であり、これは追加のものです。想定せずに、質問してください。

何かを作成または編集する前にワークスペースを確認してください（ワークスペースが 1 つだけの場合は黙って確認します）。

ワークフロー

1. ソースを特定し、コンテンツの種類を確認する

動画がすでにワークスペースにある場合はプロジェクトを読み込み、そうでなければアップロードして処理が完了するまで待ちます。これが情報提供やコンテンツの素材であり、UI の操作説明ではないことを確認できる程度に視聴・分析してください。後者である場合は、それ以上の作業を行う前に、ただちに姉妹スキルのほうへ誘導します。

2. 論証の構造を抽出する

動画を文字起こしして分析し、その実際の骨格をつかみます。テーゼやつかみ、提示される順序どおりの補足的な論点やセクション、何らかの転換や反論、そして結論です。これは手順のリストではなく、その動画が実際にどのように主張や説明を組み立てているかです。画面上に本当に有用なもの（グラフ、ラベルの付いた図、実際の比較、実演されている物体）が現れる瞬間があれば、そのタイムスタンプを記録してください。それらは後の実際のキャプチャの候補になります。

3. 記事の下書きを作成する

タイトルはトピックだけでなく核心的な要点を示します（「プロテインパンについて」ではなく「『高タンパク』パンがしばしばそうではない理由」）。冒頭に 1 行の枠組みとなる文を置きます。本文はステップ 2 のビートごとに構成します。論点や転換ごとに 1 つのセクションを設け、それぞれを一般的な埋め草ではなく、動画の実際の主張と論理に沿って述べます。最後に結論を置きます。読者が今実際に何をすべきか、あるいは何を考え方を変えるべきかです。動画の実際の用語と具体的な内容を用いてください。実質を曖昧な一般論へとならしてしまわないようにします。

何かビジュアルを作成する前に下書きをユーザーに見せてください。実質を修正するのに最も安く済む時点です。

4. 公開記事を執筆する

確定した下書きを、そのプロジェクトの記事コンテンツとして書き込みます（または入力 #4 でユーザーが挙げた既存の記事に統合します）。

5. ビジュアルを追加する：まず実物、実物が合わないところでは生成

各セクションについて：

• ステップ 2 でその論点に対応する実際の画面上の瞬間に印を付けていたなら、そのフレームをキャプチャしてセクションに配置します。次に文脈の中で確認します。本当にその段落が述べていることを伝えているか、それともたまたま存在しただけのフレーム（トーキングヘッドのショット、切り替え中のぼやけた映像、的外れなもの）ではないか。その場所にふさわしくない場合は、削除するか、近くのタイムスタンプを試してください。
• 動画の中にそのセクションの論点を視覚的に伝えるものが何もない場合、または上記の確認で実際のフレームがふさわしくないと判明した場合は、代わりにそれを補助する画像を生成して添付します。動画自体がその特定のものを実際に映していない限り、特定の現実の主張に見えるもの（実在の製品、実在の人物、数値入りの実在のグラフ）よりも、清楚なイラスト的または概念的な扱いを優先してください。
• 画像がまったくなくてもよいセクションもあります。すべてのビートに無理に画像を当てはめないでください。

6. レビューと引き渡し

記事のリンクを共有し、ユーザーに読みを確認してもらいます。各セクションは動画が実際に主張していたことを述べているか、ビジュアルはその場所にふさわしいか。修正を適用します。次に、入力 #5 でユーザーが納品について述べたことに従います。コピーも希望していたなら、確定した記事本文を Markdown として返信に全文貼り付けます。まだ何も述べていなかった場合は、ここで確認してください。

フォールバック

• ソフトウェアのウォークスルーであり、コンテンツではないと判明した場合 - video-to-help-article にリダイレクトしてください。このスキルの引数構造をウォークスルーに無理やり当てはめないでください。また、コンテンツに番号付きの手順構造を無理やり当てはめないでください。
• キャプチャする価値のある実際の画面上の瞬間がどこにもない場合 - 手順 5 の生成された挿絵画像だけに完全に頼ってください。これはトーキングヘッド形式のコンテンツでは通常の結果であり、謝罪すべき欠陥ではありません。
• 動画が曖昧なことを主張している、または自己矛盾している場合 - 一つの解釈を選んでそれを確定したものとして提示するのではなく、意図する要点を明確にするようユーザーに尋ねてください。
• 動画が長すぎる、またはまとまりがなく、一つの簡潔な記事に収まらない場合 - すべてを浅くざっと見るのではなく、最も強い一つの切り口に絞るか、短いシリーズに分割することを提案してください。
• 生成された画像がおかしく表示される、または的外れな場合 - より具体的なプロンプトで再生成するか、そのセクションがテキストだけで問題なく読める場合は削除してください。

完成した記事の共有

作業が完了したら、必ず Clueso のプロジェクトへのリンクをユーザーに伝えてください。プロジェクトのリンクを共有して、ユーザーが Clueso エディターで記事を開き、レビューし、そこから公開またはエクスポート (リッチテキスト、Markdown、HTML) できるようにしてください。編集権限を付与せずに共有したい場合は、Clueso から閲覧専用リンクをコピーできることを伝えてください。最後を単に「完了」で終わらせないでください。最後のメッセージにはリンクと、出力がどこにあるかの一行を含めてください。