[Skill 名] lark-vc

vc (v1)

重要 — 開始前に必ず Read ツールで ../lark-shared/SKILL.md を読み込んでください。認証、権限処理に関する情報が含まれています。

コアコンセプト

• ビデオ会議（Meeting）：飛書ビデオ会議インスタンス。meeting_id で識別されます。
• 会議記録（Meeting Record）：ビデオ会議終了後に生成される記録。キーワード、期間、参加者、主催者、会議室などの検索条件で会議室を検索できます。
• 会議紀要（Note）：ビデオ会議終了後に生成される構造化ドキュメント。紀要ドキュメント（要約、ToDo、章を含む）と逐字稿ドキュメントが含まれます。
• 妙記（Minutes）：飛書ビデオ会議の録画成果物またはユーザーがアップロードした音声/動画ファイルから生成されます。動画/音声の文字起こしと会議紀要をサポートし、minute_token で識別されます。
• 紀要ドキュメント（MainDoc）：会議紀要のメインドキュメント。AI が生成した要約と ToDo が含まれます。
• 逐字稿（VerbatimDoc）：会議の逐語的なテキスト記録。話者とタイムスタンプが含まれます。

コアシナリオ

1. 会議記録の検索

1. 終了した会議のみ検索をサポートしています。まだ開始されていない将来の会議については、lark-calendar スキルを使用する必要があります。
2. キーワード、期間、参加者、主催者、会議室などの検索条件のみで会議記録を検索できます。サポートされていない検索条件については、ユーザーにヒントを提示する必要があります。
3. 検索結果に複数のデータが存在する場合、ページネーションされたデータの取得に細心の注意を払い、会議記録を見落とさないようにしてください。

2. 会議紀要の整理

1. 紀要ドキュメントを整理する際、デフォルトで紀要ドキュメントと逐字稿のリンクを提示するだけでよく、紀要ドキュメントや逐字稿の内容を読み込む必要はありません。
2. ユーザーが紀要ドキュメント内の要約、ToDo、章の成果物を明確に取得する必要がある場合にのみ、ドキュメントを読み込んで具体的な内容を取得します。
3. スマート紀要（note_doc_token）の内容を読み込む際、紀要ドキュメントの最初の <whiteboard> タグはカバー画像（AI が生成した要約の視覚化）であり、ユーザーに表示するために同時にダウンロードする必要があります。

   # 1. 紀要内容の読み込み
   lark-cli docs +fetch --doc <note_doc_token>
   # 2. 返された markdown から最初の <whiteboard token="xxx"/> の token を抽出
   # 3. カバー画像を artifact ディレクトリにダウンロード（逐字稿と同じディレクトリに置き、成果物をまとめる）
   #    すべての紀要にカバーホワイトボードがあるわけではありません。<whiteboard> タグがない場合はスキップしてください。
   lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --output ./artifact-<title>/cover

   成果物ディレクトリの規範：同じ会議のすべてのダウンロード成果物（カバー画像、逐字稿など）は、artifact-<title>/ ディレクトリに統一して配置し、現在の作業ディレクトリに散らばらせないでください。

note_doc_token vs verbatim_doc_token — ユーザーの意図に応じて選択する2つの異なるドキュメント：

• note_doc_token → スマート紀要（AI 要約 + ToDo + 章）— ユーザーが「紀要」「要約」「ToDo」「紀要内容」と言ったときにこれを使用します。
• verbatim_doc_token → 逐字稿（話者とタイムスタンプを含む完全な逐語的なテキスト記録）— ユーザーが「逐字稿」「完全な記録」「誰が何を言ったか」と言ったときにこれを使用します。
• ユーザーの意図が不明確な場合は、ユーザーに代わって決定するのではなく、2つのドキュメントリンクを表示してユーザーに選択させるべきです。

3. 紀要ドキュメントと逐字稿のリンク

1. 紀要ドキュメント、逐字稿ドキュメント、および関連する共有ドキュメントは、デフォルトでドキュメント Token を使用して返されます。
2. ドキュメント名や URL などの基本情報のみを取得する必要がある場合は、lark-cli drive metas batch_query を使用して照会します。

   
   # コマンドの使用方法を学習
   lark-cli schema drive.metas.batch_query

ドキュメントの基本情報を一括取得: 一度に最大10個のドキュメントを照会できます。

lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'

3. ドキュメントの内容を取得する必要がある場合は、`lark-cli docs +fetch` を使用します。
```bash
# ドキュメントの内容を取得
lark-cli docs +fetch --doc <doc_token>

リソース関係

Meeting (ビデオ会議)
├── Note (会議紀要)
│   ├── MainDoc (主紀要ドキュメント)
│   ├── VerbatimDoc (逐字稿)
│   └── SharedDoc (会中共有ドキュメント)
└── Minutes (妙記)
    ├── Transcript (文字記録)
    ├── Summary (要約)
    ├── Todos (ToDo)
    └── Chapters (章)

注意：+search は終了した過去の会議のみを照会できます。将来のスケジュールを照会するには、lark-calendar を使用してください。

優先順位：ユーザーが過去の会議を検索する場合、calendar events search よりも vc +search を優先して使用すべきです。calendar の検索はスケジュールを対象とし、vc の検索は終了した会議記録を対象とし、参加者、主催者、会議室などの次元でフィルタリングをサポートしています。

ルーティングルール：ユーザーが「開かれた会議」「今日開かれた会議」「最近参加した会議」「終了した会議」「過去の会議記録」について尋ねる場合、vc +search を優先して使用します。将来のスケジュール、開催予定の会議、agenda を照会する場合にのみ、lark-calendar を優先して使用します。

特殊な状況：ユーザーが「今日の会議は何か」と尋ねる場合、vc +search で今日開かれた会議記録を照会し、同時に lark-calendar スキルを使用して今日まだ開始されていない会議を照会し、それらをまとめてユーザーに表示します。

Shortcuts（優先的に使用することを推奨）

Shortcut は、一般的な操作を高度にカプセル化したものです（lark-cli vc +<verb> [flags]）。Shortcut がある操作は優先的に使用してください。

API Resources

lark-cli schema vc.<resource>.<method>   # API を呼び出す前に必ずパラメータ構造を確認してください。
lark-cli vc <resource> <method> [flags] # API を呼び出します。

重要：ネイティブ API を使用する場合、--data / --params パラメータ構造を確認するために、まず schema を実行する必要があります。フィールド形式を推測しないでください。

meeting

• get — 会議の詳細（テーマ、時間、参加者、note_id）を取得します。

# 会議の基本情報を取得: 参加者リストは含まれません。
lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>"}'


# 会議の基本情報を取得: 参加者リストが含まれます。
lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participants": true}'

minutes（クロスドメイン、詳細は lark-minutes を参照）

• get — 妙記の基本情報（タイトル、期間、カバー）を取得します。紀要内容の照会には +notes --minute-tokens <minute-token> を使用してください。

権限表