JimLiu/baocut / skills/baocut
baocut
Flagged用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。
references/craft/titles-and-description.md
View on GitHub<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/titles-and-description/ 生成,不要手改:改源文件后运行 npm run build:agent-skill -->
# 起标题与写简介
> 用户要为准备发布的视频起标题、要几个标题候选、再来一批或照某个再来几个,或要写视频简介(视频页标题下的说明文字、章节列表、标签)时用。写给发布视频的人:吸引人,并且每句都由视频兑现。需要视频的转写。不用于给文章起标题等与视频无关的写作。
用户的视频做好了,准备发。标题决定列表里有没有人点,简介决定点进来的人看不看、看完的人找不找得到视频里提到的东西。两者都写给发布视频的人:吸引人,并且每一句视频都兑现。标题和简介配合着用:先出标题候选、让用户挑一个,写简介时就用它。
最容易写坏的样子:从句式出发。「震惊!」「你绝对想不到」「一个视频讲清楚 X」,换个视频也能用,说明它没用上这个视频独有的东西;或者反过来,标题是视频名的复述,简介是视频的流水账,谁看了都不想点。
动笔前先读 [写作基线、两类读者、篇幅与风格](titles-and-description/references/writing-baseline.md)(材料、基线、两类读者与视角、篇幅与风格、默认值)。起标题再读 [视频标题](titles-and-description/references/titles.md),写简介再读 [视频简介](titles-and-description/references/description.md)。
## 1. 取材料
1. 用 `baocut videos inspect` 看视频:名字、章节(chapters 的 atSeconds 与 title)、文档。没有转写(kind 为 speech 的文档)时先转写,告诉用户转写在进行。转写没润色过时人名、术语可能有错字,对照视频信息核对。
2. 读文稿:先用 `baocut speech sentences` 取按句编号的文稿(简介里依据文稿的段落末尾回引编号,见写作基线「句子编号与出处」;标题不回引);它说没有可编号的句子时再用 `baocut export`(kind `transcript`、format `md`、timestamps `true`;有几份文稿时按它列出的候选用 documentId 指定),`baocut jobs inspect` 等到 completed,读 outputs 里的文件。没有视频、只有从链接下载并转写的结果时,读 `baocut jobs inspect` 的 outputs 里的 TXT 或 SRT。
3. 视频信息:来源标题、作者、原视频链接、发布平台只用视频信息里有的和用户提供的。
4. 系列与前作:用户要在简介里推荐相关视频,或要和以前的标题区分开时,用 `baocut space related-videos` 列出讲相近内容的几部(名字与最接近的一段原话);只列它给出的,不编,不把相关视频的内容写成这部视频讲过的。
5. 用户这次的要求:语言、篇幅、风格、候选个数、发布平台、视角;已选定的标题;之前给过的候选与用户想跟随的那一个,都在这段对话里找。用户说了标题和简介发在同一个平台时,两者按同一个平台写。
## 2. 动笔之前
先想清楚这两件事,它们不进成品:
1. **这个视频最值得看的是什么**。用一句话写下来:一个出人意料的结论、一个具体的结果、一个大家关心却答不上来的问题、一段不常见的经历、一个马上能用的方法。标题从它出发,简介的开头从它出发。一个视频往往有好几个值得看的点,它们就是不同候选的起点。
2. **观众为什么会点**。他本来在找什么、好奇什么、以为是怎样的?这个视频能让他省下什么、避开什么、得到什么?把这个连接点说具体。
## 3. 交付
- 标题:直接在回复里给出候选,每条带角度与一句理由,标出推荐的那一个;请用户挑一个,或说要再来一批、照哪个再来几个。
- 简介:直接在回复里给出全文(标签单列一行)。用户要文件时写成工作目录里的 Markdown 文件(如 `<视频名>.description.md`;多种语言时在扩展名前加语言标签);会话不属于项目时再把文件的路径告诉用户(终端里没有下载目录这一步:文件就在你写的位置)。
- 一并说明:用的是哪种视角、依据是什么;用户已经挑定的标题(或还待用户挑);哪些信息没有核实、哪些链接要用户补;说了平台的,提醒用户对照平台现行的规则核对。
## 4. 要避免的
- 不要从句式出发;把视频名和人名换掉还能用的标题,重写。
- 不要许诺视频没给的东西:数字、「最」「第一」、留下的问题,视频里都要有。
- 不要用同一句话的改写充当不同的候选。
- 不要编链接、编章节时间、编平台规则。
- 简介不要以链接、标签、署名开头,不要写成流水账。
## 同目录的文件
在 `references/craft/titles-and-description/` 下,用到时再打开;代码与样例原样复制,按正文说的用法取用。
- [视频简介](titles-and-description/references/description.md)
- [视频标题](titles-and-description/references/titles.md)
- [写作基线、两类读者、篇幅与风格](titles-and-description/references/writing-baseline.md)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |