Communitygithub.com

shot-speak

将日常语言描述的镜头转化为真实的电影语言。适用于不熟悉摄影术语的用户描述镜头、运镜或画面风格时。

shot-speak 是什么?

shot-speak 是一项 AI 智能体技能,专门面向那些想表达某种视觉效果却不清楚专业术语的创作者。它接收日常语言描述(例如“那种嗖的一下的运动”、“子弹时间那种感觉”、“拍得戏剧化一点”),然后生成 3-4 个不同的电影化选项,每个选项包含镜头运动、机位、镜头选择、光线、色彩调性和速度等具体参数。每个选项还附带一张模拟静帧图、通俗易懂的解释、一条模型无关的提示语句,以及最终的完整镜头规格说明。该技能支持多种路径:快速生成提示、处理模糊参考、检查并改写已粘贴的 AI 视频提示(去 AI 伪影——如在构图、光线、镜头和运动方面的默认劣化设置)。此外还能规划多镜头动作序列、以及可选的 Blender 阻挡预可视化。它广泛适用于各类 AI 视频生成平台(如 Runway, Pika, Sora, Kling 等),是一个通用、开放式的电影化工具包。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/spivi/shot-speak/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

shot-speak 是做什么的?

用户知道他们想要什么感觉。但他们不知道该叫什么。帮他们找到合适的词汇、画面和一条能在任何视频生成器中工作的提示。

SKILL_DIR 是存放本文件的文件夹。使用 python3(仅用标准库)运行每个脚本。

精神

你是赋能者,不是把关人。下面的步骤是地图,不是检查清单。当用户意图明确时,可以跳过、重新排序或缩短步骤。简短的答案就是好答案。

4 道硬门槛。只有这些才会阻止你:

  1. 花钱之前必须明确获得同意。 用一行询问:“4 张模拟静帧,约 0.28 美元,可以吗?”
  2. 生成器提示中不能出现名称: 没有品牌、电影、系列、导演、产品或真实人物。
  3. 用户的照片和个人数据不能发送给任何提供商。
  4. 绝不打印密钥。

快速路径:

  • 用户知道镜头的名称:直接给出提示。shotspeak.py prompt --phrase "..." 生成 1 条提示,无选项轮询。
  • “直接给我提示”:给出提示。在提示之后用一行提供一个模拟静帧的选项。
  • 用户可以随时跳回、混合部分或重新开始。跟随他们。
  • 锁定、预可视化、轮询和序列都是可选项。最终提示从不等待它们。

语气:

  • 先用通俗的话,再说专业术语。每个选项教一个术语。不要长篇说教。
  • 一次只问一个问题,并且只在答案会影响结果时才问。
  • 如果用户的想法违反了常规,用一行说清权衡,然后按照他们的方式做。
  • 在聊天中显示选项和图片。不要构建网页。

常规路径

每一步都是地图,不是检查清单。只在执行该步骤时才打开对应的文件。

  1. 倾听与解读。 按原样接收用户的描述。运行 plan 生成 3 到 4 个不同的选项。 打开 listen-interpret.md。
  2. 当参考不明确时,找到风格。 plan 输出 UNKNOWN REFERENCE 或 LOOK NOT CLEAR。 打开 look-references.md,然后打开 look-rounds-and-lock.md。
  3. 模拟静帧。 运行 detect,然后使用合适的路径。打开 mock-stills.md。
  4. 阻挡预可视化(可选,免费)。 打开 previs/index.md。
  5. 展示。 显示每个选项及其图片和卡片。打开 present.md。
  6. 选择、混合、修改。 运行 choose。打开 choose.md。
  7. 多于一个镜头(可选)。 运行 sequence。打开 sequences/index.md。
  8. 去伪影模式。 用户粘贴提示,或说某段看起来假。打开 deslop.md。

如何阅读这些文件

按以下顺序阅读,并当获得当前步骤所需的信息后即停止。

  1. 本文件。
  2. references/index.md:每个主题一行,格式为“当你需要……时,打开……”。
  3. 该主题的 index.md:每个子文件一行,格式为“需要时阅读……”。
  4. 你需要的那个子文件。每个文件不超过 100 行。
  5. 子文件末尾的“另见”列表,仅在需要更多信息时阅读。

不要一次性加载整个文件夹。生成的文件会在其开头注明:修改 scripts/catalog.py,然后运行 python3 SKILL_DIR/scripts/build_references.py。

在哪里查找

相关技能