关于 to-spec-beats
to-spec-beats 是面向视频内容团队的技能,用于把已批准的文章整理成 BEATS.md,规划观众逐步获得的信息。它要求校验文件摘要、遵循文章范围,并审查论点、证据和时长预算。
主要功能
- 01读取已批准文章及相关主题文件
- 02校验批准状态与 SHA-256 摘要
- 03按学习顺序组织视频节拍
- 04保持内容主张在文章范围内
- 05审查论点、证据依赖和时长预算
适用场景
- 01将已批准文章改编为视频叙事大纲
- 02检查视频节拍是否覆盖文章论点与证据
- 03在进入旁白撰写前审核学习结构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sugarforever/ boring-video-studio --skill to-spec-beats安装后在 Claude Code 中输入/to-spec-beats确认已加载。
详细介绍
转换为节拍结构
将已批准的 content/ARTICLE.md 转换为 BEATS.md:视频的事实与叙事主干。文章决定作品表达什么;此步骤决定观众何时学到什么。后续步骤再决定口播措辞和视觉呈现。
流程
- 阅读
content/ARTICLE.md、存在时的content/TOPIC.md,以及保留其边界所需的证据。移除每个已批准文件中仅有的approved_digest:行后,重新计算其 SHA-256;只有当存储的摘要与当前文件一致,且文章的status: approved时才继续。如果用户带来的是在此工作流之外完成的完整文章,先依据/boring-video中的外部来源约定,将其放入或改编为content/ARTICLE.md;无需追溯性地补充单独的主题约定。 - 继承已批准文章及(若存在)主题约定中的受众、论点和范围。只定义受众已有的知识、希望其理解发生的变化、目标时长,以及视频从已批准范围中选取的内容。
- 构建反向冰山式叙事弧:用观众的语言设置钩子,在第二个节拍前给出价值或答案,接着呈现证据、机制、影响,最后收尾。可为适应媒介而重排、压缩或删去文章内容,但须保留其含义和边界。
- 每个节拍只承担一项认知任务。若一个节拍要求观众完成两项相互独立的领悟,就拆分该节拍;若某个节拍的任务无法追溯到已批准的论点,就删除该节拍。
- 不要在节拍中写入视觉处理、镜头运动、动画、构图和场景元素。只记录后续阶段需要的内容事实。在此发现的视觉构思应移至
SCENES.md,不得成为节拍约定的一部分。
- 不要在节拍中写入视觉处理、镜头运动、动画、构图和场景元素。只记录后续阶段需要的内容事实。在此发现的视觉构思应移至
- 按以下格式在
content/旁创建BEATS.md:
---
source: content/ARTICLE.md
source_digest: sha256:<ARTICLE approved_digest>
artifact_digest: sha256:<digest>
audience: ...
thesis: ...
viewer_shift: ... → ...
target_duration: ...
---
## B01 — Title
- job: What changes in the viewer's understanding
- claim: The factual statement this beat establishes
- source: Article heading or passage that establishes it
- evidence: Source or experiment already selected by the article
- setup: Prior beat knowledge this depends on
- handoff: Question or tension passed forward
- duration: Rough narration budget
Notes needed to write this beat accurately.
将 artifact_digest 计算为移除仅有的 artifact_digest: 行后,完整节拍文件的 SHA-256。任何后续阶段都必须重新计算,而不能依赖存储的值。
- 审核完整文件:每项重要主张和观点都能追溯到已批准的文章;每项依赖都指向前文;论点最迟在第二个节拍落定;时长分配符合目标。
如果视频结构暴露出缺失的事实、观点、论证步骤或结论,应将其补回 content/ARTICLE.md。如果解决问题会改变已锁定的主题决策,也应将 content/TOPIC.md 退回 draft。重新完成所需的审批,然后将变更向后传递。不要在 BEATS.md 中修补内容缺口。
节拍 ID 是稳定接口。修订时应保留现有 ID;插入节拍时应分配新 ID。
提交 BEATS.md 或其任何后续修订版本之前,请遵循 ../boring-video/references/markdown-review.md。提交权威 Markdown 文档以供内容结构审查:审查可以批准学习叙事弧、主张、证据和时长分配,但绝不能批准视觉执行。
当其他作者无需虚构内容即可撰写旁白、每个节拍都是对已批准文章的媒介特定编排而非新论证,并且满足 Markdown 审查完成标准时,BEATS.md 即告完成。
评论
支持 Markdown