撰寫文案(鉤子 · 腳本 · 貼文)
創意的瓶頸往往不是產生素材,而是該說什麼。這個技能會利用經過驗證的直效回應框架來產生鉤子、腳本和貼文,讓用戶挑選並修改。所有操作都透過工作流程指令進行 — 使用 CLI,不要手寫腳本:
node workflows/cli.cjs generateHooks '<json-args>' # 也可用:generateScript, generateCaption
下方展示的 TypeScript 呼叫簽名說明了每個指令的引數 — 請將它們轉換為 node workflows/cli.cjs <command> '<json-args>',不要貼到新檔案裡。
如果專案中有現成的脈絡(project.md 中的受眾/痛點/產品;brand.md 中的語氣/限制),請先提取這些資訊,確保文案符合品牌調性且不違反 restrictions。
步驟 0:撰寫前先檢查參考文案
語氣的一致性來自範例,而不是形容詞。在產生鉤子、腳本或貼文之前:
- 檢查註冊表中是否儲存了文案範例:
找到後 → 提取其中的模式(句子長度、表情符號使用、標籤風格、CTA 用語、正式程度),並在後續所有文案中模仿這些模式。node workflows/cli.cjs resolveAsset '["{name}","style-copy"]' # 存放文案範例的 style_references ID cat projects/{name}/assets/style/copy-examples.md 2>/dev/null cat projects/{name}/style-samples/caption-examples/*.md 2>/dev/null # 用戶的收件匣 - 若無儲存 → 詢問一次:
「你有沒有過去表現很好的貼文、標題或腳本?或者你喜歡哪個帳號的文案風格?貼 1-3 個範例(或說『沒有』——我會根據 brand.md 來寫)。」
- 提供範例 → 儲存到
projects/{name}/assets/style/copy-examples.md並註冊(registerAsset '["{name}","style_references",...]'),以便未來重複使用。 - 「沒有」 → 根據
brand.md的語氣進行,並說明你做了哪些語氣假設。
- 提供範例 → 儲存到
- 若有範例,請在
prompts.txt中記錄該文案匹配了哪一份參考。
步驟 1:鉤子(撰寫整篇之前先選定角度)
從不同角度產生多個鉤子,讓用戶選擇 1-2 個來發展。
node workflows/cli.cjs generateHooks '{"topic":"AI 讀書計畫 App","audience":"準備期末考的學生","painPoint":"不知道從哪裡開始複習","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }] — angles: problem | curiosity | result | contrarian | question | stat | story
按角度分組展示,並詢問用戶要用哪個。 不要自動挑選 — 鉤子決定了整個作品的走向。
步驟 2:腳本(框架驅動,按時間長度調整)
選定鉤子後,根據目標選擇框架來撰寫腳本:
| 框架 | 最佳用途 |
|---|---|
hook-retain-reward | 短影音(TikTok/Reels/Shorts)— 預設 |
PAS(問題-加劇-解決方案) | 痛點導向廣告 |
AIDA(注意力-興趣-欲望-行動) | 經典直效回應 |
BAB(Before-After-Bridge) | 轉型 / 成果展示 |
star-story-solution | 見證 / 創辦人故事 |
# hook:從 generateHooks 傳入選定的鉤子文字
node workflows/cli.cjs generateScript '{"brief":"AI 讀書計畫 App,60 秒內建立複習進度","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<選定的鉤子文字>","cta":"免費試用 — 個人檔案連結"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }
將腳本以標籤式章節(旁白 + 視覺提示)展示,並附上預估時間。
如果 estimatedDurationSeconds 與目標時間相差甚遠,請標記出來,讓用戶可以增減內容。
這個 voiceover 文字可直接傳入 generateVoiceover(),而每個場景的 visual 提示則可傳入 generateStoryboard() / 影片技能。
步驟 3:貼文(依平台優化,可直接發布)
最後一哩路 — 真正隨著影片/圖片一起發布的貼文內容與標籤。
node workflows/cli.cjs generateCaption '{"topic":"AI 讀書計畫 App","platform":"instagram","tone":"親切、自信","cta":"個人檔案連結","count":3}' # platform: tiktok | instagram | youtube | facebook
# c.data.captions: [{ text, hashtags:[] }]
如果內容會跨平台發布,則為每個平台產生不同版本(各平台長度與標籤習慣不同)。將選定的貼文儲存在輸出旁邊,例如 projects/{name}/output-contents/.../caption.md。
整體流程
generateHooks → pick → generateScript → { voiceover → generateVoiceover,
visual cues → generateStoryboard → video }
→ generateCaption → caption.md
始終先建議再確認 — 提供選項,根據理由推薦一個,讓用戶編輯。切勿捏造統計數據/見證(只能從 project.md 中提取真實資料)。