关于 to-narration
to-narration 是把已审核的文章结构转写为口语旁白的写作 Skill，供视频内容创作者使用。它保留各段的论点与衔接，并校验来源摘要、时长和段落锚点。
主要功能
- 01将 BEATS.md 改写为 NARRATION.md
- 02核对文章与结构摘要
- 03保留段落主张及衔接
- 04按口播时长调整文本
- 05为段落设置稳定锚点
- 06记录未解决的发音或事实问题
适用场景
- 01把已批准的视频结构改写成口播稿
- 02按目标时长修订旁白草稿
- 03在交付前检查旁白与来源内容的一致性
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/to-narration确认已加载。
详细介绍
转为旁白
将 BEATS.md 转换为 NARRATION.md：即已批准文章和视频结构的口述版本。这一轮调整语言，使其更适合听觉；不会首次确立作者的论点。
流程
- 阅读
BEATS.md、其已批准的content/ARTICLE.md源文件、准确性所需的引用证据，以及文章记录的已确认语音来源。重新计算文章批准摘要和 beats 工件摘要；要求它们与存储的文章approved_digest、beatssource_digest和 beatsartifact_digest一致。加载所有适用且可用的写作风格技能或文档。保留每个 beat 的作用、主张和衔接。 - 用自然、易于朗读的语言撰写旁白。用具体的主体、动作和变化讲清事件，让听众能够跟随叙述展开并理解内容。保留作者的语气，同时将书面文章改编为口语表达。
- 让画面呈现可见的结构、对比和变化。旁白补充仅靠画面无法传达的含义。
- 标记段落与 beat 之间的界限，但不要添加画面指示。将尚未解决的发音或事实问题放在
Open checks部分。 - 编写
NARRATION.md：
---
source: BEATS.md
source_digest: sha256:<BEATS artifact_digest>
content_source: content/ARTICLE.md
content_digest: sha256:<ARTICLE approved_digest>
artifact_digest: sha256:<digest>
status: draft
target_duration: ...
---
## B01 — Title
<a id="b01-p01"></a>
Spoken paragraph.
计算 artifact_digest：移除且仅移除 artifact_digest: 行后，对完整的旁白文件计算 SHA-256。下游阶段使用前必须重新计算该摘要。
- 为每个段落添加稳定的
<beat-id>-pNN锚点。改写段落时保留原锚点；插入段落时分配新锚点。 - 大声朗读，或按用户已知的语速估算。修改稿件，直到每个 beat 都符合其时长预算，且全文符合目标时长。
所有实质性事实、观点和结论，都必须通过其 beat 追溯到已批准的文章。如果口述内容需要文章未确立的信息，应立即将 content/ARTICLE.md 恢复为 status: draft，并在其中修改；如果改动影响已锁定的主题决策，也要将 content/TOPIC.md 恢复为 draft。重新取得这些上游文件定义的批准，并相应更新 BEATS.md，之后才能在旁白中使用这些内容。在此工作流中，BEATS.md 没有单独的批准状态。
在提交 NARRATION.md 或任何后续修订前，遵循 ../boring-video/references/markdown-review.md。提交权威 Markdown 供检查，不要启动或替代 HyperFrames 后续的语音审阅流程。
当稿件已可用于画面规划、每个实质性句子都能追溯到某个 beat 和已批准的文章、没有提前指定后续画面，并且满足 Markdown 审阅完成标准时，草稿即告完成。/to-scenes 开始后，由共享的 HyperFrames 项目负责安排审阅时间，并确定可用于语音制作的旁白版本。