tk-video

動画で説明する

観察したソフトウェアの状態、または説明用カードとして明示的にラベル付けされたものから、選択した MP4 または GIF を作成します。既存動画の編集や、無関係な映像制作はこのスキルの対象外です。動画は一連の流れを伝えるものであり、アプリケーションの正しさ、レイテンシ、パフォーマンス、読者の理解度を証明するものではありません。

計画と素材の収集

対象者、主張、選択する形式、利用可能なシーン素材を確定します。動きそのものが主張でない場合は、静止画を優先します。10秒前後の短い流れには GIF が適していることが多く、より長い説明には MP4 が適しています。提供された素材と承認済みの選択肢を再利用し、定型的な質問を繰り返さないでください。人向けのチュートリアルでは、ナレーションとカーソル／入力オーバーレイがまだ選択されていない場合に限り、既存の選択肢の中で形式とともに確定します。字幕には読み上げ時間を確保し、計測したナレーションには少なくとも800msの余裕を持たせます。ズームインする前に、各クロップとハイライトの範囲を計画します。

各シーンについて、素材、字幕、任意のナレーション、表示時間または観察したタイムスタンプを一覧にします。レンダリングしたカードには、対象者の言語による隅のソースタグを付け、タグを付けた各フレームで source_in_picture: true を宣言します。それ以外の場合は、ローカライズした字幕ラベルを残します。利用できないソフトウェアの動作を再現したり、図をキャプチャとして提示したりしないでください。主張、ソースのバージョン、未検証の区間を明示します。実際のブラウザー状態については、受け入れ基準のないデモや説明なら phase: media-capture を指定して tk-browser-verify を呼び出します。明示的に依頼された受け入れ確認では検証契約を維持し、必要に応じて動きの証拠を追加します。ネイティブウィンドウには tk-app-verify を呼び出します。これらの担当スキルが、プロバイダー、認証、テストデータ、実際の入力／キャプチャ、リソースのライフサイクルを引き続き管理します。順序付けされ、公開に適したフレームのパスと来歴をそろえてから、このスキルに戻ります。隣接するスキルのスクリプトパスをインポートしないでください。担当スキルを利用できない場合は、不足しているキャプチャを報告し、代替を作り出さないでください。

すでに利用可能なレンダラーでカードを作成し、作成元のソースを保持します。HTML カードでは、すでに承認済みのヘッドレスレンダリング環境を使用できます。インストール済みのプロット／レンダリングツールも利用できます。動画を選んだことを理由に、依存関係をインストールしたり、ユーザープロファイルを添付したりしないでください。

組み立てと確認

シーン／キャプチャのマニフェスト、管理対象パス、コマンドについては、組み立てを読んでください。プレゼンテーションには explainer の表示時間を使用し、evidence モードでは実際のタイムスタンプを保持します。アサーション用スクリーンショットは変更せず、動画とは独立したままにします。キャプチャのフレームレートを維持し、上限を30fpsとした H.264 MP4 を使用し、任意でモノラル48kbps AAC を追加します。GIF と explainer の静止画は、デフォルトで10fpsです。MP4 の CRF はデフォルトで18です。アセンブラーの品質／レート上書きを使用し、ソース解像度を保持します。利用できないツールについては、前提条件の復旧手順に従います。 インストール済みツールを確認してもハード字幕に対応できない場合は、ブロックされた結果を返す前に tk-wizard のインストール案内に関する質問を提示します。フレームを合成する回避策を実装しないでください。

選択された生成ナレーションには、サポートされているスキルの読み込み／引き継ぎを通じて tk-tts を呼び出します。計測した音声とシーンの同期については、ナレーションを読んでください。選択された場合は、提供された音声を再利用します。組み立て処理が読み込むのは通常の WAV ファイルで、TTS エンジンはインポートしません。TTS を選択した場合は、実際に受け入れられる無音ではない音声が必要です。音声合成ができない場合、ナレーション付きの無音プレビューで代用しないでください。

完成したメディアのチェックを実行し、生成されたコンタクトシートと、初期／最終状態および重要な字幕やシーンの切り替わりを含む代表的なデコード済みフレームを確認します。ナレーションを選択した場合は、確認対象の名称／番号／用語と関連するサンプルパスを添えて human_action: listen を返します。ユーザーが意味、発音、音切れを確認するまで、保留状態のままにします。デコードに成功しても、映像や発音を確認したことにはなりません。未確認の区間を区別し、実際の制約を報告します。不備のあるカットは修正し、影響を受けるチェックを再実行します。動画を合格させるために、レシートを編集してはいけません。

返却

すぐに使えるメディアと、その絶対パス、モード／タイミング、ソース、キャプション／音声の状態、メディアチェック、確認の制限、公開するものの選択を返します。品質上のブロックまたは失敗は、アプリケーションの検証結果とは分けて報告します。ハードキャプションに対応していない場合は、ソフトキャプションの代替を維持し、焼き込みキャプションが完成したとは主張しません。入力と失敗の証跡は保持します。既知の所有対象一時ファイルをクリーンアップするのは、ユーザーが選択した結果を確認し、そのデコード／確認が完了した後に限ります。それまでは再利用可能なフレーム／音声／マニフェストを保持し、保持したフレームのバイト数を報告します。キャプチャリソースは、それを所有する検証ツールを通じて解放します。

