用途：为 AI 生成式视频提供镜头语汇。前提是生成式视频而非程序化渲染，因此写的是提示词怎么写、参考图怎么挂、切几格、AI 会在哪崩。它补的是「这一刀该怎么切」的配方层与技法层空缺，不写剧本、不排分镜结构、不出视频。
主要能力：两族卡以 kind 区分。配方卡回答这场戏这一刀怎么切，类目含对话、情绪、揭示、进场、反应、转场、强调、产品展示、口播；技法卡回答某手段是什么、何时用、何时别用，类目含运镜、机位角度、景别、构图、焦段与景深、光线、特殊技巧。技法卡每类目有域，卡片用 covers 认领，域里少一项 lint 会点名。卡片 frontmatter 为机器字段，正文六节固定，必备短语受六条硬约束并由机器强制。
使用方式：脚本 {baseDir}/scripts/shot-recipes.mjs 零依赖，node 直接跑。查卡用 list、search、show；出画廊报告用 render --html，可加 --lang en 或 --check <storyboard.json>，报告须写入 {baseDir}/references/cards/；检查分镜配方引用用 check <storyboard.json>，深度遍历 JSON 收集同时带 recipe 与 frame 的对象，校验配方 id 在库、必备短语出现在 frame 中，中文提示词跳过并计数；写新卡先读 references/card-schema.md 与 card-pass.md，再跑 lint；可选集成 novel-storyboard 时用 validate 并加 --shots 指向卡库目录。自测跑 selftest.mjs，不调模型不花额度。
适用场景：给用户切镜、写提示词前先 list 挑卡再 show 读全文，照提示词骨架写分镜图提示词，骨架必备短语一条不能少。
限制：不写剧本、不排分镜结构、不出视频；配方只描述官方词表描述不了的东西，景别与运镜词已有门在管，卡片不重复设门。示例帧需 codex，没有则显示未生成占位。报告写到别处图不显示。双语机器字段只有一份，正文中文同文件、英文在 cards/en/。来源格式学自 video-shotcraft，内容为本仓库生成式实践。