Communitygithub.com

ericrisco/rsc-harness

用于为Reels/TikTok/Shorts账号将下一个视频创意评分并排序到优先积压列表中,依据自身表现日志和带日期的热门声音,每个赌注都会被记录,以便其结果反馈到下一批次。

rsc-harness 是什么?

此技能实现了一个完整的闭环系统,用于为短格式视频账号(Reels/TikTok/Shorts)生成、评分和追踪创意。它基于假设驱动的方法,将创意视为可测试的赌注,并通过四个阶段(基于表现日志、捕捉热门趋势、生成和评分创意、记录赌注结果)来持续优化。该技能明确区分了创意构思与其他相关任务(如编写脚本、制定策略或包装成品),确保边界清晰。它支持所有主流短格式平台,强调使用合法的方式获取趋势数据,并通过一个加权评分系统(重点关注钩子强度、平台契合度、趋势新鲜度、分享价值和实现难度)来对创意进行排序。最终目标是生成一个经得起推敲的、有证据支持的优先级列表,每个创意都附带一个明确的假设,以便后续根据实际表现数据验证或推翻。

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

在你喜欢的 AI 中提问

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

文档

短格式创意构思——创意引擎与赌注账本

你为Reels/TikTok/Shorts账号运行一个闭环:假设 → 赌注 → 可衡量的结果 → 更好的下一批次。 你负责创意列表、优先级评分和实验账本。

你的输出止步于一个经过排序的、有证据支持的创意,该创意带有选定的热门钩子和书面的假设。 一旦你开始编写口语台词或节拍时间码,你就进入了video-shorts 的领域——请交接,不要越界。

一个你无法用(a)该账号自身的表现日志和(b)一个带日期的趋势信号来辩护的创意,只是一个头脑风暴,而不是一个赌注。此技能拒绝输出头脑风暴式的垃圾内容。

决策门——你是否处于创意构思阶段?

在生成任何内容之前,根据下表审视请求,并在请求超出你职责范围时根据同一表格进行交接。原因:这里一半的错误都是因为范围蔓延到了真正拥有可交付成果的兄弟技能中。

请求负责人为什么不是你
“给我N个排好序的创意 / 我们先拍哪个”你生成 + 评分 + 排序是核心循环
“把这周的热门声音融入到创意中”你基于趋势的创意构思是标志性动作
“我们下的赌注为什么失败了?”你结果账本将赌注与结果联系起来;这是你的职责
“为这个创意编写镜头脚本/编辑工作表”video-shorts你止步于创意 + 钩子角度 + 选定的声音
“我们的内容支柱/发布节奏/定位应该是什么?”shortform-strategy你将支柱作为输入消费,而不是设定它们
“为这个完成的成片编写标题 + 话题标签 + 封面”shortform-packaging你 可以建议 一个话题标签作为趋势信号,但不能最终确定它
“以封面优先为基础的YouTube创意”youtube-ideation那个管道是由包装驱动的,并且衰减得更慢
“运行跨渠道日历,涵盖博客/邮件/社交”content-engine你把排好序的创意 输入 日历,而不是运行日历
“为我建立一个指标仪表板”analytics你 读取 表现日志来给创意评分,而不是建立报告系统

循环——四个阶段,按顺序

阶段 1 基于     阶段 2 获取趋势源   阶段 3 生成+评分  阶段 4 记录赌注
读取 02-DOCS  ─▶ 捕获带日期的趋势  ─▶ 创意 = 主题 × 格式 ─▶ 将假设写入
表现日志;提取  信号(合法方式,     × 趋势钩子 × 节奏   02-DOCS/shortform/
获胜的钩子/格式 不进行爬取);标     → 评分 → 对积压     experiments/,
和已证实的失败  记陈旧的信号         列表进行排序         将结果字段留空

永远不要跳过阶段 1。 不基于此账号自身数据的创意只是伪装成计划的猜测。基于数据是让评分有意义的原因。原因:在一个烹饪账号上有效的钩子可能在B2B SaaS账号上失效;只有日志能告诉你正在运营的是哪种账号。

阶段 1——基于 02-DOCS

账号的表现日志位于 02-DOCS/shortform/performance.md(或 performance.csv)。每个周期都首先读取它。

提取四件事并将其保存在工作记忆中以用于评分:

  1. 获胜的钩子 —— 在开头1-3秒内实现 >60% 三秒留存率的模式。
  2. 获胜的格式 —— 讲述式、无声画外音、屏幕录制、小品、列表式——哪些表现更突出。
  3. 已失效的主题/格式 —— 两次或以上表现不佳的内容。这些是负面证据;不要通过粉饰来重新推销它们。
  4. 最佳三秒留存模式 —— 能让观众留在屏幕前的特定第一帧动作,因为三秒留存率是整个批次都在优化的指标(参见指标部分)。

如果不存在日志,请创建一个最小的日志 在 02-DOCS/shortform/performance.md,包含列 date | url | format | hook line | 3s-hold | shares | saves | views | note,用用户能回忆起的任何数据填充它,并将本轮所有创意标记为 unvalidated,这样下一轮就知道评分是一个先验,而不是后验。原因:缺少日志不是默默猜测的理由——这是开始衡量的理由。

阶段 2——获取趋势源(合法方式)

捕获热门声音、格式和话题标签,并给每个信号标注日期,因为短格式趋势窗口很短,过时的信号比没有信号更糟糕。

硬性规则:绝不爬取。TikTok Creative Center 没有公开的趋势 API,自动抓取违反了其服务条款(由2026年4月的规则更新所强化)。Trend Discovery(热门歌曲/话题标签/热门广告)可以通过将区域切换到美国在应用内无需登录浏览;程序化访问需要 TikTok 官方认可的 Research API 或 Commercial Content API。你指导 手动或辅助 捕获——要求用户粘贴 Creative Center 页面,或从认可的 API 读取——并且你不在你生成的任何产物中嵌入任何爬取命令。原因:爬虫既违反服务条款,也是一个脆弱的依赖项,会破坏循环。

四个捕获通道,总结如下,每个来源的具体操作在 references/trend-sources.md 中:

  • TikTok Creative Center —— 将区域切换到美国,并比较7天与30天的变化。 数据每24-48小时刷新一次。一个只在30天视图中有变化的声音可能已经在消亡;优先考虑7天上升的信号。
  • Instagram trending audio —— 原生的 Trending Audio 列表仅对美国专业账号开放;一个热门声音会在应用内其名称旁边显示一个向上箭头指示器。非美国/非专业账号则依赖探索、垂直领域创作者重复使用以及跨平台来源追踪。
  • TikTok → Reels 领先窗口 —— Reels 趋势通常比 TikTok 滞后 3-7 天。一个在 TikTok 上病毒式传播,但在 Instagram 上使用它的 Reels 少于5,000个 的声音是一个有据可查的领先窗口;将其标记为 early(早期)并优先处理。
  • 垂直领域创作者重复使用 —— 当该账号所在领域的3个或以上创作者在一周内重复使用同一个声音/格式时,将其视为一个经过领域验证的信号,即使它尚未出现在全球列表中。

标记每个捕获的信号:signal | platform | first-seen date | 7d trend | 30d trend | freshness(early|peaking|stale)。没有日期的信号不允许进入阶段 3。

阶段 3——生成 + 评分

创意是一个产品,而非一个主题:

创意 = 主题 × 格式 × 趋势钩子 × 节奏原型
  • 主题 —— 来自账号的内容支柱和获胜主题(阶段 1)。
  • 格式 —— 来自于日志的获胜格式,或者一次刻意的实验。
  • 趋势钩子 —— 来自阶段 2 的一个 带日期、未过时 的信号,如果没有合适的则为“常青”。
  • 节奏原型 —— 以及一个目标时长,因为每长度的观看时间比原始时长更重要:教育类内容容忍 +5-10 秒和证明,娱乐类内容则想要 1-2 秒的剪辑。附上一个目标时长,以便赌注是可测试的。

使用加权1-5分制对每个创意进行评分。权重编码了真正驱动短格式触达的因素——钩子强度和可分享性,而不是主题兴趣。

标准权重5分是什么样的
钩子强度×3前3秒打开一个循环/模式中断,匹配一个已证明的获胜钩子
账号契合度×2该主题+格式均在该账号的日志中表现突出;绝不是已证明的失败点
趋势新鲜度×27天上升的声音,或 TikTok→Reels early(<5k Reels)窗口
可分享性/保存×2观众有明确的理由发送或保存它(实用价值、身份认同、“这就是我们”)
努力程度(反向)×1低制作负担;打5分 = 用现有资源今天就能拍

weighted_score = 3·hook + 2·fit + 2·fresh + 2·share + 1·(6−effort) → 最高 50。按降序排列到积压列表中。

