feat: documentada a entrada universal da skill edit-video-by-voice
-documentada a entrada universal da skill edit-video-by-voice e reforçados os limites do contrato de ações 1.0 - corrigida a identificação da mídia na engine Python usando nome do clipe e nome-base de sourceFile Resumo: - 5 arquivos alterados - 1 novos - 4 modificados - 0 removidos 4 files changed, 54 insertions(+), 16 deletions(-) Arquivos: - code/engine/editor/aplicador_de_plano_de_edicao.py - code/engine/testes/test_aplicador_de_plano_de_edicao.py - code/plugins/premiere-pro/skills/edit-video-by-voice/SKILL.md - code/plugins/premiere-pro/skills/edit-video-by-voice/agents/openai.yaml - code/plugins/premiere-pro/skills/edit-video-by-voice/references/input-schema.md
This commit is contained in:
@@ -7,7 +7,8 @@ description: Analyze a video voice timeline JSON and produce a validated, execut
|
||||
|
||||
Transform a voice timeline into a defensible edit plan. The input is evidence;
|
||||
the output is a machine-readable plan. Keep editorial judgment separate from
|
||||
the program that applies the plan.
|
||||
the program that applies the plan. The plan is universal: a downstream adapter
|
||||
may execute it in any video editor.
|
||||
|
||||
## Portable contract
|
||||
|
||||
@@ -17,10 +18,12 @@ editor implementation. If the timeline is unavailable, request it. If its
|
||||
schema is unfamiliar or missing required timing data, explain the exact field
|
||||
that is missing instead of guessing.
|
||||
|
||||
The input normally contains utterances with a speaker, text, start and end
|
||||
times, and may contain take identifiers, confidence, emphasis, or analysis
|
||||
layers. Preserve the input's timebase. All output times refer to the original
|
||||
media, in seconds.
|
||||
The input normally contains a source identifier, source duration, and
|
||||
utterances with a speaker, text, start and end times. It may also contain take
|
||||
identifiers, confidence, emphasis, or analysis layers. The accepted input
|
||||
shapes and normalization rules are in
|
||||
[references/input-schema.md](references/input-schema.md). Preserve the input's
|
||||
timebase. All output times refer to the original media, in seconds.
|
||||
|
||||
The output is one JSON object and no extra fields at the root:
|
||||
|
||||
@@ -63,9 +66,10 @@ remove, never intervals to keep. The complete action contract is in
|
||||
7. Convert the intervals to remove into the complement of the material to
|
||||
keep. Sort them, merge overlaps, remove empty intervals, and validate them
|
||||
against the original media duration.
|
||||
8. Return only the JSON contract. Put uncertainty in an action's `reason` or
|
||||
in a clearly marked action when the contract allows it; never invent facts,
|
||||
words, identities, or timecodes.
|
||||
8. Return only the JSON contract. If the evidence does not support a safe
|
||||
choice between takes, do not cut either take solely to force a choice; use
|
||||
the least destructive supported plan and state the uncertainty in the
|
||||
relevant `reason`. Never invent facts, words, identities, or timecodes.
|
||||
|
||||
## Invariants
|
||||
|
||||
@@ -75,8 +79,8 @@ remove, never intervals to keep. The complete action contract is in
|
||||
- Exclude speakers or utterances explicitly marked inactive or excluded.
|
||||
- Never claim that a visual effect, caption, or audio correction was applied;
|
||||
this skill only returns decisions.
|
||||
- When two takes are genuinely indistinguishable, preserve both as uncertainty
|
||||
in the explanation rather than choosing arbitrarily.
|
||||
- When two takes are genuinely indistinguishable, do not choose arbitrarily.
|
||||
Preserve both unless the user's editorial intent supplies a deciding rule.
|
||||
- If duration is unknown, do not emit executable cuts that cannot be bounded.
|
||||
|
||||
## Validation before response
|
||||
@@ -88,5 +92,7 @@ overlapping actions, and follows the action schema. Validate the complement
|
||||
logic: applying all cuts must retain exactly the selected material.
|
||||
|
||||
If the requested result needs an action kind outside the declared contract,
|
||||
report that the capability is unavailable and return the supported plan only
|
||||
when doing so is safe and useful. Do not silently encode unsupported behavior.
|
||||
report that the capability is unavailable and return only a supported plan when
|
||||
doing so is safe and useful. Do not silently encode unsupported behavior or
|
||||
pretend that a `cut` represents a move, trim, split, insert, overwrite, zoom,
|
||||
text, marker, audio, transition, effect, or subtitle operation.
|
||||
|
||||
Reference in New Issue
Block a user