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

code/engine/editor/aplicador_de_plano_de_edicao.py

@@ -9,6 +9,7 @@ preserva a validade das posições calculadas — ver docstring de
 from __future__ import annotations
 
 from dataclasses import dataclass, field
+from pathlib import Path
 
 from ..dominio import Clipe, Faixa, Timeline
 from ..integracoes.premiere.conversores import ConversorDeTimeline
@@ -305,8 +306,7 @@ class AplicadorDePlanoDeEdicao:
         deixou uma faixa de áudio inteira sem ser cortada numa aplicação
         real deste plano.
         """
-        alvo = arquivo_de_origem.strip().lower()
-        nomeados = [clipe for clipe in faixa.clipes if (clipe.nome or "").strip().lower() == alvo]
+        nomeados = [clipe for clipe in faixa.clipes if self._clipe_corresponde_a_fonte(clipe, arquivo_de_origem)]
         sem_origem = [clipe for clipe in nomeados if clipe.intervalo_na_origem is None]
         if sem_origem:
             raise ErroDeMapeamentoDeTempo(
@@ -316,6 +316,23 @@ class AplicadorDePlanoDeEdicao:
             )
         return sorted(nomeados, key=lambda clipe: clipe.intervalo_na_origem.inicio)
 
+    @staticmethod
+    def _clipe_corresponde_a_fonte(clipe: Clipe, arquivo_de_origem: str) -> bool:
+        """Compara ``source`` com o nome do clipe ou com o nome-base da mídia real.
+
+        O Premiere pode devolver no campo ``name`` um nome editorial diferente
+        do arquivo de mídia, enquanto ``sourceFile`` contém o caminho real.
+        A comparação por nome-base mantém o plano portátil entre máquinas e
+        evita exigir que a IA conheça caminhos locais. A busca continua
+        restrita à faixa atual; nenhuma fonte é escolhida por aproximação.
+        """
+        fonte_informada = Path(str(arquivo_de_origem).strip()).name.casefold()
+        if not fonte_informada:
+            return False
+        nome_do_clipe = (clipe.nome or "").strip().casefold()
+        caminho_da_midia = Path(str(clipe.arquivo or "").strip()).name.casefold()
+        return fonte_informada in {nome_do_clipe, caminho_da_midia}
+
     def _borda_de_entrada(self, clipe: Clipe, inicio_de_origem: float) -> float:
         """Posição de entrada do corte na timeline: a borda do clipe se o corte começa antes dele."""
         if inicio_de_origem <= clipe.intervalo_na_origem.inicio: