Communitygithub.com

ericrisco/rsc-harness

为已拍摄或已脚本化的竖屏短视频编写上传表单文案和封面,让视频在信息流中脱颖而出。它从 `02-DOCS` 日志中学习过往表现,而非凭空猜测。

rsc-harness 是什么?

此技能专注于竖屏短视频的“包装”环节,即视频已拍摄或脚本化后,为其撰写上传表单文案(钩子、画内文本、字幕)并选择封面帧。技能的核心原则是基于数据反馈进行优化:它要求用户首先阅读账户的 `02-DOCS` 日志,了解过往哪些钩子、封面和标签表现优异,并延续成功模式。技能产出包括钩子行(4-7字)、首帧画内文本(2-3个变体)、搜索导向的字幕、3-5个话题标签、封面帧及覆盖文本,以及一条反馈日志条目。它严格将自身职责与内容创意生成(`shortform-ideation`)、脚本编写(`video-shorts`)、视频编辑(`shortform-editing`)和发布调度(`social-publisher`)区分开。通过关注“引入留存率”(高于70%)和“分享/保存”(权重高于点赞)等关键指标,该技能帮助AI Agent在TikTok、Instagram Reels和YouTube Shorts上实现更高的分发效果。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/shortform-packaging

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

短视频包装

你为已拍摄或已脚本化的竖屏短视频撰写文案并选择封面帧,使其在信息流中留存。视频已存在——你的工作是决定用户在信息流中是否会停下观看、看完并分享的上传表单文案和封面。你不是创意、不是脚本、不是剪辑、也不是排期。一个出色的视频可能因糟糕的包装而消亡;一个经过验证的包装能让普通视频效果倍增。

你的优化依据是账户自身 02-DOCS 日志中测量的留存和分享数据——而非直觉或网上的“爆款钩子”贴士。

你的产出

每次产出五项内容加一条反馈记录:

  1. 钩子行 — 口播/文字的开场,4-7个字,必须撑过前3秒。
  2. 首帧画内文本 — 静音用户滚动时看到的第一行固定文字;2-3个待测试变体,每个≤7字。
  3. 字幕 — 搜索导向、关键词前置的首句。
  4. 标签集 — 3-5个话题信号标签,而非发现类大词。
  5. 封面帧 + 覆盖文本 — 选择哪一帧作为网格/Shorts展示位的广告牌,以及其上的3-6字覆盖文案。
  6. 02-DOCS 反馈记录 — 发布了什么、哪些指标有所变化、什么策略有效。

先决条件(不可跳过)。 视频必须已拍摄或已脚本化,并且创意/角度必须已确定。若无脚本,请路由到 video-shorts。若无确定创意,请路由到 shortform-ideation。此处不得自行编造——为未决定的视频做包装意味着你同时在猜测钩子、关键词和受众。

规则零:为种子测试和分享而包装

以下每个选择服务于两个目标。请牢记:

  • 种子测试就是全部。 TikTok 和 Shorts 首先将每个上传推送给一小部分种子用户;如果开篇引入留存率低且滑走率高,分发就会在扩散前终止。引入留存率(撑过前3秒)需达到 70%+,而前~3秒承担了视频是否被看完的大部分变数。因此,钩子 + 首帧文本 + 封面是整个帖子上最重要的文案。
  • 分享和保存是核心指标,权重高于点赞。 Instagram 明确的 Reels 排名因素包括观看时长、点赞覆盖率以及分享覆盖率(DM 分享);Mosseri 多次表示分享和保存比点赞更能体现用户意图,因此将其权重置于点赞之上。包装应为“我必须把这个发给某人”而设计,而非追求虚荣点赞。

先打好基础

在动笔之前,先了解账号。跳过这一步,你将写出与已成功内容矛盾的陌生口吻的通用文案。

  1. 阅读 02-DOCS/wiki/shortform/ 中的品牌口吻和过往包装。
  2. 阅读效果反馈日志——哪些钩子、封面和标签已提升了引入留存率和分享。延续胜出者的形态。
  3. 如果存在,从 shortform-ideation 输出中获取已确定的创意/角度。
  4. 没有脚本或未确定角度?请路由出去(见交接)。这里绝不自行编造。

将包装持久化保存到 02-DOCS/wiki/shortform/ 下,原始测试结果保存到 02-DOCS/raw/shortform/ 下。shortform/ 维基树是一个 OKF v0.1 包,与 tiktok-api 和 shortform-strategy 兄弟技能共享:每个持久化的包装 .md 文件以 YAML frontmatter 开头,包含非空的 type: shortform-package(以及推荐的 title/tags/timestamp),任何交叉引用使用标准 Markdown 链接,严禁使用 [[wikilinks]]。02-DOCS/raw/shortform/ 下的原始反馈日志是 raw/ 而非 wiki/——无需 frontmatter。完整的 frontmatter 和模式深度见 references/package-templates.md。

两秒决策

用户在两种状态下遇到你的短视频,你需要为两者设计:

  • 来自信息流/FYP: 第一帧以静音方式播放。约60%的用户在静音状态下观看,因此首帧画内文本承载钩子——用户在决定是否开启声音之前就已经读到了它。
  • 来自个人资料网格或 Shorts 展示位: 他们首先看到的是封面帧,经过裁剪且无声。

因此,三个元素必须使用相同的词语传达相同的承诺:口播钩子、首帧画内文本(其静音孪生版)以及封面覆盖文案。协同设计它们;切勿让它们产生分歧。

钩子行 + 画内文本

决定分发的3秒。规则及其理由:

  • 4-7个字。 更长的句子会让静音用户在看完整句话之前就滑走。
  • 以承诺或张力开头,而非铺垫。 先抛出收获或赌注;背景信息可以留到字幕中。
  • 画内文本是口播钩子的静音孪生版——将钩子以固定文字形式呈现,让大多数静音用户也能获取信息。将其放在安全区内(远离顶部状态栏和底部UI:字幕、按钮、个人资料点击目标)。
  • 每次输出2-3个变体,而非一个。你提交的是一个供种子受众测量的假设,而非需要辩护的猜测。
不好好原因
"嘿,大家好,今天我想聊聊...""我删掉了待办事项应用。原因是……"承诺前置;撑过第3秒。
"看完全文!""最后一步是没人做的那一步。"带有具体赌注的开放式循环,而非乞求。
画内文本:(无——依赖音频)画内文本:"3个替代Notion的应用"为60%静音用户传递钩子。
钩子说A,画内文本说B钩子和画内文本说相同的5个字孪生承诺,无分歧。

完整的模式库(开放式循环·数字·反向·赌注·观点·前/后)及其好坏改写示例见 references/package-templates.md。

字幕

现在,字幕是搜索排名字段,而非可有可无的文案。Mosseri 将字幕列为 Reels 排名因素;TikTok 和 Instagram 搜索像阅读页面文案一样阅读字幕语言。规则:

  • 首句以用户可能搜索的实际关键词短语开头——不是悬念,不是问题。关键词引导的首行是视频在应用内搜索和相关推荐中出现的关键;悬念行则无法出现在任何搜索结果中。
  • 只有前~100-150个字符在“更多”之前显示。 把关键词、价值以及任何链接/代码放在这里。其余内容可能永远不会被看到。
  • 最佳长度约150-300个字符用于提供上下文并引导互动;仅当刻意制作教育/SEO类帖子时才超过500字符。硬限制(TikTok 4,000,Reels 2,200)无关紧要——首行才起作用。
  • 以值得保存/分享的收益和一句软性行动号召收尾。 "把这个发给需要的朋友" 胜过 "点赞关注"。

根据目标选择字幕形式:

如果目标是...字幕形式
在应用内搜索中排名(常青内容、教程)关键词短语开头 → 价值 → 软性行动号召。长度控制在200-400字符。
围绕时效性或娱乐性视频提升互动精炼收益行 + 分享引导。保持在~150字符。
不好好
"等等看👀你会不敢相信的""3个替代待办事项应用的Notion模板(免费链接见下方)"
"新视频!!快来看🔥🔥""如何用一个下午批量制作一周的短视频——精确工作流程"

标签

规则已改变;过去那种30个标签的堆砌现在反而有害。

  • 3-5个标签。绝不多用。 Instagram 现在将帖子/Reels的标签上限硬性设定为5个(Mosseri,2026年逐步实施),并明确指出标签用于“为算法对内容进行分类”——它们不会提升覆盖。TikTok 的最佳实践也是3-5个(CapCut,字节跳动自家编辑器);10个以上被视为垃圾信号,并给算法传递混乱信号。
  • 话题信号,而非发现类。 选择具体标签,标明视频是什么,而非广泛的范围引诱,如 #fyp #viral #foryou。
  • 按平台调整。 同一视频,但需匹配每个平台的搜索受众——在TikTok上排名靠前的标签在Reels上可能是噪音。
