AgentSkillsCN

vc-plan-llm

利用 LLM 生成或更新 plan.yaml 文件，并将其反映到 vc run 中。

SKILL.md
--- frontmatter
name: vc-plan-llm
description: LLM で plan.yaml を生成/更新し vc run に反映
metadata:
  short-description: LLM 編集プラン生成

vc-plan-llm

LLM で plan.yaml を生成・更新し、vc run に反映するためのスキルです。

このスキルを使うタイミング

  • •ユーザーが「編集プランを自動生成したい」と言った
  • •--prompt で LLM を使いたい
  • •work/plan.yaml を作りたい/更新したい
  • •packages/plan を利用する必要がある

重要: LLM 出力のルール

  • •出力は YAML のみ
  • •version, prompt, outputs.horizontal, outputs.vertical を含める
  • •outputs.*.clips[] は id, startSec, endSec, label を持つ
  • •ユーザーが「ショート動画」を希望する場合は 90秒程度を推奨する
  • •segmentIds を使う場合は transcript_segments.json の id に一致させる

plan.yaml の例

yaml
version: "1.0"
prompt: "結論だけを 90 秒以内に"
outputs:
  vertical:
    title: "Vertical Highlight"
    clips:
      - id: vertical-1
        startSec: 12
        endSec: 82
        label: "結論"
  horizontal:
    title: "Horizontal Summary"
    clips:
      - id: horizontal-1
        startSec: 0
        endSec: 60
        label: "導入"
      - id: horizontal-2
        startSec: 60
        endSec: 180
        label: "本題"

コマンド

bash
bun run vc plan --prompt "結論だけを 90 秒以内に" --transcript work/transcript_segments.json

使用する環境変数

  • •OPENAI_API_KEY（必須）
  • •OPENAI_PLAN_MODEL（任意、既定 gpt-4.1-mini）

反映方法

  • •vc plan は work/plan.yaml を更新する
  • •vc run は work/plan.yaml を読み込み render.json を生成する

失敗時の対応

  • •LLM 出力が YAML でない場合、plan.yaml を手動で整形
  • •OPENAI_API_KEY が無い場合は vc plan は失敗する
  • •plan.yaml の clips が空なら vc run はフォールバックのプランを使う