AI agent skill · by @JimLiu

Titles And Description

用户要为准备发布的视频起标题、要几个标题候选、再来一批或照某个再来几个，或要写视频简介（视频页标题下的说明文字、章节列表、标签）时用。写给发布视频的人：吸引人，并且每句都由视频兑现。需要视频的转写。不用于给文章起标题等与视频无关的写作。

Archived 2026-10-23 · Source updated 2026-10-12. Check the original repository for the latest version.

SKILL.md instructions

# 起标题与写简介

用户的视频做好了，准备发。标题决定列表里有没有人点，简介决定点进来的人看不看、看完的人找不找得到视频里提到的东西。两者都写给发布视频的人：吸引人，并且每一句视频都兑现。标题和简介配合着用：先出标题候选、让用户挑一个，写简介时就用它。

最容易写坏的样子：从句式出发。「震惊！」「你绝对想不到」「一个视频讲清楚 X」，换个视频也能用，说明它没用上这个视频独有的东西；或者反过来，标题是视频名的复述，简介是视频的流水账，谁看了都不想点。

动笔前先用 `skills_read` 读本 skill 的 `references/writing-baseline.md`（材料、基线、两类读者与视角、篇幅与风格、默认值）。起标题再读 `references/titles.md`，写简介再读 `references/description.md`。

## 1. 取材料

1. 用 videos_inspect 看视频：名字、章节（chapters 的 atSeconds 与 title）、文档。没有转写（kind 为 speech 的文档）时先转写，告诉用户转写在进行。转写没润色过时人名、术语可能有错字，对照视频信息核对。
2. 读文稿：export（kind `transcript`、format `md`、timestamps `true`；有几份文稿时按它列出的候选用 documentId 指定），jobs_inspect 等到 completed，读 outputs 里的文件。没有视频、只有从链接下载并转写的结果时，读 jobs_inspect 的 outputs 里的 TXT 或 SRT。
3. 视频信息：来源标题、作者、原视频链接、发布平台只用视频信息里有的和用户提供的。
4. 用户这次的要求：语言、篇幅、风格、候选个数、发布平台、视角；已选定的标题；之前给过的候选与用户想跟随的那一个，都在这段对话里找。用户说了标题和简介发在同一个平台时，两者按同一个平台写。

## 2. 动笔之前

先想清楚这两件事，它们不进成品：

1. **这个视频最值得看的是什么**。用一句话写下来：一个出人意料的结论、一个具体的结果、一个大家关心却答不上来的问题、一段不常见的经历、一个马上能用的方法。标题从它出发，简介的开头从它出发。一个视频往往有好几个值得看的点，它们就是不同候选的起点。
2. **观众为什么会点**。他本来在找什么、好奇什么、以为是怎样的？这个视频能让他省下什么、避开什么、得到什么？把这个连接点说具体。

## 3. 交付

- 标题：直接在回复里给出候选，每条带角度与一句理由，标出推荐的那一个；请用户挑一个，或说要再来一批、照哪个再来几个。
- 简介：直接在回复里给出全文（标签单列一行）。用户要文件时写成工作目录里的 Markdown 文件（如 `<视频名>.description.md`；多种语言时在扩展名前加语言标签）；会话不属于项目时再用 downloads_save 放进下载目录，把它返回的 path 告诉用户。
- 一并说明：用的是哪种视角、依据是什么；用户已经挑定的标题（或还待用户挑）；哪些信息没有核实、哪些链接要用户补；说了平台的，提醒用户对照平台现行的规则核对。

## 4. 要避免的

- 不要从句式出发；把视频名和人名换掉还能用的标题，重写。
- 不要许诺视频没给的东西：数字、「最」「第一」、留下的问题，视频里都要有。
- 不要用同一句话的改写充当不同的候选。
- 不要编链接、编章节时间、编平台规则。
- 简介不要以链接、标签、署名开头，不要写成流水账。