/bb:script
目標
一份團隊能在一個下午完成拍攝的拍攝包。每支廣告都能在靜音狀態下，於兩秒鐘內抓住陌生人的注意力，給一個人一個購買的理由，並以一個他們可以行動的 deal 結尾。背後是一份推理表，為每個掛鉤、承諾和證明標註了出處的書籍段落。
從這裡開始：閱讀、重述、只問一次
執行這個技能的人掌握著上下文，他們所說的內容是做出好作品的關鍵。我們的廣告曾因什麼都沒問而失敗；一支 Reel 則因為有人提供了真實的上下文而成功。
先閱讀，不要提問：客戶的獲勝作品、人物誌、評論與過去的廣告；現有的產品、價格與提案；以及簡報中提及的內容。
重述：買家、切入點、階段、提案，根據你從證據中讀到的內容來陳述。填寫你所知道的資訊，以便他們確認，而不是重新輸入。
只問缺少的資訊，以一個簡短的回合進行（如果有，則使用 AskUserQuestion，否則直接在訊息中詢問）。通常是兩到三個問題：
- 這則廣告應該影響誰？他們應該為自己描繪什麼畫面？看完後他們應該立刻做什麼？
- 我們今天可以展示什麼確切的產品、提案、價格、行動理由和證明？說話者真實經歷了什麼？
- 誰在說話？他們聽起來應該是什麼樣子？我們實際可以拍攝什麼：攝影機、人員、地點、道具、時間？
然後提出它的定位，等待確認或修改：買家 × 切入點 × 認知階段、腳本模式（創辦人故事、真實評論回覆、示範、問題導向、公平比較、實地挑戰或娛樂、直接提案）以及格式。
將答案放入 job/brief.md，然後一路工作到底，不再中斷。如果他們已經提供了所有資訊，或說直接進行，就不要問。如果沒有人能回答（無頭執行），就說出你原本會問的問題，並採取合理的解讀。
品味屬於任務
在 job/brief.md 的第一行寫下任務：付費廣告、自然流量 Reel，或開局設定的任何內容。某人在一支影片中喜歡的東西，不應帶到另一支影片。自然流量 Reel 和廣告是不同的任務：廣告是為了銷售。因此，廣告的評判標準是其目標對象、產品的賣點、證明和購買理由，而不是自然流量作品的玩笑或感覺。玩笑在廣告中存在的價值，只在於它推動了銷售。
為什麼這個技能存在
如果放任不管，Claude 會寫出禮貌的廣告：一個人對著鏡頭、一個溫和的語音掛鉤（需要你知道主角）、一個小笑話、把 deal 說兩次、每次都同樣的結尾。乾淨、可拍攝，但平淡。模型傾向於安全、常見的選擇，而一串規則無法將它們拉回來。
真正有用的方法是：在構思文字之前找到訴求、在選擇之前產生多個掛鉤、在面前放著書籍的筆記、以及讓一個從未看過你推理過程的評論者來評判草稿。書籍提供的是問題和段落，而不是「聲音」。「像 Schwartz 那樣寫」沒用。「這個觀眾是陌生用戶，所以第一行是描述他們而不是產品嗎？」加上背後的段落，這才有效。
什麼是好的成果
- 五個形狀各異的廣告。閱讀播放順序，你無法從廣告 1 預測廣告 4。
- 第一個畫面與一行文字，讓陌生人在靜音模式下也能理解，且字數很少。攝影機可以是一個角色，結尾的笑話可以是一個眼神。並非每個點子都是談話頭，也並非每個點子都以某人掉進泳池結束。
- 快速且清楚地說明目標對象是誰以及他們為何購買，每支廣告都以一個 deal 結尾。當簡報需要樂趣時，短劇是受歡迎的，但仍然必須銷售：笑話就是賣點，而重述它需要產品。
- 可指導性："Do this. Do this. Say this." 能承載點子的最簡單設定，通常是一個地點和最少的演員。
- 每支廣告一個 deal，只說一次，在結尾處，精確地，用十二個字或更少，以最強有力的真實形式表述。
- 使用精確的數字和具名的細節，而不是形容詞，每個細節都可追溯到其來源。
- 它對一個人說話，並改變她持有的一個信念。產品配上漂亮的畫面只是一個展示，無論多美，都是失敗的。
- 一個看起來完全像最終交付格式的包裝，沒有引用、沒有開放性問題、也沒有標記為「未確認」的項目。
指令
引用檔案要寫得簡短。Shell 狀態不會在指令之間傳遞，因此始終使用完整形式，並給評論者 agent 也提供完整形式。
scripts/...意指${CLAUDE_SKILL_DIR}/scripts/...。references/...意指${CLAUDE_SKILL_DIR}/references/...。search.py意指python3 "${CLAUDE_PLUGIN_ROOT}/skills/books/scripts/search.py"。- 書籍卡片：
${CLAUDE_PLUGIN_ROOT}/skills/books/cards/。
流程
在 <client>-scripts/<yyyy-mm-dd>-<slug>/ 目錄下工作，該目錄為使用者的當前目錄，或簡報指定的目錄（job/）。每個步驟都會寫入一些東西，因此重新開始的 session 可以從最後一個檔案繼續。
0. 閱讀，從客戶開始。 正確執行上述的開局回合：客戶自己的獲勝作品及其數字、其人物誌，以及其客戶的用語（評論、廣告留言），只要有筆記指引就去尋找。「無檔案記錄」意味著你還沒查看。然後查看任何客戶筆記或個人簡介技能、客戶自己的獲勝作品資料夾（僅限該客戶，參見 examples/README.md）、lessons.md、簡報。重新檢查價格、deal 和日期及其來源。撰寫 job/brief.md：包含來源和日期的事實與 deal、誰在鏡頭前、該品牌獨有的特色、客戶自己的點子（每行一個）、來自開局回合的答案。
1. 診斷。 載入 references/diagnose.md。從一個真實的人開始：為她的類型命名、她的一天、她現在使用的東西、她會說什麼、為什麼是她而不是其他人物誌，並附上證據。然後確定訴求、他們現在的做法、他們的認知程度、他們聽過多少次、他們不相信什麼、這個 deal 存在的原因以及該品牌獨有的特色。撰寫 reasoning.md §1，每個區塊一個段落。
2. 為此任務搜尋書籍。 載入 references/search.md。不要從記憶中回憶書籍的內容：針對此產品的實際問題執行六到十次搜尋，使用 --show 閱讀筆記，保留與此簡報相關的八到十二個。撰寫 reasoning.md §2：id、一行說明、哪個區塊。
3. 掛鉤。 載入 references/hooks.md。每支廣告六到八個，涵蓋至少四種類型，包括一個樸素的，以及至少兩個你猶豫是否要給客戶看的奇特掛鉤。保留三個：一個安全、一個奇特、一個不提及 deal 的。撰寫 reasoning.md §3。即使沒有人看到，也要讓選項存在：做出選擇，並將被忽略的選項留在表中。
4. 草稿。 載入 references/body-and-close.md、references/offer-and-proof.md 和 references/pack-format.md。撰寫 job/pack-draft.md。撰寫 reasoning.md §4：每支廣告，分別為掛鉤、承諾、證明、主體和結尾各一行，每行附上其出處段落。
5. 檢查。
python3 "${CLAUDE_SKILL_DIR}/scripts/check_pack.py" job/pack-draft.md --event "Black Friday"
python3 "${CLAUDE_SKILL_DIR}/scripts/cite_check.py" job/reasoning.md
修復每一個紅線問題。琥珀色線是判斷問題。將輸出儲存在 job/checks.txt 中。
6. 評論。 使用可用的最強模型啟動一個全新的 agent，並提供 pack-draft.md、brief.md、references/critic.md、完整的 search.py 指令（如果是編輯任務，則包括素材表）。不提供 reasoning.md，也不提供此對話：它根據簡報中的任務來評判廣告，而不是根據藉口。它的問題必須引用真實的段落，並閱讀其筆記。它返回筆記，從不進行改寫。儲存為 job/critic.md。
7. 改寫。 在根據評論者引用的段落採取行動之前，先閱讀該段落背後的筆記：有些 id 可能與其他主題相關，而一個筆記根據其自身邏輯可能仍然是正確的。當簡報的觀點勝出時，在 reasoning.md §5 中以書面形式提出異議。重新執行步驟 5。進行一輪，最多兩輪。結果是 job/pack.md。
8. 打包。
python3 "${CLAUDE_SKILL_DIR}/scripts/build_pack.py" job/pack.md --pdf
打開 PDF 並檢查每一頁：沒有內容被裁剪，一頁一個廣告。閱讀任何 warning: 行。在回覆中，每支廣告給出一行說明，並用一句話命名所使用的書籍。如果客戶有日誌，則新增一行附上日期。
已確認的就是已確認的
使用者已確認的事實就是最終事實。沒有人想要一個列出「未確認」項目的包裝，或一頁的小問題。所以不要這樣做：使用合理的解讀，在 reasoning.md §0 中用一行說明原因，然後繼續。將他們已確認的內容放入包裝的 settled: 行中，檢查器會尊重這一行。如果一個數字真的沒有來源，則在廣告中省略它，並記錄下來。
只有那些會改變決策或影響客戶的事項，才會以回覆中一行樸素的文字提出。你無法找到來源的數字絕不能憑空編造，也不能以問題的形式出現。
編輯已有的素材
有時任務是為手中已有的素材撰寫文字，而不是進行拍攝。路徑相同，但有三個差異。步驟 0 從素材開始：按剪輯和時間列出可用的時刻，因為腳本只能承諾已拍攝的內容。步驟 1 增加一個素材檢查：對於每個聲明，命名顯示該聲明的剪輯時刻，如果沒有對應的鏡頭，則改寫或刪除該聲明。在頁面上，將 mode: edit 放入 front matter 中：Say Lines 保留螢幕上的文字，結尾是螢幕上的文字，影片部分為 ## The footage。將包裝交給 /bb:edit。
硬性限制
- 一個任務只能有一個客戶。來自其他客戶的任何資訊都不能放入簡報、包裝或表中，也沒有任何客戶的資訊可以放入此技能。
- 禁止發明數字、截止日期、庫存數量或評論。緊迫性必須是真實且有理由的。
- 書籍文字必須改寫。用你自己的話說明一本書教導了什麼，並引用其 id。
- 未經執行此技能的人同意，不得將任何內容發送給客戶、發布或從此技能花費金錢。包裝會交給執行此技能的人；由他們發送。
實務知識
每秒字數。 每分鐘口語單詞約 150 個：15 秒約 35 字，20 秒約 50 字，30 秒約 75 字，60 秒約 150 字。動作也會耗費時間。
這些書籍並非關於 Reels。 它們是關於印刷品、郵購、電視和實驗室研究的。將其中的數字視為當時打動人們的依據。Hormozi 的是他自己的主張；Cialdini 的許多是關於人情，而非購買。這些書中沒有測試過靜音動態消息的東西。靜音語法、攝影機作為角色以及結尾笑話來自於觀看真實的 Reels，所以這才是應該參考的地方：客戶自己的參考資料，以及執行者發送的任何內容。
書籍矛盾之處。 每個參考資料末尾都標明了分歧點，以及我們對於 15 到 60 秒影片的傾斜方向。當這個方向決定了一支廣告時，在表中命名它。
投票是一種意見測試。 評論者和評審偏好聰明的手法；拆分測試通常不然（caples-0221, caples-0279）。因此，即使評論者不以為然，一個樸素的掛鉤也應作為另一個選項被拍攝，並由實際數據來決定。
掛鉤與維持。 掛鉤率 = 3 秒播放數 ÷ 曝光數。維持率 = 完整播放數 ÷ 3 秒播放數。掛鉤率低於約 20%：只重新剪輯開頭。維持率低於約 40%：重新剪輯中間部分。兩者都健康但沒有購買：問題在於提案或結尾，而不是剪輯。
何時載入這些檔案
| 參考資料 | 何時使用 |
|---|---|
references/diagnose.md | 步驟 1，以及每當腳本感覺平淡但你說不出原因時 |
references/search.md | 步驟 2，或當搜尋返回空結果時 |
references/hooks.md | 步驟 3，以及任何「重新為此廣告掛鉤」的任務 |
references/body-and-close.md | 步驟 4 |
references/offer-and-proof.md | 步驟 1 用於信念差距和 deal 的理由；步驟 4 |
references/pack-format.md | 步驟 4 和步驟 8 |
references/critic.md | 僅限評論者 agent（步驟 6） |
examples/README.md | 步驟 0，用於查找客戶的獲勝作品 |
evals/judge.md | 僅用於兩個包裝之間的盲測 |
經驗教訓
lessons.md 儲存來自真實結果的日期式要點：廣告、數字及其日期、該手法背後的段落、嘗試的方案。在步驟 0 時閱讀最近五條；評論者會根據它們檢查草稿。此資料夾每次更新時都會被替換，因此客戶自己的經驗教訓和獲勝作品應放在該客戶的資料夾中，而適用於所有人的經驗教訓則透過 repo 提交（CONTRIBUTING.md）。