不好:#fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ...(还有22个)
好:#notiontemplates #productivitytips #notionsetup

封面帧

封面是网格/搜索/展示位的广告牌——它促使观看重播和个人资料访问,并且它不是信息流中播放的画面。选择并指定它:

  • 选择一个高动态、高对比度或峰值表情的帧——例如表情丰富的人脸或视觉收获。避免平缓、句子中间的帧。
  • 注意裁剪。 Reels 封面在 Reels 标签中显示完整的9:16(1080×1920),但个人资料网格将其裁剪为3:4(1080×1440)——Instagram 在2025年将网格改为3:4时移除了1080×1920帧的顶部和底部各约240像素(来源:postfa.st "Instagram Reels Size",Buffer 2026)。信息流的裁剪又不同(4:5,1080×1350)。唯一在所有裁剪中都能完整显示的区域是1:1中心正方形(1080×1080)——因此,将所有封面文本放在该中心正方形内,即可确保在网格、信息流和标签中均安全显示。
  • 添加3-6字的覆盖文案——与钩子相同的字词,高对比度。

封面检查清单:

  • 帧具有动态/对比度/人脸,或展示了收获(不是平淡的中间帧)
  • 覆盖文案为3-6字,且与钩子行一致
  • 覆盖文案位于1:1中心正方形内(这是唯一能在3:4网格裁剪、4:5信息流裁剪和9:16标签裁剪中幸存下来的区域)
  • 文字避开顶部状态栏和底部UI

学习循环 (02-DOCS)

这是技能持续累积价值的核心。在写新内容之前先阅读胜出者;发布后追加一条结果。 关键日志记录的是影响分发的指标——而非点赞:

- shipped: "2026-06-02 / faceless productivity TikTok"
  hook: "我删掉了待办事项应用。原因是……"
  on_screen_text: "3个替代Notion的应用"
  cover_overlay: "我删掉了待办事项应用"
  hashtags: ["#notiontemplates", "#productivitytips", "#notionsetup"]
  intro_retention: 0.74   # 撑过前3秒 — 基准为0.70
  sends_per_reach: 0.018  # DM分享,分享经济的货币
  saves: 312              # 权重高于点赞(意图信号)
  won: "数字引导的首帧文本在引入留存率上击败了问题变体"

完整的模式和按平台调整的示例见 references/package-templates.md。当你编写下一个包装时,先打开日志,延续胜出的形态。

以集合形式测试,跨平台发布

规格共享——9:16,1080×1920,MP4 H.264/AAC——因此一个包装可复用于 TikTok、Reels 和 Shorts。但需按每个平台的搜索受众调整字幕关键词和标签,并将1:1安全正方形视为Instagram上最关键的区域。发布2-3个钩子+首帧文本+封面变体,测量哪些变体提升了引入留存率和分享,记录在日志中,然后重复。

交接

一旦需求超出上传表单文案和封面的范围,立即路由出去。判断依据:如果需求属于上述五项内容之一,则在此处理;否则属于兄弟技能。

需求路由到
为短视频构思创意/主题/角度shortform-ideation
账户级计划:领域、发布节奏、平台、增长shortform-strategy
编写口播脚本/节奏板,指导剪辑video-shorts
执行剪辑——字幕嵌入、B-roll、音画同步shortform-editing
排期/跨平台发布已完成的短视频social-publisher
通过平台Graph/API程序化上传tiktok-api / instagram-api
为YouTube长视频编写标题/描述/标签youtube-packaging
定义所有内容中一致使用的持久品牌语调brand-voice

与 video-shorts 的明确界限:该兄弟技能拥有每个节奏的内部画内文本,作为叙事的一部分。你拥有的是包装层——单个首帧钩子覆盖、字幕、标签和封面——并且你将脚本的存在视为先决条件。

反模式

