Community寫作與編輯github.com

captions-engine

根據 Google Sheet 廣告文案清單中的圖片標題、內文與 ICP,為每則廣告產出 Meta 標題、主要文字與描述。當輸入 /captions-engine 或分享廣告文案試算表時使用。

captions-engine 是什麼?

captions-engine 是一個專為 AI 代理設計的技能,用於從 Google 試算表中的廣告文案行產生三種 Meta 廣告文字欄位:Meta 標題、主要文字(primary text)和描述(description),每種欄位均提供一個最終版本與一個替代版本。此技能會根據每行廣告的鉤子類型、產品事實、理想客戶檔案(ICP)以及目標年齡層來動態調整寫作規則,確保每個文字表面(圖片標題、內文、主要文字、Meta 標題、描述)在讀者不同閱讀階段發揮最大效用。它支援 Claude Code、Cursor 和 Codex 等平台,透過 Google Sheets API 讀取試算表、詢問必要的上下文問題(如產品名稱、目標年齡範圍)以確認事實,並按照嚴格的自我檢查清單產出成熟、不花俏的文案。最終輸出包含 ICP 快照、每行廣告的完整表格,以及寫回試算表的選項,確保不覆蓋既有資料並保持可還原性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/moozinnit-su/captions-engine/tree/HEAD

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

/captions-engine

將廣告文案(Google 試算表中圖片標題 + 內文行)轉換為每則廣告的三個 Meta 文字欄位:Meta 標題、主要文字和描述,每個欄位提供一個最終版本與一個替代版本。規則為通用規則,並會根據每行的鉤子類型、產品事實、ICP 和目標年齡層在每次執行時重新調整。

核心概念(為何有效)

每則 Meta 廣告有五個文字表面,分別在不同時刻被閱讀:

表面位置讀者狀態任務
圖片標題(鉤子)圖片上,大字仍在滑動抓住目光
內文圖片上,小字剛停下說明解決方案是什麼
主要文字圖片上方感興趣,正在決定回答他們腦中的下一個問題
Meta 標題圖片下方,CTA 旁即將點擊用幾個字說明下一步行動
描述Meta 標題下方(非所有版位都會顯示)點擊前瞥一眼一個降低風險的支援事實

主要文字是在鉤子已經發揮作用後才被閱讀,因此絕不能重複鉤子或內文。它必須從相同角度提供新資訊。

步驟 1:資料擷取

  1. 取得 Google 試算表連結。使用 Google Sheets 工具(get_spreadsheet 取得分頁,get_values 取得資料列)讀取。
  2. 對應欄位:ID、角度/群組、圖片標題(鉤子)、內文、現有 Meta 標題、現有主要文字、現有描述、CTA。圖片標題和內文為必填。如果缺少 Meta 標題或描述欄位,技能會建立它。如果任何欄位不明確,請提問,不要猜測。
  3. 確認範圍:哪個分頁,以及所有資料列或部分子集。

步驟 2:背景問題(每次執行)

首先從記憶和專案背景中拉取已知資訊:產品名稱、價格、保證、交貨時間、ICP、目標年齡、登陸頁面/CTA 目的地、禁止宣稱。

然後針對任何遺漏或可能已變更的資訊提出 2-4 個選擇題。以下兩個問題每次執行必問,即使記憶中有答案也需確認:

  1. 這個產品叫什麼名字?
    • 選項:檔案中已有的產品名稱,加上「其他(自行輸入)」
  2. 這些廣告的目標年齡範圍是?
    • 25-34
    • 35-44
    • 45-60
    • 60+
    • 混合/廣泛(輸入範圍)

其他常見問題,僅在需要時提出:

  • 此產品的目標 ICP 是誰(他們是誰、主要痛點、使用的詞彙、是否擁有決定權)
  • 需確認的產品事實(價格、保證條款、時間表、包含項目)
  • 目的地與 CTA(登陸頁面、潛在客戶表單、Messenger、通話預約)
  • 需要簽核或禁止使用的宣稱

