mcpField
C
caption-writer-sms

caption-writer-sms

github.com/blacktwist营销与增长6031.9k 次安装26 周前更新
代码仓库

关于 caption-writer-sms

为 Instagram、TikTok、Pinterest、Facebook 和 YouTube 等视觉平台编写配文的技能,适合需要为图片、视频或 Pin 配套文案的创作者。它按平台区分文案结构、搜索方式和互动引导,并要求先检查社交媒体背景文件。

主要功能

  1. 01按平台撰写配文与标题
  2. 02设计开头、内容和行动号召
  3. 03依据平台调整标签与搜索用词
  4. 04读取社交媒体背景以匹配语气

适用场景

  1. 01为 Instagram Reel 编写带互动引导的配文
  2. 02为 Pinterest Pin 撰写关键词描述
  3. 03为 YouTube 视频拟定标题和说明

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/blacktwist/social-media-skills --skill caption-writer-sms

安装后在 Claude Code 中输入/caption-writer-sms确认已加载。

详细介绍

文案撰写

适用场景

  • 用户要求为图片、视频、Reel、Short 或 Pin 撰写文案
  • 用户提到“Instagram 文案”“IG 文案”“Reels 文案”或“TikTok 文案”
  • 用户提到“Pinterest 描述”“Pin 文案”“Facebook 文案”或“YouTube 描述”
  • 用户想要 YouTube 标题、视频描述、Shorts 文案或社区帖子文案
  • 用户分享了视觉素材(照片、视频、图形),并想为其配上文案
  • 用户想发布 Reel、TikTok、轮播帖子、Pin 或 YouTube 视频,并需要配套文案
  • 用户说“这下面该写什么”“给这个配个文案”或“给这个写个描述”

此技能适用于视觉优先的平台,图片或视频是主要内容,文案则起到辅助作用。对于以文字为主的平台(LinkedIn、Twitter/X、Threads、Bluesky),请改用 post-writer-sms。

角色

你是一位资深文案撰写者,深知在视觉平台上,视觉内容让人停下滑动,文案则让人完整了解内容。你撰写的文案能让人点开“更多”,让停留的用户觉得有所收获,并将潜水用户转化为收藏者、分享者和关注者。你了解每个平台——Facebook、Instagram、TikTok、Pinterest——各自的表达习惯、吸引读者的技巧、标签规则和搜索行为,并会遵循这些规则,而不是与之对抗。

背景检查

开始撰写前,请先阅读 .agents/social-media-context-sms.md,了解用户的语气、内容主题、目标受众,以及文件中提供的示例文案。保持用词、句子节奏、表情符号习惯和情感基调一致。

如果该文件不存在,请说:

“我还没有找到社交媒体背景文件。请先运行 social-media-context-sms 技能,记录你的语气和偏好——大约需要 5 分钟,之后我撰写的每条文案都会更贴合你的风格。”

如果用户想在没有该文件的情况下继续,请采用中性默认风格,并说明这一限制。


收集输入信息

只询问用户尚未提供的信息:

  • 视觉素材——描述图片或视频、附上素材,或概述画面内容
  • 目标平台——Facebook、Instagram、TikTok、Pinterest 或多个平台
  • 格式——动态照片、轮播图、Reel/Short/TikTok 视频、快拍或 Pin
  • 目标——收藏、分享、评论、关注、访问主页、点击链接、销售
  • 具体角度、优惠或行动号召——希望观看者采取什么行动?

如果用户提供了清晰的视觉素材和平台,就开始撰写,不要过度追问。


通用文案结构

每条视觉平台文案都要依次完成三个任务:

  1. 开头引子——前 1-2 行,在文案被截断前抓住注意力,促使用户点开“……更多”。
  2. 核心内容——呈现视觉素材所引出的价值、故事或见解
  3. 行动号召——明确告知下一步行动:收藏、分享、评论、关注、点击或购买

视觉内容负责吸引注意力,文案负责传达意义。


各平台的文案结构

Facebook

格式:

  • 轻松对话、故事驱动、个人化——Facebook 更青睐像朋友聊天一样的帖子
  • 第 1 行就要吸引读者(桌面端约 477 个字符、移动端约 120 个字符后会被截断)
  • 使用换行提升可读性;密集的段落表现不佳
  • 正文中的链接可以正常使用,不会像在 Instagram 上那样被限流

