edit-enhancement-packager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Edit Enhancement Packager

编辑增强打包工具

Follow shared release-shell rules in:

```
postplus-shared
```
release-shell rules

Use this skill after B-roll matching exists.

This skill does not find B-roll assets.

It turns a

broll-plan.json

into a more complete edit package that says how each beat should be treated visually.

Default output:

```
edit-enhancement-package.json
```

Optional supporting outputs:

markdown edit review
beat-level editor checklist
future timeline export input

遵循以下共享发布框架规则：

```
postplus-shared
```
发布框架规则

请在完成B-roll匹配后使用此Skill。

此Skill不负责查找B-roll素材。

它将

broll-plan.json

转换为更完整的编辑包，明确每个节拍的视觉处理方式。

默认输出：

```
edit-enhancement-package.json
```

可选支持输出：

Markdown编辑审阅文档
节拍级编辑核对清单
未来时间线导出输入文件

Use For

适用场景

deciding when to stay on A-roll face
deciding when to cut to B-roll
packaging keyword emphasis cues
packaging micro-animation hints
coordinating subtitle density with B-roll moments
producing a beat-level edit package for a human editor or future NLE export layer

决定何时保留A-roll面部镜头
决定何时切换至B-roll镜头
打包关键词强化提示
打包微动画提示
协调字幕密度与B-roll镜头时刻
为人工编辑或未来NLE导出层生成节拍级编辑包

Trigger Signals

触发信号

Use this skill when the user asks for things like:

把 B-roll plan 变成编辑方案
加关键词强化和微动画提示
哪些地方留脸，哪些地方切 B-roll
生成 editor-ready edit package
把字幕、B-roll、关键词动效一起打包

Do not use this skill when the user still lacks:

a B-roll catalog
a B-roll plan

Route those first to:

skills/40-creative/b-roll-family/broll-catalog-builder

skills/40-creative/b-roll-family/broll-match-engine

当用户提出以下需求时使用此Skill：

把 B-roll plan 变成编辑方案
加关键词强化和微动画提示
哪些地方留脸，哪些地方切 B-roll
生成 editor-ready edit package
把字幕、B-roll、关键词动效一起打包

当用户缺少以下内容时，请不要使用此Skill：

B-roll素材库
B-roll计划

请先引导用户使用：

skills/40-creative/b-roll-family/broll-catalog-builder

skills/40-creative/b-roll-family/broll-match-engine

Read These References

参考文档

family architecture:
```
../references/skill-architecture.md
```
shared contracts:
```
../references/contracts.md
```

edit enhancement contract:

../references/edit-enhancement-contract.md

Use existing local skills when useful:

```
skills/40-creative/subtitle-packager
```

skills/40-creative/editing-decision-engine

家族架构：
```
../references/skill-architecture.md
```
共享协议：
```
../references/contracts.md
```

编辑增强协议：

../references/edit-enhancement-contract.md

如有需要，可使用现有本地Skill：

```
skills/40-creative/subtitle-packager
```

skills/40-creative/editing-decision-engine

Core Principle

核心原则

Do not turn every matched B-roll candidate into an automatic cutaway.

The important decision is:

what should carry attention at this moment

Possible answers:

face carries attention
B-roll carries proof
subtitle keyword carries emphasis
micro-motion carries pacing

The package should coordinate these layers instead of stacking all of them at once.

不要将每个匹配的B-roll候选素材都自动转为切镜镜头。

关键决策在于：

此刻应聚焦哪个元素

可能的选择：

面部镜头聚焦注意力
B-roll镜头提供佐证
字幕关键词强化重点
微动画调节节奏

编辑包应协调这些元素层，而非同时堆叠所有元素。

Preferred Inputs

Workflow

工作流程

1. Classify attention owner

1. 分类注意力主体

For each beat, decide the primary attention owner:

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

针对每个节拍，确定主要注意力主体：

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

2. Decide A-roll / B-roll behavior

2. 确定A-roll/B-roll行为

For each beat, decide:

stay on A-roll
full B-roll cutaway
B-roll overlay support
picture-in-picture
split emphasis

Do not overcut low-value filler beats.

针对每个节拍，决定：