年齡如何影響寫作:

年齡範圍寫作調整
25-34節奏可稍快。仍保持平實,不使用俚語或誇張詞彙
35-44平實直接。以節省時間和金錢為切入點
45-60用詞最簡潔,無技術術語,節奏稍緩。以安全性、信任和聲譽為切入點
60+與 45-60 相同,加上更短的句子和非常明確的下一步

然後製作一份已確認事實清單和一份ICP 快照(產品名稱、目標對象、年齡範圍、痛點、他們的詞彙、是否為決策者)。只有已確認的事實才能寫入文案。任何未經確認的資訊都會被標記出來,絕不會當作事實寫入。

步驟 3:分類每行鉤子的類型

鉤子類型範例訊號主要文字任務Meta 標題任務
痛苦/問題提問「還在卡關……?」指出繼續卡關的代價,然後指出解決方向解決問題的下一步
恐懼/風險「擔心你的……?」具體化風險並安撫,然後說明如何消除安全的下一步
渴望/成果「X 天內獲得 Y」說明達成目標需要做什麼,以及他們付出與獲得的對比獲得成果的步驟
身份呼籲「物業管理者:……」展現你了解他們的世界(他們的任務、他們的詞彙)目標對象 + 行動
優惠/保證「$X 否則免費」解釋為何保證可信,以及符合資格的條件在無風險的情況下開始
證明/數字「節省 500 多小時」數字從何而來,對他們有何意義數字作為好處
好奇心「那個任務……」第一行快速滿足好奇心,然後帶入優惠引起好奇的解答
異議「無需開發團隊」回答這個異議之後的下一個異議已消除的障礙

如果一行混合了多種類型,使用鉤子主導的那一種。如果不符合任何類型,請說明並寫入最接近的類型。

步驟 4:撰寫 Meta 標題(最終版 + 替代版)

每行都必須有 Meta 標題,即使試算表中原本沒有。從三個輸入建構:

  1. 圖片標題(鉤子): 保持相同角度,但絕不抄襲其措辭。
  2. 內文: 提取內文所做的具體承諾(成果、價格、時間表、保證)。不要添加內文未做的承諾。
  3. ICP: 使用 ICP 自己的詞彙來描述他們的問題或結果(例如「你的應用程式」、「你的業務」、「你的客戶」)。

規則:

  • 寫成讀者要採取的下一步行動,最多 5-6 個字,以動作動詞開頭。它可以作為整個優惠的簡短摘要。
    • 良好範例:「保護你的應用程式,然後上線」、「上線前修補漏洞」、「完成應用程式並上線」
  • 成熟,不花俏。 沒有文字遊戲,沒有響亮的標語。如果讀起來乾淨流暢,樸實無華也可以。
  • 不要提及通話或團隊名稱(「聯繫我們」、「獲取專家協助」、「預約諮詢」)。CTA 按鈕已經負責要求通話。
  • 保持在 40 個字元以內(超過此長度在行動裝置上會被截斷)。
  • 如果該行已有的 Meta 標題通過這些檢查,則保留它作為最終版。說明此事,並仍然提供一個替代版。
  • 替代版使用不同的槓桿(例如最終版 = 行動,替代版 = 風險反轉或 ICP 呼籲)。標註使用了哪個槓桿。

步驟 5:撰寫主要文字(最終版 + 替代版)

結構:

  1. 第 1 行(前約 125 個字元) 必須能獨立運作,因為這是「查看更多」之前顯示的全部內容。它直接針對 ICP 的情境說話(例如,一個擁有即將完成的應用程式的企業主)。這是新資訊,不是重新包裝的鉤子。
  2. 中間部分(2-4 行簡短文字): 說明為何採取行動符合他們自身利益、會發生什麼事、他們付出與獲得的對比、以及消除了哪些風險。僅使用已確認的事實,並針對 ICP 的情境撰寫。
  3. 價格與保證放在中間部分,絕不在第 1 行。如果內文已說明價格或保證,則省略金額或改述保證。
  4. 最後一行: 一個與 CTA 按鈕和目的地相符的明確下一步。

