SuperAPI AI 工具集

to-spec-beats

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:将已批准的内容文章(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、source_digest、artifact_digest、audience、thesis、viewer_shift、target_duration 字段;每个拍含 job、claim、source、evidence、setup、handoff、duration 等条目。artifact_digest 为移除 artifact_digest: 行后整个文件内容的 SHA-256,后续阶段必须重新计算而非信任存储值。

审计要求:所有实质主张与观点须可追溯到已批准文章,依赖关系只向前指向,论点须在第二拍落地,时长预算符合目标。若视频结构暴露出缺失的事实、观点、论证步骤或结论,应退回 content/ARTICLE.md 补充;若影响已锁定的主题决策,则同时把 content/TOPIC.md 退回 draft,重新取得必要批准后再向下传递,不得在 BEATS.md 中修补内容缺口。拍 ID 是稳定接口,修订中保留,插入新拍时分配新 ID。呈现 BEATS.md 或后续修订前,须遵循 ../boring-video/references/markdown-review.md;评审仅针对学习弧线、主张、证据与时长预算,不评审视觉执行。完成标准:另一位作者可据此撰写口播而无需编造内容,每个拍都是对已批准文章的媒介化编排而非新论证。