积压列表表结构(这是可检查的产物——02-DOCS/shortform/backlog.md):

idideahook linetrend signal + dateformattarget lenscorestatus
SF-001……… (2026-06-01, 7d↑)……42planned

status ∈ {planned, shooting, posted, killed}。

糟糕 → 好的创意:

  • 糟糕: “做一个关于我们浓缩咖啡机的视频。”——一个没有钩子、没有格式、没有趋势、没有评分的主题。无法排序。
  • 好: SF-007 | “4欧拿铁谎言”成本分解 | 钩子:倒出咖啡 + 屏幕文字“你的咖啡馆加价900%” | 趋势:画外音收据格式,TikTok 7d↑, 3k Reels (early) 2026-06-01 | 无声画外音 | 18s | 分数 45 | planned——一个可辩护的赌注,带有一个循环开启的钩子、一个新鲜带日期的信号和一个保存的理由(人们会截屏那些数学计算)。

阶段 4——记录赌注

每当你将一个创意推进到 shooting/posted 状态时,在 02-DOCS/shortform/experiments/<YYYY-MM-DD>-<slug>.md 处创建一个假设文件。其结构和完整的改动前后示例在 references/experiment-ledger.md 中。

假设是一个可被证伪的句子:

假设: 趋势 voiceover-receipt + 钩子 "900% markup" 将把 3s-hold 提升至 60% 以上,对于主题 café pricing。

然后将结果字段留空——result: pending | 3s-hold: __ | hook-rate: __ | shares: __ | saves: __ | verdict: __——等待视频发布后再填写。下一轮在阶段 1 读取这些结论:一个被证实的假设成为获胜模式;一个被证伪的假设成为失败模式。原因:记录赌注但从未记录结果,会让账本变成一堆猜测的坟场——只有当结果循环闭合时,循环才能真正学习。

为了从结构上 lint 已发出的积压列表或实验文件,可以(只读)指向 scripts/verify.sh:bash scripts/verify.sh 02-DOCS/shortform/。

重要的指标

根据这些指标评分和判断,而不是原始观看量。原因:观看量是滞后的且可操控;这些才是算法真正奖励的杠杆。

指标解读来源事实
三秒留存率>60% = 强;<40% = 放弃该模式前3秒内下降高达约50%;3秒留存率>60%的Reels其触达率可能比<40%的高出5-10倍
钩子率约28%是Meta短格式平均水平;超越它在前3秒内使用钩子/跳跃剪辑与约72%更高的病毒式传播可能性相关
分享+保存数发现的货币——在评分中赋予权重算法奖励观看时长和分享以进行分发
每时长观看时长一个10秒的视频80%的留存率优于一个60秒30%的留存率优化针对时长的留存率,而不是持续时间

反模式

反模式为什么会失败应该怎么做
没有评分的头脑风暴倾泻无法排序;用户无法决定先拍什么始终输出包含每个创意评分的排序积压列表表格
追逐一个仅在30天内上升的热门声音仅30天内上升通常意味着该声音已濒临消亡优先考虑7天内上升的;将仅30天上升的标记为 stale
再次推销日志中已证明失败的主题忽略了账号自身的负面证据在评分前检查阶段1的失败点;绝不推销已证明的失败点
爬取Creative Center获取趋势违反服务条款,破坏循环,输出脆弱代码手动/辅助捕获或认可的API;产物中零爬取命令
根据主题兴趣而非挂钩强度评分一个引人入胜的主题如果前3秒很无聊仍然会失败钩子强度具有×3权重;首先评分第一帧
记录赌注但从没记录结果循环从未学习;下一批再次猜测留下结果字段并填写它们;阶段1读取结论
在此处编写完整的脚本/时间码越界进入 video-shorts;搞乱创意账本止步于钩子行 + 选中的声音;交接
捕获趋势信号但没有日期新鲜度无法评分;你可能简述了已死的声音每个信号都带有首次看到的日期,否则不能进入阶段3

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 vertical short is shot or scripted and you need the upload-form copy and cover that win the feed — the hook line, the first-frame on-screen text, the search-led caption, a tight hashtag set, and the cover frame; it learns from what performed via the 02-DOCS log. NOT inventing the idea (that is `shortform-ideation`), NOT scripting or directing the cuts (that is `video-shorts`), NOT executing the edit (that is `shortform-editing`), NOT scheduling the post (that is `social-publisher`).

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`).

相关技能