reels-scripting

Reels 脚本

Codex 和 Claude 运行时

• 在 Codex 或 Claude 中使用此技能时，请使用当前任务中实际可用的工具。AskUserQuestion 示例描述的是问题，而不是必需的 API：请在其能力范围内使用可用的提问工具，或在聊天中提问。重复利用已提供的答案和源材料。
• 在用户选定的项目中工作。个性化创作前，阅读其中的 about-me.md、voice.md 和相关品牌文件。如果文件相互冲突或包含默认初始内容，请确认预期作者。对于缺失的信息，请提问或运行 voice-builder；切勿沿用维护者的身份、账号或私有文件。
• 相对于此技能文件夹解析捆绑的 references/。如果用户明确要求刷新个人资料，请原地读取并更新规范的 about-me.md、voice.md 或 newsletter-voice.md，并保留无关的用户信息和规则。使用方必须重新读取这些规范文件。只有在新交付内容会与无关的现有文件重名时，才使用新文件名。仅安装技能不会启动访谈或写入文件。除非用户要求，否则不要写入持久化经验。
• 优先使用已提供的证据。必要时，通过可用的搜索或来源工具核实外部说法。如果来源或集成不可用，请指出缺失的能力，并提供使用已给文本或导出内容作为输入的选项。切勿捏造事实、第一人称经历、指标或工具成功运行的结果。
• 仅通过用户现有账号连接所选路线所需的服务。切勿打印凭据或覆盖连接。起草、保存和审阅均不代表获准发布、发送消息或更改账号。

关键：加载时自动启动

此技能触发时，直接进入步骤 1。不要进行摘要。

前提条件

完整的 Apify + Gemini 视频分析路线需要：

• APIFY_API_TOKEN 环境变量（用于抓取 Instagram 内容）
• GOOGLE_AI_API_KEY 环境变量（用于 Gemini 2.5 Flash 视频分析）
• Node.js 18+，以及 apify-client 和 @google/generative-ai 包

仅检查所选路线所需的能力。对于 URL 提取和 Gemini 视频分析，请在不打印凭据的情况下确认用户现有凭据已配置，然后确认服务提供商和模型可用。缺少凭据或软件包、视频为私有视频，或模型不可用，都会导致对应阶段保持待处理状态。说明缺少的内容；不要修改账号配置或悄悄替换服务提供商。

提供的视频可以跳过 Apify。提供的转录文本或分析结果可以跳过步骤 3 和 4，并用于步骤 5 中标明依据转录文本撰写的脚本，但不能将其视为 Gemini 视频分析结果。复用已安装的软件包；生成辅助脚本前，查看当前官方 SDK 和 Actor 文档，并在产生服务提供商费用前征得用户同意。

步骤 1. 获取参考内容

询问：

请粘贴参考 Reel 的 URL 或 Notion 链接。这是你想要逆向分析其形式的爆款 Reel。

等待用户提供 URL。

如果用户粘贴 Notion 链接，请通过可用且已授权的 Notion 连接器读取页面，找到页面中的 Instagram Reel URL 并提取。如果 Notion 页面中未找到 Reel URL，请用户直接粘贴 Reel URL。

步骤 2. 获取新闻简报主题

询问：

你想将新闻简报中的哪个主题改编成 Reel？请粘贴相关的新闻简报片段，或用一句话写出核心观点。

等待用户提供主题。从项目中读取 newsletter-voice.md、voice.md 和 about-me.md（如果存在），确保脚本符合用户的表达风格。

第 3 步：抓取并下载 Reel

在所选项目中使用新的 outputs/reels/<slug>/ 文件夹。如果已有合适的辅助工具，则重复使用；否则在该目录中编写一个小型、针对当前任务的 Node.js 脚本，该脚本需：

1. 检查当前文档中记录的架构后，使用 apify-client 和现有的 apify/instagram-reel-scraper 路由，处理指定的单条 Reel。绝不抓取评论、回复或评论串，包括通过 deepScrape 或 numComments 抓取。调用前，确认服务提供商支持仅采集帖子/视频；否则请求用户上传视频。不要猜测其他 Actor 输入参数。
2. 从返回的条目中提取 videoUrl。
3. 将视频下载到 outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4。
4. 将原始抓取数据保存到 outputs/reels/<slug>/reel_data_{shortCode}.json。

运行脚本。在继续之前，确认文件大小和元数据（播放量、点赞数、可用时的评论总数、说明文字的前 200 个字符）。

单条 Reel 只能作为参考，不能据此认定为异常值。只有在提供的数据或明确要求的对比数据能够证明其相对于同一创作者近期帖子表现突出时，才能称其为异常值；注明样本、时间范围和倍数。不要虚构基准数据。

第 4 步：使用 Gemini 2.5 Flash 进行分析

扩展 Node 脚本（或进行第二轮处理），以便：