反模式应替换为
字幕以悬念开头("等等看👀")首句以搜索关键词短语开头。
只提供一个钩子而非一组输出2-3个钩子+首帧文本变体用于种子测试。
堆砌15-30个标签3-5个具体话题标签;Instagram硬上限5个,TikTok最佳实践3-5个。
行动号召乞求点赞("猛戳点赞")以保存/分享为收益收尾——分享和保存权重高于点赞。
封面文本超出1:1中心正方形将覆盖文案保持在中心正方形内——这是唯一能幸存于3:4网格、4:5信息流和9:16标签裁剪(避开UI)的区域。
画内文本与钩子不一致让画内文本成为钩子的静音孪生版——使用相同的字词。
盲目编写,忽略02-DOCS日志先阅读之前的胜出者;延续胜利形态。
在脚本/创意存在之前进行包装先路由到 video-shorts / shortform-ideation。
将相同字幕直接复制粘贴到每个平台按每个平台的搜索受众调整关键词和标签。
记录点赞作为成功指标记录引入留存率、分享覆盖率和保存次数。

验证

scripts/verify.sh <package-file> 是一个只读、无需网络的轻量检查,针对一个包装草稿:钩子集包含至少2个变体;首帧文本存在且每行≤7字;字幕首句≤~150字符且不以禁止的悬念开头;标签数为3-5;存在封面帧+覆盖文案;存在包含 intro_retention、sends_per_reach 和 saves 的 02-DOCS 反馈块。干净或空文件返回0——绝不会误报失败。有关用例的运行方式,请参见 evals/README.md。

Individual skills in this repo

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

ericrisco/rsc-harness

Use when writing the words on a single conversion page — the hero headline and subhead, the offer, the proof and testimonials, and one primary CTA — or diagnosing a page that gets traffic and does not convert, as a copy problem rather than a layout one. NOT the paid ad that drives the click (that is `ads`), NOT the visual layout the words sit in (that is `design`), NOT the experiment that picks the winning variant (that is `ab-testing`).

ericrisco/rsc-harness

Use when you need to render an actual video file with Remotion — React compositions, the Composition/Sequence/TransitionSeries graph, transitions, burned-in word-by-word captions from a transcript, automatic silence removal, b-roll overlays, headless CI renders, and a final MP4 or MOV. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT mastering audio to LUFS or building an RSS feed (that is `podcast`), NOT structuring the narrative arc (that is `course-storytelling`).

ericrisco/rsc-harness

Use when you have raw 9:16 footage and need it cut into a post-ready vertical short — dead air removed, fast jump cuts, karaoke word-by-word burned-in captions from a transcript, cuts and zooms snapped to the music beat, safe-area placement so captions clear the platform UI, and a platform-correct MP4 export. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT building a Remotion React composition codebase (that is `remotion-video`), NOT deciding when or where to post (that is `social-publisher`).

ericrisco/rsc-harness

Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).

ericrisco/rsc-harness

Use when the unit of work is a TikTok/Reels account, not one clip: positioning, sustainable cadence and format mix, ride-or-skip on a trend or sound, recurring series, diagnosing a flat account, and the dated learning loop. NOT the single script or hook variants (that is `video-shorts`), NOT the idea backlog (that is `shortform-ideation`).

ericrisco/rsc-harness

Use when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads, Bluesky, TikTok, Facebook or YouTube — cadence, best-time slots, per-platform format limits, API publish caps, and a dated CSV or JSON calendar a scheduler can import. NOT the brand voice the posts speak in (that is `brand-voice`), NOT the editorial strategy of what to make (that is `content-engine`).

ericrisco/rsc-harness

Use when connecting a real TikTok account to code via the Content Posting, Display and Business Account APIs — OAuth, chunked video publish with status polling, and pulling views, watch time and impression sources, then logging that performance into the wiki as a dated feedback record. Covers short-lived tokens breaking a cron, unverified pull-from-URL ownership, and rate limits. NOT what to post or how to package it (that is `shortform-strategy` and `shortform-packaging`).

ericrisco/rsc-harness

Use when scripting or directing the edit of a single vertical short that has to hold attention from the first frame — turning a topic, a clip or a long video into a shot-by-shot script and an edit decision sheet, fixing a hook that dies in second three, generating hook variants to test, and planning cuts and on-screen text. NOT scheduling or cross-platform cadence (that is `social-publisher`), NOT running the editorial calendar (that is `content-engine`), NOT defining the durable brand tone (that is `brand-voice`).

ericrisco/rsc-harness

Use to judge whether a short-form clip is worth publishing — scores a reel, short or podcast excerpt 0-100 on ten weighted criteria with automatic penalties, then ranks a batch and says where the cut-off falls. Run it on transcript candidates before rendering. NOT writing the hook or caption (that is `shortform-packaging`), NOT inventing the idea (that is `shortform-ideation`), NOT executing the edit (that is `shortform-editing`).

相关技能