ビデオを見る — 理解のため、ファイル整理のためではない
誰かがビデオを共有し、あなたにそれについて質問します。2つのフックがそれを可能にしますが、どちらも単独では発見できません — フックには意味的なマッチングがなく、「これを見て」と依頼されたセッションは何も見つけられず、即興で対応することになります。このスキルが存在する理由はまさにそのギャップです。
境界 — これを最初に読んでください
このスキルは「視聴」します。「ファイリング」はしません。 その出力は セッション内で保持される理解 であり、保管庫のアーティファクトではありません。メモ、フロントマター、相互リンク、
_indexの更新、アクションアイテムのルーティングは一切行いません。作業ファイルはスクラッチパス(/tmp)に置かれ、決してvault/に書き込まれません。
/aios:ingestはファイリングパイプラインです — これは、ソースを恒久的で相互リンクされた保管庫ノートに変換することを意図的な行為と規約にするために存在します。オペレーターがそれを望む場合は、引き継いでください(「これを/aios:ingestしてreflections/ingests/に相互リンク付きで配置しますか?」)— ここで中途半端に実装しないでください。2つのパス、1つの境界、重複はありません。
したがって、実行の流れは次のようになります:コンテキストに取り込む → 依頼されたことを実行する → 提案する、前提としない。 依頼がオープンエンド(質問なしで「これを見て」)の場合は、視聴した後、2〜3行で内容を説明し、何を求めているか尋ねてください。誰も依頼していない成果物を作り出さないでください。
どのツールを使うか — 実際の判断基準
| ソースの種類 | 使用するツール | 理由 |
|---|---|---|
| ドキュメント(PDF、docx、スライド、スプレッドシート) | MarkItDown または document-skills | このスキルの担当ではありません。これらはすでに意味的にマッチングされます |
| 長尺音声/動画、音声だけで十分 | hooks/transcribe.py | MarkItDownは音声をGoogle Web Speechに単発送信します — 一文には使えますが、49分のインタビューには役に立ちません |
| YouTube、音声だけで十分 | 最初にMarkItDownのキャプションを試す | 文字起こしよりもはるかに高速。キャプションがない、または品質が低い場合のフォールバックとして transcribe.py を使用 |
| 画面に信号が含まれている | トランスクリプトに加えて hooks/video-watch.py を使用 | トランスクリプトはすべてのフレーム(スライド、コード、図表、ターミナル、チャート、画面上のテキスト)を破棄します |
画面に信号が含まれるのは、ソースがスライド付きのトーク、スクリーンキャスト、コードウォークスルー、ツールデモ、図解入りの講義、または「ご覧のとおり」と言われたら見えないものがある場合です。迷ったら確認してください — ビジュアルパスには実際に時間がかかります。
コマンド
# トランスクリプトの基盤(オンデバイス:ffmpeg → mlx-whisper large-v3-turbo、任意の長さ)
python3 ~/aios/hooks/transcribe.py <ファイルまたはURL> /tmp/watch-transcript.txt
# ビジュアルチャネル、トランスクリプトに重ねて使用 — 決してトランスクリプトの代わりにはしない
python3 ~/aios/hooks/video-watch.py <ファイルまたはURL> \
--transcript /tmp/watch-transcript.txt --reader ocr --code
リーダーの選択が唯一の重要なフラグ判断です:
--reader ocr— Apple Visionによる画面上のテキストをそのまま取得します。スライド、コード、ターミナル、正確に引用する必要があるもののデフォルト。 フレームにコードが含まれる場合は--codeを追加します。--reader vlm— Claude Visionが各フレームを説明します。図、チャート、アーキテクチャ、UI向け — 文字通りのテキストよりも構造を重視します。--reader both— 正確な単語と画像の意味の両方が必要な場合。フレームあたりのコストが約2倍になります。
その他のオプション(--scene-threshold、--max-frames、--sample-every、--max-width、--phash-threshold)には適切なデフォルト値があります。最初のパスが明らかに少なすぎる、またはノイズが多い場合にのみ調整してください。--help で一覧を表示できます。
プラットフォームの現実 — 実行する前に伝える
両方のフックは macOS / Apple Silicon 向けです(mlx-whisper、hooks/ocr-image.swift によるApple Vision)。LinuxまたはWindowsの場合は、その旨を伝え、MarkItDown にフォールバックします。MarkItDownはYouTubeのキャプションと短い音声をクロスプラットフォームで処理できます。オペレーターにコマンドの失敗を見せてこれを学ばせないでください。
時間をかける前に期待値を設定する
長い録音の文字起こしとフレームの読み取りは 秒ではなく数分 かかります — 45分のトークにビジュアルパスを追加するのは、このスキルで最も負荷の高い処理です。事前に見積もりを伝え、確認を取ってください。特にビジュアルパスについては。力技よりも効果的な2つの簡単な方法:
- 常に最初にトランスクリプトを取得する。 これが意味の基盤であり、より高速で、しばしば質問に直接答えられます。その場合、ビジュアルパスは不要です。
- 依頼が狭い場合(「彼女は価格について言及していますか?」)、全体を読み返すのではなく、トランスクリプトを検索します。
知っておくべき障害モード
- トランスクリプトはビデオではありません。 オペレーターが表示されたものについて質問した場合、それについて言及のないきれいなトランスクリプトは存在しないことの証拠ではありません — 間違った道具を使っているのです。ビジュアルパスを実行するか、まだ答えられないと伝えてください。
- YouTubeのキャプションは自動生成で間違っている可能性があります(名前、専門用語、数字)。引用が重要な場合は、
transcribe.pyで検証してから帰属させてください。 - 読んでいないものを引用しないでください。 フレームはシーンチェンジでサンプリングされ、重複除去されるため、ビジュアルパスは サンプル であり、完全な記録ではありません。主張が1つのフレームに基づく場合は、そのタイムスタンプを明記してください。
- スクラッチファイルはスクラッチです。 処理が終わったら
/tmp/watch-*をクリーンアップするか、どこに残したかを伝えてください。決してvault/に書き込まないでください。
引き継ぎ
マテリアルを保存する価値があると判明した場合:
- 適切にファイルする →
/aios:ingest(reflections/ingests/に{source}-{slug}という命名、フロントマター、相互リンク、アクションアイテムはプロジェクトのToDoにルーティングされます)。 - プロジェクトの状態を変更した場合 → その旨を伝え、プロジェクトノートを更新するよう提案します。
- 永続的な洞察が得られた場合 → それは通常のセッション終了パスを介して保管庫に属するものであり、何かを視聴した副作用としてではありません。
視聴は安価で繰り返し可能です。ファイリングは判断を伴います。この2つは分離してください。