JianYing Editor Skill - Versión en Español
Utilice este skill cuando el usuario desee automatizar la edición de video, generar borradores o manipular recursos multimedia en JianYing Pro.
Manual de ejecución para agentes: docs/agent-playbook.md
SOP de comandos mínimos: docs/minimal-command-sop.md
Guía de uso en lenguaje natural: usage.md
CLI de inspección de borradores:
python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "NombreDelBorrador"
python <SKILL_ROOT>/scripts/draft_inspector.py show --name "NombreDelBorrador" --kind content --json
Para solicitudes de edición genéricas, siga siempre la "Plantilla de Edición Rápida" y la "Lista de Verificación de Aceptación" en ese manual.
🚨 Principios de Desarrollo Importantes (CRITICAL DEVELOPER RULES)
- Ubicación de scripts: Prohibido crear scripts de edición dentro del directorio del Skill. Todo el código de lógica de edición (archivos
.py) debe colocarse en el directorio raíz del proyecto del usuario (o un subdirectorio comoscripts/), para mantener la pureza y portabilidad de la biblioteca del Skill. - Versión y Arquitectura:
- Adaptación multiplataforma: Totalmente compatible con MacOS (detección de rutas/grabación de pantalla) y Windows.
- Auto-reparación: Compatible con v5.9+ (
draft_info.json). Si el borrador está dañado o hay conflictos de versión, inicialiceJyProjectconoverwrite=Truepara activar la reparación automática.
- Selección de música de fondo:
- Para demostraciones simples use la música predeterminada. En proyectos reales, priorice la búsqueda y recomendación de pistas relevantes en
data/cloud_music_library.csv, o filtre por palabra clave según el tema del video (ej. "tecnología", "cálido"). - Pregunte al usuario: "Encontré algunas pistas de música en la nube que podrían coincidir con el tema, ¿quieres probarlas? (Ej.:
Illuminate- con estilo tecnológico)".
- Para demostraciones simples use la música predeterminada. En proyectos reales, priorice la búsqueda y recomendación de pistas relevantes en
📜 Guía de Reglas (Rules)
Lea los archivos de reglas individuales para tareas y restricciones específicas:
- rules/setup.md - Código de inicialización obligatorio para todos los scripts.
- rules/core.md - Operaciones básicas: Guardado, Exportación y gestión de borradores.
- rules/cli.md - Contratos CLI y convenciones de salida legible por máquina.
- rules/media.md - Importación de recursos y Optimización de Análisis de Video IA (30m/360p).
- rules/text.md - Añadir subtítulos, texto y leyendas.
- rules/keyframes.md - Avanzado: Añadir animaciones con fotogramas clave.
- rules/effects.md - Buscar y aplicar filtros, efectos y transiciones.
- rules/recording.md - Nuevo: Automatización de grabación de pantalla y zoom inteligente.
- rules/web-vfx.md - Avanzado: Generación de video a partir de web.
- rules/generative.md - Cadena de pensamiento para edición generativa.
- rules/audio-voice.md - Nuevo: Locución por TTS y selección de música de fondo.
🎯 Enrutamiento Rápido del Agente
- Video en la nube + Música en la nube:
rules/media.md+rules/audio-voice.md->examples/cloud_video_music_tts_demo.py - Locución inteligente y subtítulos (Script-to-Video):
rules/text.md+rules/audio-voice.md-> API centraladd_narrated_subtitles - Narración y alineación de subtítulos:
rules/text.md+rules/audio-voice.md->examples/cloud_video_music_tts_demo.py - Grabación de pantalla y zoom inteligente:
rules/recording.md->tools/recording/recorder.py - Exportación por lotes/exportación sin cabeza:
rules/core.md+rules/cli.md->examples/robust_auto_export.py - Generación de comentarios cinematográficos:
rules/generative.md->scripts/movie_commentary_builder.py
📖 Ejemplos Clásicos (Examples)
Consulte estos para flujos de trabajo completos:
- examples/my_first_vlog.py - Una demostración completa de creación de vlog con música de fondo y texto animado.
- examples/simple_clip_demo.py - Tutorial de inicio rápido para cortes básicos y gestión de pistas.
- examples/compound_clip_demo.py - Nuevo: Automatización profesional de proyectos anidados (Compound Clip).
- examples/cloud_video_music_tts_demo.py - Video en la nube + Música de fondo en la nube + TTS/alineación de subtítulos.
- examples/web_to_video_intro_demo.py - Demostración de introducción Web-to-Video (animación HTML -> clip en línea de tiempo).
- examples/robust_auto_export.py - Flujo de trabajo de exportación estable y manejo de fallos.
- examples/auto_exposure_align_demo.py - Flujo de trabajo de alineación de exposición asistido por CV.
- examples/video_transcribe_and_match.py - Avanzado: Flujo de trabajo impulsado por IA (Transcribir Video -> Emparejar B-Roll mediante semántica IA -> Ensamblar Borrador).
🧠 Prompts & Herramientas Integradas (Prompts & Integrated Tools)
Use estas plantillas y scripts para tareas complejas:
- Búsqueda de recursos: Encuentre filtros, transiciones y animaciones por nombre en chino/inglés:
python <SKILL_ROOT>/scripts/asset_search.py "retro" -c filters - Constructor de comentarios cinematográficos: Genere videos de comentarios de 60 segundos a partir de un storyboard JSON:
python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json" - Sincronizar recursos nativos: Importe su música de fondo y estilos favoritos/reproducidos desde la aplicación JianYing al Skill:
python <SKILL_ROOT>/scripts/sync_jy_assets.py # Indexar materiales en la nube desde sus borradores existentes python <SKILL_ROOT>/scripts/build_cloud_music_library.py python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.py - README a Tutorial: Convierta el README.md de un proyecto en un guion completo de video tutorial de instalación:
- Leer prompt:
prompts/readme_to_tutorial.md - Inyectar contenido en la variable
{{README_CONTENT}}
- Leer prompt:
- Grabador de pantalla y Zoom inteligente: Grabe su pantalla y aplique automáticamente fotogramas clave de zoom:
python <SKILL_ROOT>/tools/recording/recorder.py # Captura de vista previa web (alto rendimiento) python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5 # O aplicar zoom a un video existente: python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Proyecto" --video "v.mp4" --json "e.json" - Inspeccionador de borradores: Examine la estructura y metadatos del borrador (compatible con v5.9+):
python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20 python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "NombreDelBorrador" - Exportador automático: Exportación sin cabeza de un borrador a MP4/SRT:
Nota: La exportación automática a MP4 usa Automatización de UI en Windows. En macOS, genere el borrador y expórtelo manualmente desde JianYing.python <SKILL_ROOT>/scripts/auto_exporter.py "NombreDelBorrador" "output.mp4" --res 1080 --fps 60 # Solo para SRT: python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "NombreDelBorrador" - Clonar plantilla y reemplazar: Clone plantillas de forma segura y reemplace materiales por lotes (evita dañar la plantilla original):
# Clonar plantilla para generar un nuevo proyecto python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "PlantillaHotel" --name "ClienteA_Copia" - Validador de API: Ejecute un diagnóstico rápido de su entorno:
python <SKILL_ROOT>/scripts/api_validator.py
🚀 Ejemplo de inicio rápido
import os
import sys
# 1. Inicialización del entorno (debe sincronizarse al inicio del script, compatible con Win/Mac)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# Detectar la ruta del Skill (compatible con Antigravity, Trae, Claude, etc.)
skill_root = next((p for p in [
env_root,
os.path.join(current_dir, ".agents", "skills", "jianying-editor"),
os.path.join(current_dir, ".agent", "skills", "jianying-editor"),
os.path.join(current_dir, ".trae", "skills", "jianying-editor"),
os.path.join(current_dir, ".claude", "skills", "jianying-editor"),
os.path.join(current_dir, "skills", "jianying-editor"),
os.path.abspath(".agents/skills/jianying-editor"),
os.path.abspath(".agent/skills/jianying-editor"),
os.path.abspath(".trae/skills/jianying-editor"),
os.path.abspath(".claude/skills/jianying-editor"),
os.path.abspath("skills/jianying-editor"),
os.path.dirname(current_dir)
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)
if not skill_root: raise ImportError("No se pudo encontrar la raíz del skill jianying-editor.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject
if __name__ == "__main__":
# 2. Inicializar proyecto (compatible con v5.9+ y auto-reparación)
project = JyProject("Nuevo Video IA", overwrite=True)
assets_dir = os.path.join(skill_root, "assets")
# 3. Locución inteligente y subtítulos (One-click Script-to-Video)
project.add_narrated_subtitles(
text="Bienvenido al Skill de automatización de JianYing. Esta es una versión avanzada completamente adaptada a MacOS.",
speaker="zh_female_xiaopengyou"
)
# 4. Importar material adicional
project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")
project.add_media_safe(os.path.join(assets_dir, "audio.mp3"), "0s", track_name="Audio")
# 5. Añadir título con animación
project.add_text_simple("Automatización JianYing activada", start_time="1s", duration="3s", anim_in="Máquina de escribir retro")
project.save()
🛠️ Inicialización y Reglas del Proyecto (Initialization & Project Rules)
Al inicializar JyProject, asegúrese de establecer la resolución según la relación de aspecto del material de video principal. El valor predeterminado es horizontal (1920x1080).
🚨 Regla de ubicación de scripts
Prohibido crear sus scripts de edición de negocio en el directorio de instalación del Skill.
- Correcto: Coloque sus scripts Python de edición en el directorio raíz del proyecto.
- Motivo: El directorio del Skill solo debe contener el código fuente de las herramientas, para facilitar futuras actualizaciones con
git pull. Mezclar código de negocio causa desorden en la gestión de versiones.