保留A-roll镜头
完全切换至B-roll镜头
B-roll镜头叠加辅助
画中画
分屏强调

不要在低价值填充节拍上过度切镜。

3. Package keyword emphasis

3. 打包关键词强化

Use

keywordOverlay

from

broll-plan.json

as a starting point.

Then decide:

whether to emphasize the keyword at all
whether emphasis should be in subtitles or a separate text card
whether the emphasis should be subtle or prominent

以

broll-plan.json

中的

keywordOverlay

为起点。

然后决定：

是否需要强化关键词
强化应在字幕中还是单独文本卡片中
强化应低调还是突出

4. Package micro-motion hints

4. 打包微动画提示

Use simple motion vocabulary only.

Good first-version hints:

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

These are hints, not renderer-specific commands.

仅使用简单的动效词汇。

推荐的初始版本提示：

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

这些是提示，而非渲染器特定命令。

5. Coordinate subtitles

5. 协调字幕

For each beat, decide subtitle treatment:

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

The goal is to avoid B-roll and subtitle fighting for the same screen area.

针对每个节拍，决定字幕处理方式：

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

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

Minimal Script

最小化脚本

First implementation script:

scripts/run_package_edit_enhancements.mjs

Current first-version behavior:

reads
```
broll-plan.json
```
treats the top B-roll candidate as the preferred candidate
classifies the attention owner per beat
packages A-roll action, B-roll action, keyword emphasis, micro-motion, subtitle treatment, and editor notes
writes
```
edit-enhancement-package.json
```

Example:

bash

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

初始实现脚本：

scripts/run_package_edit_enhancements.mjs

当前初始版本行为：

读取
```
broll-plan.json
```
将排名第一的B-roll候选素材视为首选
为每个节拍分类注意力主体
打包A-roll操作、B-roll操作、关键词强化、微动画、字幕处理和编辑说明
写入
```
edit-enhancement-package.json
```

示例：

bash

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

Release-Shell Execution Contract

发布框架执行协议

keep enhancement inputs, beat-level working files, and intermediate edit packaging outputs under
```
<work-folder>/.postplus/edit-enhancement-packager/
```
keep only final user-facing
```
edit-enhancement-package.json
```
or review exports outside
```
.postplus/
```
start with a bounded first pass on one beat plan before broader packaging
if required upstream inputs are missing or invalid, stop immediately instead of switching to ad hoc shell glue

将增强输入、节拍级工作文件和中间编辑打包输出保存在
```
<work-folder>/.postplus/edit-enhancement-packager/
```
下
仅将最终面向用户的
```
edit-enhancement-package.json
```
或审阅导出文件放在
```
.postplus/
```
外部
在进行更广泛打包前，先针对单个节拍计划完成有限的首轮处理
如果所需上游输入缺失或无效，请立即停止，不要使用临时框架粘合方案

Output Standard

输出标准

A good package lets a human editor answer:

should I stay on face or cut away
what B-roll candidate should I use
which words should be emphasized
what kind of motion should be applied
should subtitles move, simplify, or stay normal

If the package only repeats the B-roll plan, it is not adding enough value.

优质的编辑包应能让人工编辑明确：

应保留面部镜头还是切换镜头
应使用哪个B-roll候选素材
哪些词汇需要强化
应应用哪种动效
字幕应移动、简化还是保持正常

如果编辑包仅重复B-roll计划内容，则未提供足够价值。

First-Version Boundary

初始版本边界

Prefer:

beat-level JSON
explicit editor hints
conservative motion vocabulary
no renderer-specific assumptions

Do not require in v1:

CapCut draft generation
Premiere XML
real animation rendering
automatic face detection
automatic crop solving

优先实现：

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

初始版本无需支持：

生成CapCut草稿
Premiere XML文件
实时动画渲染
自动面部检测
自动裁剪解决方案

Review Rule

审阅规则

If a beat has weak B-roll candidates, prefer:

stay on A-roll
keyword emphasis
subtitle highlight

Do not force weak B-roll just because a candidate exists.

如果某个节拍的B-roll候选素材质量不佳，优先选择：

保留A-roll镜头
关键词强化
字幕高亮

不要仅因为存在候选素材就强行使用质量不佳的B-roll镜头。