Communitygithub.com

shot-speak

將日常語言描述的鏡頭轉換為真實的電影語言。當不熟悉攝影術語的人描述一個鏡頭、攝影機運動或影片/AI 影片提示詞時使用。

shot-speak 是什麼?

shot-speak 是一款 AI 助手技能,旨在幫助使用者將日常口語中的鏡頭描述轉換為專業、精確的電影語言,並生成可在任何影片生成器中使用的提示詞。它支援多個平台(如 Claude Code 等),透過結構化流程運作:首先「傾聽與解釋」使用者的模糊請求,然後生成 3 到 4 個具體選項(包含攝影機運動、擺位、鏡頭、燈光、色調、速度等),每個選項都附有一張模擬靜態圖、平實的解釋、模型無關的提示行以及最終的鏡頭規格。此外,該技能還包含「去 AI 味」模式,可檢查並重寫貼上的影片提示詞,移除常見的 AI 生成預設問題(如構圖、燈光、鏡頭和運動)。它還可處理多鏡頭動作序列、建立可選的 Blender 阻塞預覽,並將具名的電影風格轉換為不提及名稱的決策。shot-speak 強調賦能而非設限,提供快速路徑(如直接給出提示詞),並嚴格遵守安全規則(例如不花錢、提示詞中不包含品牌名稱、不處理使用者照片或個人資料、不列印金鑰)。

相容平台~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. 花錢前必須有明確的同意。 用 1 行詢問:「4 張模擬靜態圖,約 0.28 美元 – 繼續嗎?」
  2. 生成器提示詞中不得包含名稱: 沒有品牌、電影、系列、導演、產品或真人。
  3. 使用者的照片和個人資料不得傳送給供應商。
  4. 絕不印出金鑰。

快速路徑:

  • 使用者已經知道鏡頭:直接給提示詞。shotspeak.py prompt --phrase "..." 會產生 1 個提示詞,沒有選項回合。
  • 「直接給我提示詞」:直接給提示詞。然後用 1 行提供模擬靜態圖。
  • 使用者可以隨時跳回、混合部分或重新開始。跟隨他們。
  • 鎖定、預覽、回合和序列都是選項。最終提示詞永遠不會等待它們中的任何一個。

語氣:

  • 先說平實的詞語,再說專業術語。為每個選項教授 1 個術語。不要長篇大論。
  • 一次只問 1 個問題,而且只在答案會改變結果時提問。
  • 如果使用者的想法違反了慣例,用 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. 超過 1 個鏡頭(可選)。 執行 sequence。開啟 sequences/index.md。
  8. 去 AI 味模式。 使用者貼上提示詞,或說某個鏡頭看起來很假。開啟 deslop.md。

如何閱讀這些檔案

按此順序閱讀,當你獲得該步驟所需的內容時即停止:

  1. 本檔案。
  2. references/index.md:每個主題 1 行,格式為「當你需要……時,開啟……」。
  3. 該主題的 index.md:每個子檔案 1 行,格式為「當……時閱讀」。
  4. 你需要的 1 個子檔案。每個檔案不超過 100 行。
  5. 子檔案末尾的「另請參閱」清單,僅在需要更多資訊時查閱。

不要載入整個資料夾。生成的檔案會在其前幾行中說明:修改 scripts/catalog.py,然後執行 python3 SKILL_DIR/scripts/build_references.py。

到哪裡查詢

相關技能