Communitygithub.com

minkhant1996/soemind-forge

撰寫吸睛的鉤子、框架驅動的腳本以及針對平台優化的貼文與標籤。當用戶需要鉤子點子、影片/廣告腳本、廣告文案、貼文標題,或說「我該發什麼」、「幫我寫腳本」、「給幾個鉤子」、「幫我想標題」時使用。

soemind-forge 是什麼?

這個技能專為內容創作者與行銷人員設計,解決「該說什麼」的創作瓶頸。它不僅能產生鉤子、腳本和貼文,更採用經過驗證的直效回應框架(如 PAS、AIDA、BAB),確保文案具有說服力。使用者可以從多個角度挑選鉤子,再根據平台與目標選擇最適合的腳本框架,最後產出平台適配的貼文與標籤。技能支援 Claude Code 等命令列工具,可透過 `node workflows/cli.cjs` 搭配 JSON 參數直接呼叫,並且會從專案中的 `project.md` 與 `brand.md` 提取受眾、痛點與品牌限制,確保文案風格一致。此外,它還會先檢查先前儲存的文案範例,以維持語氣連貫性。整體流程為:產生鉤子 → 選擇 → 產生腳本(含旁白與視覺提示) → 產生貼文,最終可匯入語音與影片製作管道。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minkhant1996/soemind-forge/tree/HEAD/skills/write-copy

在你喜歡的 AI 中提問

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

說明文件

撰寫文案(鉤子 · 腳本 · 貼文)

創意的瓶頸往往不是產生素材,而是該說什麼。這個技能會利用經過驗證的直效回應框架來產生鉤子、腳本和貼文,讓用戶挑選並修改。所有操作都透過工作流程指令進行 — 使用 CLI,不要手寫腳本:

node workflows/cli.cjs generateHooks '<json-args>'     # 也可用:generateScript, generateCaption

下方展示的 TypeScript 呼叫簽名說明了每個指令的引數 — 請將它們轉換為 node workflows/cli.cjs <command> '<json-args>',不要貼到新檔案裡。

如果專案中有現成的脈絡(project.md 中的受眾/痛點/產品;brand.md 中的語氣/限制),請先提取這些資訊,確保文案符合品牌調性且不違反 restrictions。


步驟 0:撰寫前先檢查參考文案

語氣的一致性來自範例,而不是形容詞。在產生鉤子、腳本或貼文之前:

  1. 檢查註冊表中是否儲存了文案範例:
    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   # 用戶的收件匣
    
    找到後 → 提取其中的模式(句子長度、表情符號使用、標籤風格、CTA 用語、正式程度),並在後續所有文案中模仿這些模式。
  2. 若無儲存 → 詢問一次:

    「你有沒有過去表現很好的貼文、標題或腳本?或者你喜歡哪個帳號的文案風格?貼 1-3 個範例(或說『沒有』——我會根據 brand.md 來寫)。」

    • 提供範例 → 儲存到 projects/{name}/assets/style/copy-examples.md 並註冊(registerAsset '["{name}","style_references",...]'),以便未來重複使用。
    • 「沒有」 → 根據 brand.md 的語氣進行,並說明你做了哪些語氣假設。
  3. 若有範例,請在 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 中提取真實資料)。

相關技能