mcpField
T
to-spec-beats

to-spec-beats

github.com/sugarforever创意与媒体18639 次安装5 天前更新
代码仓库

关于 to-spec-beats

to-spec-beats 是面向视频内容团队的技能,用于把已批准的文章整理成 BEATS.md,规划观众逐步获得的信息。它要求校验文件摘要、遵循文章范围,并审查论点、证据和时长预算。

主要功能

  1. 01读取已批准文章及相关主题文件
  2. 02校验批准状态与 SHA-256 摘要
  3. 03按学习顺序组织视频节拍
  4. 04保持内容主张在文章范围内
  5. 05审查论点、证据依赖和时长预算

适用场景

  1. 01将已批准文章改编为视频叙事大纲
  2. 02检查视频节拍是否覆盖文章论点与证据
  3. 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:视频的事实与叙事主干。文章决定作品表达什么;此步骤决定观众何时学到什么。后续步骤再决定口播措辞和视觉呈现。

流程

  1. 阅读 content/ARTICLE.md、存在时的 content/TOPIC.md,以及保留其边界所需的证据。移除每个已批准文件中仅有的 approved_digest: 行后,重新计算其 SHA-256;只有当存储的摘要与当前文件一致,且文章的 status: approved 时才继续。如果用户带来的是在此工作流之外完成的完整文章,先依据 /boring-video 中的外部来源约定,将其放入或改编为 content/ARTICLE.md;无需追溯性地补充单独的主题约定。
  2. 继承已批准文章及(若存在)主题约定中的受众、论点和范围。只定义受众已有的知识、希望其理解发生的变化、目标时长,以及视频从已批准范围中选取的内容。
  3. 构建反向冰山式叙事弧:用观众的语言设置钩子,在第二个节拍前给出价值或答案,接着呈现证据、机制、影响,最后收尾。可为适应媒介而重排、压缩或删去文章内容,但须保留其含义和边界。
  4. 每个节拍只承担一项认知任务。若一个节拍要求观众完成两项相互独立的领悟,就拆分该节拍;若某个节拍的任务无法追溯到已批准的论点,就删除该节拍。
    • 不要在节拍中写入视觉处理、镜头运动、动画、构图和场景元素。只记录后续阶段需要的内容事实。在此发现的视觉构思应移至 SCENES.md,不得成为节拍约定的一部分。
  5. 按以下格式在 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。任何后续阶段都必须重新计算,而不能依赖存储的值。

  1. 审核完整文件:每项重要主张和观点都能追溯到已批准的文章;每项依赖都指向前文;论点最迟在第二个节拍落定;时长分配符合目标。

如果视频结构暴露出缺失的事实、观点、论证步骤或结论,应将其补回 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