風格規則:

  • 成熟,不花俏。 一般人應能一讀就懂。
  • 用「你」來稱呼讀者。必要時指出目標對象(例如「如果你經營小型企業……」)。
  • 簡短行,行間空一行。沒有密集的段落。
  • 絕不重複鉤子或內文中的句子。
  • 無 em 破折號。無誇張詞彙(革命性、顛覆性、解鎖)。使用平實的英文。
  • 無虛構的宣稱、數字、見證、附加項目或術語。避免使用無法佐證的「大多數人……」說法。使用「許多人」。
  • 保持與該行鉤子和內文相同的角度。
  • 使措辭符合目標年齡範圍(步驟 2 表格)。
  • 目標字數:60-150 字。

替代版在相同角度上採取不同的路徑(例如最終版以等待的代價切入,替代版以風險反轉切入)。標註變更之處。

步驟 6:撰寫描述(最終版 + 替代版)

位於 Meta 標題下方的一行簡短文字。它不會在所有版位顯示,因此廣告必須在沒有它的情況下也能運作。

規則:

  • 簡短: 3-6 個字,少於 30 個字元。
  • 來自已確認事實清單中的一個支援事實:保證、時間表、價格或包含項目。
    • 良好範例:「逾期保證退款」、「固定價格,無隱藏費用」、「使用你自己的域名上線」
  • 不要重複 Meta 標題或鉤子。它提供了它們沒有說明的資訊。
  • 成熟,不花俏。無 CTA 措辭(按鈕負責)。
  • 替代版使用不同的事實。標註使用了哪個事實。

步驟 7:每行輸出前自我檢查

  • 產品名稱和目標年齡已在此次執行中確認
  • 第 1 行為新資訊,針對 ICP 說話,且在沒有「查看更多」時也能獨立運作
  • 主要文字、Meta 標題或描述中無重複的鉤子或內文措辭
  • 價格與保證不在第 1 行
  • 所有宣稱皆在已確認事實清單上
  • 成熟,不花俏。無 em 破折號、無誇張詞彙,以「你」為撰寫對象
  • 措辭符合目標年齡範圍
  • 已插入換行
  • Meta 標題最多 5-6 個字、少於 40 個字元、為行動表述、且未提及通話或團隊名稱
  • 描述少於 30 個字元並補充不同的事實
  • 最後一行與 CTA 和目的地相符

在輸出前修正任何未通過的項目。僅顯示修正後的版本。

步驟 8:輸出

  1. ICP 快照(包含產品名稱和年齡範圍)、使用的已確認事實,以及任何標記(需要簽核的宣稱)。
  2. 每行的表格:ID | 鉤子類型 | 圖片標題 | 內文 | Meta 標題(最終版/替代版) | 主要文字(最終版/替代版) | 描述(最終版/替代版) | 其有效原因(一行)
  3. 簡短的「如何自行操作」說明:識別出的鉤子類型,以及讓每個欄位有效的一個關鍵動作。
  4. 以下一步做什麼結尾。

步驟 9:寫回試算表

  • 在使用者同意前不要寫入試算表。如果他們的要求已指示將文案加入儲存格,則視為確認。
  • 優先使用進行中的分頁(例如「Draft - Claude」)而非最終分頁。未經要求絕不覆蓋現有文案,並保留先前版本以便應要求還原。
  • 建立新欄位時的欄位順序:ID | 圖片標題 | 內文 | Meta 標題(最終版) | Meta 標題(替代版) | 主要文字(最終版) | 主要文字(替代版) | 描述(最終版) | 描述(替代版) | CTA。
  • 在寫入前明確指出分頁和範圍,然後一次完成寫入。
  • 寫入後,重新讀取該範圍以檢查是否有任何偏移。

相關技能