生成の許可は、公開の許可を意味しません。アップロードが別途許可された場合に限り、選択した添付ファイルを tk-pr-media に渡します。このスキルはアプリケーションのソース、Git の状態、グローバル設定、認証情報を変更しません。作成するのは、依頼された動画、シーンのソース、実行所有の証跡、および選択した音声アーティファクトのみです。別途承認されたインストールとモデルキャッシュは tk-tts が管理します。

デザインのソースと意図的な省略事項はソースに記録されています。

ナレーションの選択

動画または音声付きスライドの制作を始める前に、TTS、提供済み音声、ナレーションなしのいずれかを制作者に選んでもらいます。親ユーザー／ユーザーがすでに回答した選択は再利用します。動画の依頼や音声に関する希望は、TTS の同意を意味しません。合成／組み立ての前に、現在の tk-tts のモデル／音声／デバイス／セットアップの選択肢を示します。ナレーションなしの選択を尊重し、GIF の音声には MP4 を提案します。静的な HTML／テキストには、無関係な音声についての聞き取りは必要ありません。インストール／ダウンロード／公開にはそれぞれ個別の許可が必要です。再生時のミュート／フォールバックは別の扱いです。

アーティファクトのパス

アーティファクトの作成にはタスクの許可が必要です。書き込み／チェックアウト／転送／除外設定を行う前に、Git の除外／パス／所有権の確認についてアーティファクトのパスを読みます。同一の内容が現在のコンテキスト内にあれば再利用し、不確かな場合はハッシュを確認して変更や消失を読み直し、安全性は必ず再確認します。保存先が明示されていない場合は .tigerkit/ を使います。チャットのみの場合は、ファイル／除外設定とこの参照の確認を省略します。これは無関係な変更や公開の許可を与えるものではありません。許可された秘密情報を含まないクリーンアップには、新規ディレクトリとサポートされているゴミ箱を優先します。対象にするのは、記録済みの文字どおりの解決済み絶対パスのうち、実行所有のものだけです。cd と glob／相対パスによる削除は決して行いません。

ユーザーへの質問

事実を調べ、既存の許可を再利用します。ユーザー所有の判断が必要な場合は質問ラウンドを読み、それ以外はそのまま進めます。 プレーンなチャットでは、承認が1件だけの場合も、単独行の --- の後に、各項目を ❓ **Q<n> · <title>**: <question> と ➡️ <recommendation> の形式で示します。 前提条件が確定した質問だけを尋ね、承認とは分けます。 質問は最後に置き、ステータス、リスク、計画はその前に記載します。

スキルへのフィードバック

再利用可能なインシデントについては、機密情報を含まない最小限の証跡を現在の会話に残し、tk-retro を提案します。ユーザーから依頼されない限り、永続メモリには書き込みません。 起動、フィードバックアーティファクト、インストール済みスキルの編集、公開には、それぞれ管理元のワークフローを通じた個別の許可が必要です。この案内は許可を与えるものではありません。

読者向けの結果概要

結果、実際に行った検証、重要な制限事項、成果物への直接リンクを含む簡潔な概要を返します。計画や省略したチェックと、実施した作業を区別します。未完了の手動確認、実際のクリーンアップ、ブロッカー、人手による対応の詳細は保持します。未検証の完了やクリーンアップを主張してはいけません。所有者が求めるアーティファクト、公開プレビュー、承認の境界、マシンへの返却、正確なステータス／フッター、最後の質問ブロックを保持します。入れ子になった返却は簡潔にし、内容のないセクションは省略します。

出力表記

括弧付きやキーキャップ数字ではなく、ASCII の番号（1. 項目、(1) 項目）と - 項目 を使用します。 例を含め、完全な絶対パスをクリック可能な形で示し、省略記号は使用しません。 編集が許可されていない限り、コード、コマンド、識別子、URL、引用、確認済みの UI ラベルは正確に保持します。

複数の共通属性を比較するチャットでは、列を絞った GFM パイプテーブル（約 4 列、ヘッダーあり、各セルは簡潔に）を使用し、それ以外ではリストを使用します。ボックス描画、フェンス付き、空のテーブルは使用しません。所有者固有のプレビューが優先されます。公開用本文とファイル成果物では、それぞれ独自のテーブル形式を保持します。

レンダリングされる Markdown の本文では、範囲にハイフンを使用し、リテラルのチルダは \~ としてエスケープします。コード、引用、識別子は正確に保持します。

許可された一時入力ファイルについては、作成および使用の前に Artifact Paths に従います。あらかじめ入力されたテンプレートは、入力済みのファイルではありません。これは書き込み権限を付与するものではありません。