Communitygithub.com

pierrernrd04-ai/traceo-reels

撰寫 Instagram 貼文文案——包括「…更多」之前的第一行、內文、單一行動呼籲、搜尋關鍵字以及三個主題標籤——並在發布前進行 lint 檢查。當使用者說「寫文案」、「幫我下標題」、「描述要寫什麼」、準備好 Reels 或輪播並需要文字,或詢問主題標籤時使用。

traceo-reels 是什麼?

此技能提供一個完整的 Instagram 貼文文案撰寫與 lint 工具鏈。它內建一個 Python 腳本 (caption.py),用於驗證文案字數、行動呼籲數量、表情符號密度等規則,並可接受 `--keywords` 參數以強化 SEO。該技能根據 Instagram 2025 年 12 月的更新——主題標籤上限從 30 個降至 5 個——調整了策略,強調搜尋關鍵字應融入文案自然語句而非堆疊標籤。支援 Claude Code、Cursor 等代理工具,使用者只需提供 Reels 或輪播素材,代理便會判斷文案類型(A 類:Reels 自帶鉤子,B 類:文案即內容),完成草稿後執行 lint 檢查,最後輸出一份包含可見字數、行動呼籲、主題標籤與搜尋詞的「收據」。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pierrernrd04-ai/traceo-reels/tree/HEAD/studio/skills/ig-caption

在你喜歡的 AI 中提問

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

說明文件

ig-caption

此資料夾中只有一個工具,運行方式如下:

python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "client proposals,agency pricing"

它會像動態牆那樣輸出文案:前 125 個字符顯示在方框中,其餘內容需要點擊才能展開。在閱讀你寫的其他內容之前,請先閱讀那個方框。

首先,決定這則文案的任務

這是當被忽略時會毀掉文案的關鍵決定。

任務 A:影片已經鉤住觀眾。 Reels 在前兩秒就透過口語和畫面自帶鉤子。文案不是第二個鉤子,與影片競爭只會兩頭落空。它的任務是行動呼籲、讓行動呼籲合理化的背景資訊,以及人們會搜尋的詞彙。

任務 B:文案本身就是內容。 照片、單張圖片、開啟閉環的輪播封面。在這種情況下,第一行是鉤子,它的運作方式與 Reels 鉤子完全一樣:具體、簡短、在懸崖處而非句子中間切斷。

詢問你正在撰寫的是哪一類。如果使用者有帶強力鉤子的 Reels,就寫任務 A 並說明原因。

格式

第一行     125 個字符的可見空間。任務 A:直接寫出行動呼籲。
            任務 B:寫出鉤子。
            永遠不要用問候語、主題標籤或表情符號開頭。
內文       短段落,段落之間空一行。兩到六段。這裡放置搜尋關鍵字。
行動呼籲   一個。留言關鍵字、儲存或私訊。一個。
主題標籤   最多五個,單獨一行放在最下方,或完全不放。

限制為 2,200 個字符,但幾乎沒有文案需要 2,200 字符。能夠吸引點擊展開並傳遞 600 字符的文案,勝過傳遞 1,800 字符的文案。

關於主題標籤,老實說

主題標籤不再是觸及槓桿,平台也已透過產品更新說明了這一點。Instagram 於 2025 年 12 月 18 日將每篇貼文的主題標籤上限從 30 個降至 5 個,並告訴創作者「使用較少(最多 5 個)更精準的主題標籤,而非許多通用標籤」效果更好。Adam Mosseri 在 2025 年 2 月就已表示,主題標籤無法增加觸及,它們是標籤,而非分發槓桿。

因此:最多五個、具體、作為主題標籤使用。如果使用者在筆記應用中存了一個二十個標籤的區塊,那個區塊現在已是累贅,lint 工具將會標記它。

#viral、#fyp、#explorepage、#foryou 沒有任何描述性。刪掉它們。

搜尋關鍵字現在比主題標籤更重要

Instagram 搜尋會讀取文案文字。因此,使用者希望被找到的短語應以一般人會輸入的自然語句形式放在文案中。例如 "Client proposals" 作為第三行中的詞語,而不是 "#clientproposals" 放在底部的區塊中。

要求使用者提供兩到三個這類詞語,然後將它們傳給 lint 工具:

python3 caption.py draft.txt --keywords "client proposals,agency pricing"

規則

  • 文案中不要有連結。 文案無法點擊。內文中的 URL 是無效的文字,只會顯示「我不會用這個平台」。放在個人簡介或私訊中。
  • 一個行動呼籲。 兩個行動呼籲等於沒有。caption.py 會計算它們的數量。
  • 關鍵字行動呼籲需要一個人們可以輸入的關鍵字。 一個單詞、無空格、無表情符號,同時也要在影片中大聲說出來。留言 CONTRACT 有效。留言 "the contract guide" 無效。
  • 如果有連結,請分開撰寫第一則留言。 在收據中說明。
  • 表情符號作為標點,而非裝飾。 Lint 工具會標記每 100 字符超過 4 個表情符號的情況。
  • 替代文字值得花 20 秒。 對於輪播和照片,請撰寫替代文字。它會被螢幕閱讀器和 Instagram 讀取。

流程

  1. 決定任務 A 或任務 B,並說明是哪一個。
  2. 草擬文案。
  3. 對文案執行 /ig-human 檢查。文案很短,因此錯誤在此處比在其他地方更明顯。
  4. 使用使用者的搜尋關鍵字執行 caption.py。修正每個 FAIL。對於每個 WARN,大聲說出你的決定,而非默默處理。
  5. 輸出可複製的文案區塊,然後是收據:
CAPTION READY
job:        A - the reel carries the hook
visible:    118 of 125 characters used before the cut
ask:        one, comment CONTRACT
hashtags:   3
search:     "client proposals" in line 3, "agency pricing" in line 5
linter:     READY

不會發布任何內容。由使用者自行貼上。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能