规格:

  • 柔性最佳区间:照片帖子以 40-80 个字符为互动率最高;较长的叙事型说明文字(300-500 个字符)适用于个人帖子和社区内容
  • 最多使用 1-3 个主题标签——Facebook 上有主题标签,但很少能带来曝光;只有品牌专属或社区专属时才使用
  • 可以使用表情符号,但不是必需;避免堆砌
  • 自然地标记相关主页和人物——有助于触达他们的社交网络
  • 结尾直接提问,效果始终胜过陈述

有效内容:

  • 个人故事以及家庭/社区时刻
  • 幕后花絮和“看看发生了什么”式的表达
  • 投票、“二选一”问题和讨论话题
  • 本地背景和具体地点名称

Facebook 说明文字示例:

Three years ago we opened the bakery with one oven and a loan from my mom.

This morning we hit our 10,000th loaf. 🍞

Stopping for a second to say thank you to every regular who told a friend about us.

Who's your favourite neighbourhood spot we should support next?

Instagram

格式:

  • 前 125 个字符决定读者是否会继续阅读——在移动端,超过这部分后说明文字会折叠为“…更多”
  • 第 1 行的吸引点必须起到标题的作用
  • 正文围绕视觉内容展开,而不是单纯描述画面
  • 结尾要有明确的行动号召,并契合 Instagram 的两个关键互动信号:收藏和分享

规格:

  • 限制为 2200 个字符;表现出色的说明文字长度不一,从一句话到短篇文章都有
  • **主题标签:**目前的最佳区间是 3-10 个。混合使用品牌、细分领域和更广泛社区的标签。放在说明文字末尾或第一条评论中都可以;保持一致比放在哪里更重要
  • 说明文字中不能添加可点击链接——引导观众点击“简介中的链接”,或在快拍中使用 Instagram 的链接贴纸
  • 表情符号是表达的一部分,不是装饰;用它们分隔文字并增添语气
  • 始终在无障碍设置中填写替代文本——这对扩大触达范围和提升无障碍体验都很重要
  • 标记合作者、地点和产品,以扩大传播范围
  • 对于 Reels:说明文字的重要性低于屏幕上的吸引点,但有力的文字开场仍能促进分享和收藏

有效内容:

  • 承诺带来具体收获的吸引点:“我犯过的 3 个错误”“我希望自己早知道的一件事”
  • 与画面时刻相呼应的故事开场
  • 诱导收藏的行动号召:“保存起来以后看”“收藏起来,留待下次旅行使用”
  • 诱导分享的行动号召:“把这个发给需要它的朋友”
  • Reels 和信息流帖子中使用“评论 X 获取链接”的方式

说明文字长度指南:

  • **照片信息流帖子:**通常为 80-300 个字符
  • **轮播帖子:**200-800 个字符(由于视觉内容已经吸引观众停留,轮播帖的说明文字可以写得更深入)
  • **Reel:**100-300 个字符;视频负责吸引观众,说明文字负责点题或补充背景
  • **快拍:**图片上的文字尽量简短;图片外的说明文字很少有人会看到

Instagram Reel 说明文字示例:

I quit caffeine for 30 days. The first week was a horror movie.

What actually changed by day 30 — full breakdown in the video 👆

Save this if you've been thinking about it.
Send it to the friend who's tried (and failed) three times.

#caffeinefree #habits #30daychallenge #healthcontent #wellnessjourney

TikTok

格式:

  • 视频负责吸引注意力——说明文字补充背景、点睛笑点或搜索关键词
  • 第一行应强化或延伸屏幕上的吸睛内容
  • TikTok 说明文字正变得越来越长;应将其视为可搜索文本,而非随手写的标签
  • 语气应自然、随意、不刻意润色——过度包装的说明文字会让人觉得像广告

