Video Meeting Minutes

Video Meeting Minutes

概要

video-meeting-minutesはuv tool install --editableでグローバルインストール済みのCLIで、どのディレクトリからでも実行できる（uv runやcdは不要）。このskillは、会議動画から議事録を作る運用手順と、再実行用の薄い補助scriptをまとめたもの。

実装本体（ソースと再実行用script）は次のrepoにある。エディタブルインストールなので、ここのコードを編集すればグローバルコマンドにも即反映される。

/Users/mk/Developer/video-meeting-minutes

実行ファイルの場所:

~/.local/bin/video-meeting-minutes

~/.zshrcにラッパー関数vmmが定義済みで、repoの.envを読み込んでからグローバルCLIを起動する。インタラクティブシェルではvmmを使うのが基本。

# ~/.zshrc に定義済み
vmm() {
  set -a && source /Users/mk/Developer/video-meeting-minutes/.env && set +a
  video-meeting-minutes "$@"
}

安全ルール

• .envの中身やAPIキーは表示しない。env読み込みはsourceで行い、cat等で中身を出さない。
• ユーザーが明示しない限り、.env、入力動画、.DS_Store、生成済みのoutput/成果物はcommitしない。
• vision/frame_analysis.jsonやminutes.mdを上書きする前に、同じディレクトリへタイムスタンプ付きbackupを作る。
• 補助script（再実行）は対象repo内でuvを使う。
• 直接使う外部文字起こしAPIはElevenLabsだけ。フレーム解析と議事録生成はCodex app-server経由で行う。

前提

• グローバル実行にはELEVENLABS_API_KEY等のenvが必要。APIキーの実体はrepoの.envの1ヶ所だけに置く（~/.zshrc等へ複製しない）。

• vmmはenv読み込みを自動で行う。vmmが使えない環境（非インタラクティブシェル、スクリプト内など）では、素のコマンドの前にrepoの.envを読み込む:

  set -a && source /Users/mk/Developer/video-meeting-minutes/.env && set +a
  video-meeting-minutes path/to/meeting.mp4
  

• Codex側はcodex login済みであること。

• ffmpeg / ffprobeが利用可能であること。

デフォルト設定

• 文字起こし: ElevenLabs Scribe v2、ELEVENLABS_SCRIBE_MODEL=scribe_v2
• 話者分離: デフォルトON。ユーザーが求めた場合だけ--no-diarizeで無効化する。
• フレーム解析: Codex app-server、CODEX_VISION_MODEL=gpt-5.5、CODEX_VISION_EFFORT=high
• 議事録生成: Codex app-server、CODEX_MINUTES_MODEL=gpt-5.5、CODEX_MINUTES_EFFORT=xhigh
• 議事録テンプレート:
  • 参加者
  • 決定事項
  • TODO
  • 発言要旨
• TODOはMarkdown表にし、5W1Hが分かる粒度で書く。
• 発言要旨は時系列ではなくトピック別にする。時間は書かない。各トピックは論点、参加者の意見、結果で整理する。

フル実行

どのディレクトリからでも実行できる（env読み込みはvmmが自動で行う）。

vmm path/to/meeting.mp4

よく使う派生:

vmm path/to/meeting.mp4 --keyterms 勤怠管理 受給者証 事業所 ヘルパー 監査ログ ログインID
vmm path/to/meeting.mp4 --no-diarize
vmm path/to/meeting.mp4 --skip-vision --skip-minutes

出力先を固定したい場合は--output-dirに絶対パスを渡す:

vmm path/to/meeting.mp4 --output-dir /Users/mk/Developer/video-meeting-minutes/output

出力場所

--output-dir未指定時は、コマンドを実行したカレントディレクトリのoutput/配下に作られる。

<実行したディレクトリ>/output/<動画名>_<YYYYMMDD_HHMMSS>/
  audio/<動画名>.m4a
  frames/frame_*.jpg
  transcript/elevenlabs_scribe_v2.txt
  transcript/elevenlabs_scribe_v2.json
  vision/frames.json
  vision/frame_analysis.json
  manifest.json
  minutes.md

実行ごとにタイムスタンプ付きディレクトリが作られるため、上書きされない。実行完了時にSaved minutes: <フルパス>が表示される。実行後は、少なくとも次のパスを報告する。

• minutes.md
• transcript/elevenlabs_scribe_v2.txt
• vision/frame_analysis.json
• manifest.json

フレーム解析だけ再実行

フレーム解析プロンプトを変更した時、またはユーザーが画像解析だけの再実行を求めた時に使う。音声文字起こしは再実行しない。ユーザーが求めない限り議事録も再生成しない。

補助scriptはrepoの.venv内のパッケージを使うため、repo内でuv runする。

cd /Users/mk/Developer/video-meeting-minutes
uv run python /Users/mk/Developer/codex-skills/skills/video-meeting-minutes/scripts/reanalyze_frames.py \
  --run-dir output/<run-dir>

この補助scriptはvision/frames.jsonを読み、既存のvision/frame_analysis.jsonをbackupしてから、同じパスへ詳細なフレーム解析を再生成する。

議事録だけ再生成

議事録プロンプト、TODO構造、フレーム解析を変更した後に使う。音声文字起こしやフレーム解析は再実行しない。

cd /Users/mk/Developer/video-meeting-minutes
uv run python /Users/mk/Developer/codex-skills/skills/video-meeting-minutes/scripts/regenerate_minutes.py \
  --run-dir output/<run-dir>

この補助scriptは次を読む。

• transcript/elevenlabs_scribe_v2.json
• vision/frame_analysis.json

既存のminutes.mdをbackupしてから、同じパスへ議事録を再生成する。

出力確認

生成された議事録では次を確認する。

• 見出し: テンプレートの主要セクションになっていること。
• TODO: Markdown表で、トピック、担当者、対象画面/機能、作業内容、理由・背景、期限が明確なこと。
• 発言要旨: トピックごとの###小見出しがあり、時間表記がなく、各トピックが論点、参加者の意見、結果で整理されていること。
• 挨拶、謝意、画面共有の段取り、単なる相づちのような参照価値の低い会話が入っていないこと。

よくある追加対応

• フレーム解析が浅い場合は、video_meeting_minutes/codex_tools.pyのフレーム解析プロンプトを修正してから「フレーム解析だけ再実行」を行う。エディタブルインストールなので再インストール不要で反映される。
• 議事録の構造が悪い場合は、video_meeting_minutes/codex_tools.pyの議事録プロンプトを修正してから「議事録だけ再生成」を行う。
• 話者分離が必要な場合は、フル実行でデフォルトのdiarize ONを使う。明示するなら--diarizeを付ける。
• vmm: command not foundの場合は、~/.zshrcのvmm関数定義を確認するか、新しいシェルを開く（または前提セクションの素のコマンド＋env読み込みで代替する）。
• video-meeting-minutes: command not foundの場合は再インストール:

  cd /Users/mk/Developer/video-meeting-minutes
  uv tool install --force --editable . --python 3.11 --python-preference only-managed
  

• pyproject.tomlの依存を変更した時も、上記--forceで入れ直す（ソース編集だけなら不要）。