1. 将下载的 .mp4 读取为 base64。
2. 调用 genAI.getGenerativeModel({ model: 'gemini-2.5-flash' })。
3. 使用以下精确提示词发送视频：

I'm studying this Reel to write my own script in a similar style for my audience of [AUDIENCE FROM about-me.md].

## Full Transcript
- Transcribe EVERY word with timestamps

## Hook
- Exact first words spoken
- Word count of the hook
- What makes it stop the scroll?

## Language Patterns
- Average sentence length
- You/your vs I/me ratio
- Transitions between points
- Where are the 'just' minimisers?

## Structure
- Total duration
- Section breakdown with timings
- What's the before/after moment?
- What's the CTA?

## One key insight
- The single most important technique to learn from this Reel

将分析结果保存到 outputs/reels/<slug>/analysis_reference_{shortCode}.md。

第 5 步：撰写新的 Reel 脚本

使用第 4 步的分析、第 2 步的新闻简报主题和用户的语气文件，撰写一份新的 Reel 脚本，保存到 outputs/reels/<slug>/reel-[slug].md。

遵循以下规则（不可妥协）：

开场钩子

• 开头绝不能用“I”。使用“this”、“you”、事实或提及名人。
• 经验证有效的格式：“This changed... forever” / 反转式否定（“X is useless unless...”）/ 能力陈述。
• 开场钩子需在 3 秒内引发好奇或打破常规。
• 参照分析中参考内容的开场钩子字数和结构。

正文

• 使用英式英语。句子简短。不要使用破折号或分号。
• 口语化地使用“you”和“just”（如“you just drop in...”）。
• 绝不能合并三个或更多短促片段。应将其组合成一个流畅的句子。
• 绝不直接说出结论。让事实自行说明。
• 只有在用户确实有可交付内容且自动化已确认可正常运行时，才使用评论引导。否则，使用相关的下一步行动，不要承诺交付任何内容。

评论触发词（仅在条件满足时使用）

• 仅限一个全大写单词（SCRIPT、WIKI、PROMPTS、VIDEO）。
• 必须与承诺提供的内容直接相关。
• 不加引号、不写“below”、末尾不加标点

行动号召

• “Comment [WORD] and I'll send you [specific thing]”
• 简短。不加“the link to my full”之类的赘语。

时长和结构

• 总时长目标为 30 至 45 秒。
• 最多 2 个要点，不是 3 个。
• 说明文字与脚本保持一致。两者需同步更新。

脚本文件结构

# Reel: [title]

## Reference analysis
- URL: [reel url]
- Views: [number]
- Key technique: [from Gemini analysis]

## Duration target
30-45 seconds

## Hook (0-3s)
[Exact words]

## Point 1 ([start]-[end]s)
[Exact words]

## Point 2 ([start]-[end]s)
[Exact words]

## CTA ([start]-[end]s)
[Exact next action, with a comment promise only when delivery is confirmed]

---

## Caption
[Mirror the script, formatted for Instagram]

## Comment trigger (only if configured)
[WORD or not applicable]

## Deliverable (only if promised)
[The real available resource or not applicable]

---

## Visual notes
[Cuts, B-roll ideas, text overlays]

第 6 步：QA 循环

在运行中的助手里进行审查：来源准确性（30）、用户语气（25）、开场钩子和结构（20）、口播时长和清晰度（15）、说明文字/行动号召一致性（10）。每项评分都要引用依据。修复实际违规项并重新评分，最多进行三轮。达标线为 95/100；如果问题仍未解决，应报告草稿及具体阻碍，不要虚报评分或声称已准备就绪。如果条件允许，计时口播；否则将时长标注为估算。Codex 中的此项审查无需使用 Claude。

需检查的常见违规项：

• 以“I”开头
• 三个或更多短促片段
• 直接说出结论
• 多词或经过特殊设计的评论触发词
• 口播时长超过 45 秒
• 有 3 个要点而非 2 个
• 说明文字与脚本不一致

步骤 7：交付脚本

在项目中交付审核通过的脚本和配套说明文字，并附上参考来源、分析方法以及任何尚未完成的检查。用户可以自行录制，也可以明确要求使用自己现有的制作工作流。此公开技能不提供虚拟形象、剪辑或发布工作流。

规则

• 绝不跳过 95/100 的 QA 门槛。
• 写作前务必阅读 voice.md 和 about-me.md。风格一致性不可妥协。
• 绝不编造参考 Reel 的指标。只能使用已核实的、由用户提供或获取的元数据，并将缺失的指标标记为不可用。
• 使用英式英语。不得使用破折号或分号。
• 每份脚本都必须附上配套说明文字；只有在承诺的交付内容确实可用时，才加入评论触发语。
• 如果无法访问参考内容，请报告失败环节，并请用户提供视频或文字稿。不得捏造视频分析。
• 使用 Gemini 2.5 Flash 模型。未经用户批准，不得替换。