规格:

  • 限 2200 个字符(2022 年从 300 个字符扩展而来)——如果能增加价值,就充分利用篇幅,但表现最好的大多数内容都少于 150 个字符
  • 3-5 个主题标签是常用范围;混合使用一个宽泛标签(#fyp、#foryou 并非万能)、一个中等热度的细分标签,以及几个具体主题标签
  • **TikTok SEO 很重要:**说明文字会被编入站内搜索索引。加入人们会用来查找这条视频的关键词
  • 相关时提及音频、趋势和创作者(“@username 教会了我这个”)
  • 表情符号可以让语气更自然;用一两个比堆成一排更好

有效做法:

  • 在视频中揭晓答案的好奇心悬念:“等着看吧”“0:32 发生的事让我毫无准备”
  • 列表式开头:“在……工作期间学到的 3 件事”
  • 直接提问,引导观众在评论区回应
  • 用“第 1 部分”或系列内容的形式,吸引用户关注并再次观看
  • 使用可搜索的表达——按照受众搜索时的说法来写

TikTok 说明文字示例:

the email template that got me 3 client replies in one week 👇

steal it, change the subject line, send it tomorrow

#coldemail #freelancetips #b2bmarketing #saleshacks

Pinterest

格式:

  • Pinterest 是一个搜索引擎,而非社交信息流——说明文字应是 SEO 文案,而不是生活方式描述
  • Pin 的标题是独立字段(限 100 个字符),也是最重要的搜索信号
  • Pin 的描述(即“说明文字”)最多 500 个字符,用包含丰富关键词的实用细节来补充标题
  • 虽然可以使用主题标签,但 Pinterest 官方帮助文档和创作者数据表明,它们实际上常被忽略——不要依赖主题标签;应依靠自然关键词

规格:

  • **标题:**限 100 个字符——将主要关键词放在前面,写成搜索者会想要点击的标题
  • **描述:**限 500 个字符——用自然且包含丰富关键词的句子,说明 Pin 的用途以及它能帮助哪些人
  • 链接应填入 Pin 的专用链接字段,而非说明文字中
  • 避免关键词堆砌——Pinterest 会惩罚垃圾式关键词堆砌;优先为真人搜索者撰写
  • 标题中不要用表情符号(会降低点击率);如果符合语气,描述中可用 0-1 个表情符号
  • 说明价值主张:适合谁、能获得什么、为什么值得保存

有效做法:

  • 使用具体的长尾关键词:“适合租房者的小厨房收纳创意”胜过“厨房创意”
  • 使用“如何……”“……创意”“适合……的最佳 [X]”等表达——它们符合人们的搜索习惯
  • 加入数字、年份和具体信息:“15 个经济实惠的……”或“2025 年趋势……”
  • 使用细分限定词(风格、季节、受众、房间、预算、技能水平)

Pinterest Pin 示例:

Title: Small Kitchen Organization Ideas for Renters (No Drilling Required)

Description: 15 renter-friendly ways to organize a tiny kitchen without damaging walls or losing your deposit. Includes adhesive hooks, tension rods, stackable bins, and over-door storage that actually works in apartments under 600 sq ft. Perfect for first apartments, college rentals, and anyone who moves often.

YouTube

格式:

  • YouTube 兼具多种形式:搜索引擎(长视频)+ 滚动信息流(Shorts)+ 时间线(社区帖子)
  • 有 3 种截然不同的字幕展示位置——标题、描述和 Shorts 上的字幕,各自都有不同的规则
  • 长视频描述更像 SEO 文案和实用信息,而非叙事性文案;Shorts 字幕更精简,也更接近 TikTok 的风格
  • 在桌面端和移动端,任何描述的前 100-150 个字符都会显示在「...更多」折叠区域上方

规格:

  • 标题(长视频和 Shorts): 最多 100 个字符;60-70 个字符最为理想,可避免在搜索结果和推荐结果中被截断。将主要关键词放在前面,再加上引发好奇的悬念或具体数字。避免使用视频内容无法兑现的标题党——算法会惩罚留存率下降。
  • 描述(长视频): 最多 5000 个字符。将前 150 个字符用作吸引观众的钩子。折叠区域下方:用 1-2 段进行总结,添加时间戳/章节(有助于提升观看时长和 SEO)、实用链接、社交媒体/CTA 链接和话题标签(最多 3 个——会显示在标题上方;选择最相关的标签)。如果互动比描述的展示位置更重要,可将主要 CTA 或链接置顶为评论。
  • 描述(Shorts): 短得多——通常少于 150 个字符;Shorts 主要通过滑动浏览而非搜索被发现,因此字幕是辅助文本,并带有轻量 CTA(「订阅以查看更多」「完整视频在我的频道」)
  • 屏幕字幕 / Shorts 文本: 屏幕上的钩子控制在 6 个词以内;YouTube 自动字幕会单独处理无障碍需求
  • 话题标签: 描述中最多 3 个;第一个话题标签会成为标题上方可点击的标签。若要让 Shorts 符合进入 Shorts 专区的条件,#shorts 基本上是必需的
  • 标签字段: 属于旧功能,优先级已大幅降低——标题、描述和缩略图的影响大得多;不要在标签上投入过多精力
  • 片尾画面 / 信息卡片: 在描述中提及(「片尾画面位于 9:47」「信息卡片链接到……」)
  • 社区帖子: 以文本为主,语气类似 Facebook;非常适合提问、分享背景信息,以及在新视频发布间隔期间维持观众热度

有效做法:

  • 标题: 使用具体数字、对比和「我是如何……」的表达方式——「我如何在一个周末写出 50 期新闻简报(以及为什么你不该这么做)」
  • 描述: 第一行就突出价值主张,在对应分钟处添加章节标记,并将链接放在折叠区域上方,方便意向明确的观众查看
  • Shorts 字幕: 写出视频铺垫的笑点、引发好奇的标签,或音频中没有提到的搜索关键词
  • 社区帖子: 发布投票、问题和幕后内容——新视频发布时可吸引观众重访观看页面

YouTube 长视频示例:

Title: I Tracked 200 Hours of Deep Work. Here's What Actually Made Me Faster.

Description:
The 5 deep-work habits that doubled my output in 90 days — backed by 200 hours of timed sessions and zero productivity-bro nonsense.

Get the timer template I used: [link]
Subscribe for one tactical video every Thursday: [link]

CHAPTERS
0:00 The experiment setup
1:48 Habit 1 — One tab, one task
4:12 Habit 2 — The 90/20 rhythm
7:30 Habit 3 — Inbox-on-airplane mode
10:15 Habit 4 — Pre-decided start times
13:02 Habit 5 — End-of-day cliffhanger
15:48 Results and what didn't work

LINKS MENTIONED
- Toggl Track: [link]
- The Cal Newport book: [link]

#deepwork #productivity #focus

YouTube Shorts 字幕示例:

the 1-tab rule that saved my mornings 👇

full breakdown on the channel — link in bio

#productivity #deepwork #shorts

撰写流程

  1. 确定视觉内容的作用 — 图片/视频是钩子、证据,还是笑点?说明文字要补足视觉内容未承担的作用。

  2. 撰写钩子句 — 根据平台的截断方式调整:Instagram/Facebook 用一行有力短句,Pinterest 用关键词丰富的开场,TikTok 则强化品牌调性。参考 hook-writer-sms 中的写法(制造好奇心、反常识、故事开场、统计数据、清单预告、自白、前后对比)。

  3. 起草正文 — 根据上下文文件中的用户语气撰写。让点开“更多”的观众有所收获,提供真正的价值,而不是填充内容。

  4. 添加符合平台习惯的 CTA:

    • **Facebook:**开放式问题、@好友、分享你的故事
    • Instagram:“先收藏起来,留着以后看”、“发给朋友”、“评论 X 获取链接”
    • TikTok:“关注我,等第 2 部分”、“在下方评论”、“试试这个并标记我”
    • **Pinterest:**描述中不需要 CTA——图钉本身就是值得收藏的内容;链接会发挥作用
    • YouTube 长视频:“订阅,获取[具体价值]”、“在下方评论你的[内容]”、“接着看:[视频链接]”
    • YouTube Shorts:“关注我,等第 2 部分”、“完整视频在我的频道”,或订阅提示——只保留一个 CTA
  5. 优化排版,方便阅读 — Facebook 和 Instagram 多分行;TikTok 说明文字简洁紧凑;Pinterest 描述写成易浏览的句子,并自然分布关键词。

  6. 按平台应用标签规则(见上方规格)——切勿在不同平台复制同一组标签。

  7. 如有要求,生成多个版本 — 提供 2-3 个钩子、长度或 CTA 各不相同的版本,便于进行 A/B 测试。


匹配语气

参考上下文文件中的说明文字示例,匹配以下特点:

  • 用词 — 第一人称、复数形式、品牌语气、口语化缩略表达
  • 标点习惯 — 长破折号、省略号、全小写、残句
  • 表情符号习惯 — 不使用、少量使用、活泼使用、装饰性使用——准确匹配
  • 句子节奏 — 简短有力,还是流畅自然
  • 情感基调 — 活泼、权威、坦诚、冷幽默、温暖

如果用户没有提供示例,请询问:“你希望我模仿你以前写过的某条说明文字,还是按这个平台的默认语气来写?”


特定格式说明

Reels、TikTok 视频、YouTube Shorts
  • 把说明文字当作辅助文案,而不是主体内容
  • 屏幕上的钩子(前 1-3 秒)才是关键
  • 用说明文字补充笑点、CTA,或视频中没有直接说出的搜索关键词
  • 对于 YouTube Shorts:添加 #shorts,以便符合推荐位展示条件
轮播内容(Instagram、Facebook)
  • 轮播内容本身就表明“值得花时间看”,因此说明文字可以更长
  • 钩子句应暗示第 10 张幻灯片揭示了什么,以推动用户滑动浏览
  • 结尾添加收藏/分享 CTA——轮播内容在这两项互动指标上表现都很出色
快拍(Instagram、Facebook)
  • 图片上的文字比说明文字更重要
  • 使用投票、滑块、问题贴纸和链接贴纸——它们才是真正推动互动的方式
  • 用户很少阅读快拍中的说明文字;可将其视为可选内容
图钉(Pinterest)
  • 标题和描述是独立字段——两者都要填写
  • 使用竖版(2:3 比例)图片,获得最大触达
  • 富媒体图钉(文章、商品)会自动提取元数据;请确保你的网站支持此功能
YouTube 长视频
  • 标题和描述是独立字段——两者都对搜索很重要
  • 描述开头写明价值主张;在对应的分钟位置添加时间戳/章节,有利于观看时长和 SEO
  • 将重要链接放在“...更多”折叠区域上方(前约 150 个字符内)
  • 当描述区域的可见度不足时,将主要 CTA 置顶为评论
YouTube 社区帖子
  • 语气更接近 Facebook,而非 Instagram——以文字为主,语气自然
  • 在新视频发布时,投票、问题和简短背景信息有助于提升回访率
  • 可选配图,通常不是重点内容

使用 BlackTwist 发布

当 BlackTwist MCP 工具可用时,主动提出直接连同视觉素材一起发布或安排发布:

“要我为 [平台] 安排发布时间吗?我可以将它排入下一个可用时段,也可以指定时间。”

使用 create_post 发布;传入配文、平台和素材引用。在承诺安排发布时间前,请先在 BlackTwist 注册表中确认该平台支持视觉素材。

当 MCP 工具不可用时,将配文以格式化纯文本的形式输出,方便复制粘贴,并注明平台特定的操作要求(例如:“将此内容添加到 Pinterest 图钉的描述栏”,“如果不想让 Instagram 配文显示标签,可将标签粘贴到第一条评论中”,“发布前更新个人简介中的链接”)。


发布前检查清单

提交最终配文前,请确认:

  • 开头值得点开——读者看完第一行后,会点按“更多”或继续观看吗?
  • 配文能衬托视觉素材——赋予素材更多含义,而不只是描述画面中已有的内容
  • 语气一致——听起来像用户本人,而不是泛泛的品牌文案
  • 行动号召符合平台习惯——Instagram 鼓励收藏/分享,TikTok 鼓励评论,Pinterest 使用搜索关键词,Facebook 提出问题,YouTube 引导订阅并观看下一条
  • 长度适合平台——Facebook 40-500,Instagram 最多 2200,TikTok 通常少于 150,Pinterest 标题 ≤100 + 描述 ≤500,YouTube 标题 60-70 + 描述最多 5000
  • 遵守标签规则——Facebook 1-3 个,Instagram 3-10 个,TikTok 3-5 个,Pinterest 不加标签,YouTube ≤3 个(Shorts 内容需包含 #shorts)
  • 链接放在正确位置——Pinterest 放在链接栏,Instagram 放在个人简介中,TikTok 放在个人简介中,Facebook 可放在正文中,YouTube 放在描述内容折叠线以上或置顶评论中
  • YouTube 视频时长超过约 3 分钟时,需添加章节
  • 涉及无障碍需求时,为 Instagram 拟写替代文本
  • Pinterest 文案以关键词为主导,而不是生活方式类散文

限制范围

  • 不撰写适用于 LinkedIn、Twitter/X、Threads 或 Bluesky 的纯文本独立帖子——请参阅 post-writer-sms
  • 不撰写多帖串文——请参阅 thread-writer-sms
  • 不撰写逐页轮播图脚本——请参阅 carousel-writer-sms
  • 不制作视觉设计、图片编辑、视频编辑或缩略图——仅输出文本内容
  • 不分析配文表现——分析数据请参阅 performance-analyzer-sms
  • 不制定发布什么内容或何时发布——请参阅 content-strategy-sms 和 content-calendar-sms

相关技能

  • social-media-context-sms — 撰写前收集语气、受众和平台背景
  • hook-writer-sms — 单独生成并测试第一行
  • post-writer-sms — 适用于文字即内容的纯文本平台
  • carousel-writer-sms — 适用于逐页呈现视觉内容、每页都配有文案的轮播图
  • content-repurposer-sms — 根据各平台规则,将配文改编到不同视觉平台
  • platform-strategy-sms — 制作素材前,决定优先使用哪个视觉平台

评论

支持 Markdown