edit-enhancement-packager

编辑增强包制作器

遵循以下共享的公开技能规则：

• postplus-shared 公开技能规则

在 B-roll 匹配完成后使用此技能。

此技能不会查找 B-roll 素材。

它会将 broll-plan.json 转换为更完整的编辑包，说明每个节拍在视觉上应如何处理。

默认输出：

• edit-enhancement-package.json

可选的配套输出：

• Markdown 编辑审阅
• 节拍级编辑检查清单
• 未来时间线导出的输入

适用场景

• 决定何时保持 A-roll 人脸画面
• 决定何时切换到 B-roll
• 整理关键词强调提示
• 整理微动画提示
• 协调字幕密度与 B-roll 时刻
• 为人工编辑或未来的 NLE 导出层生成节拍级编辑包

触发信号

用户提出以下需求时使用此技能：

• 将 B-roll 计划转成编辑计划
• 添加关键词强调和微动画说明
• 哪些地方保留人脸画面，哪些地方切换到 B-roll
• 生成可供编辑人员使用的编辑包
• 将字幕、B-roll 和关键词动态效果整合到一起

如果用户尚未准备好以下内容，请勿使用此技能：

• B-roll 目录
• B-roll 计划

应先将这些需求交给：

• skills/40-creative/b-roll-family/broll-catalog-builder
• skills/40-creative/b-roll-family/broll-match-engine

阅读以下参考资料

• 系列架构：../references/skill-architecture.md
• 共享契约：../references/contracts.md
• 编辑增强契约：../references/edit-enhancement-contract.md

需要时使用现有本地技能：

• skills/40-creative/subtitle-packager
• skills/40-creative/editing-decision-engine

核心原则

不要将每个匹配到的 B-roll 候选素材都自动切成插入镜头。

关键在于判断：

• 此刻应由什么吸引观众注意力

可能的答案：

• 人脸画面吸引注意力
• B-roll 提供佐证
• 字幕关键词突出重点
• 微动效控制节奏

编辑包应协调这些层，而不是一次性将它们全部叠加。

首选输入

必需：

• broll-plan.json

强烈建议：

• chunked-<mode>.json
• ASS 配置或字幕样式配置

可选：

• A-roll 分析
• 参考剪辑风格
• 平台目标，例如 9:16 或 16:9
• 活动风格说明

工作流

1. 确定注意力焦点

为每个节拍确定主要的注意力焦点：

• a-roll-face
• b-roll-proof
• subtitle-keyword
• transition-motion

2. 决定 A-roll / B-roll 的处理方式

为每个节拍决定：

• 保持 A-roll
• 完全切换到 B-roll
• 以 B-roll 叠加辅助
• 画中画
• 分屏强调

不要在价值较低的填充节拍中频繁切镜头。

3. 整理关键词强调

以 broll-plan.json 中的 keywordOverlay 作为起点。

然后决定：

• 是否需要强调关键词
• 应在字幕中强调，还是使用单独的文字卡片
• 强调效果应当低调还是醒目

4. 整理微动效提示

仅使用简单的动效词汇。

首版适用的提示：

• none
• keyword-pop
• gentle-push-in
• soft-slide
• quick-cut-contrast
• hold-clean
• soft-fade

这些是提示，不是特定于渲染器的命令。

5. 协调字幕

为每个节拍决定字幕处理方式：

• normal
• lift-up
• reduce-density
• keyword-highlight
• hold

目标是避免 B-roll 和字幕争夺同一屏幕区域。

最简脚本

首个实现脚本：

• scripts/run_package_edit_enhancements.mjs

当前首版行为：

• 读取 broll-plan.json
• 将排名最高的 B-roll 候选素材视为首选素材
• 为每个节拍确定注意力焦点
• 整理 A-roll 动作、B-roll 动作、关键词强调、微动效、字幕处理方式和编辑说明
• 写入 edit-enhancement-package.json

示例：

node ${CLAUDE_SKILL_DIR}/scripts/run_package_edit_enhancements.mjs \
  --broll-plan /abs/path/broll-plan.json \
  --output <work-folder>/edit-enhancement-package.json \
  --aspect-ratio 9:16 \
  --style-profile basic

公开技能执行约定

• 将增强输入、节拍级工作文件和中间编辑打包输出保存在 <work-folder>/.postplus/edit-enhancement-packager/ 下
• 仅将最终面向用户的 edit-enhancement-package.json 或审阅导出文件保存在 .postplus/ 之外
• 先对一个节拍计划进行有范围限制的初步处理，再进行更大范围的打包
• 如果缺少必需的上游输入，或输入无效，请立即停止，而不是改用临时的 shell 脚本拼凑方案

输出标准

优秀的包能让视频编辑人员回答：

• 是该保留人脸画面，还是切到其他画面
• 该使用哪个 B-roll 候选片段
• 应强调哪些词语
• 应应用哪种运动效果
• 字幕应移动、简化，还是保持常规样式

如果包只是重复 B-roll 计划，那它提供的价值就不够。

首版范围

优先考虑：

• 节拍级 JSON
• 明确的编辑提示
• 保守的运动效果词汇
• 不依赖特定渲染器的假设

v1 不要求：

• 生成 CapCut 草稿
• Premiere XML
• 实际动画渲染
• 自动人脸检测
• 自动裁剪方案计算

审阅规则

如果某个节拍的 B-roll 候选片段不理想，优先选择：

• 保留 A-roll
• 强调关键词
• 高亮字幕

不要仅仅因为存在候选片段，就强行使用不理想的 B-roll。