0925lyz/jaguartv-copywriter-skill

JaguarTV Copywriter

Mantén el generador de copy de chino a portugués brasileño para JaguarTV.

La herramienta tiene dos modos:

1. tv: Promoción de productos JaguarTV para usuarios brasileños.
2. generic: copy de contenido basado únicamente en las palabras clave chinas del usuario, sin menciones de productos de TV.

Archivos

• Frontend: src/jaguartv_factory/web/copywriter.html
• Estilos UI: src/jaguartv_factory/web/copywriter.css
• Generador de cliente y plantillas de respaldo: src/jaguartv_factory/web/copywriter.js
• API del servidor y proxy Gemini: src/jaguartv_factory/dashboard.py
• Pruebas: tests/test_dashboard.py
• Skill de operación de producto/fábrica: .agents/skills/jaguartv-content-factory/SKILL.md

Lee references/tool-spec.md al cambiar el comportamiento, la integración con Gemini, el despliegue o el acceso público.

Barreras de seguridad

• Nunca codifiques GEMINI_API_KEY ni ningún secreto. Usa solo variables de entorno.
• Mantén el código del navegador libre de claves API; las llamadas a Gemini deben pasar por /api/copywriter/generate.
• Preserva el límite del modo generic: no debe generar JaguarTV, Jarg.top, TV ao vivo, Android TV ni afirmaciones de productos o sitios de descarga.
• En modo tv, evita promesas no verificables sobre canales con derechos de autor, precios, acceso gratuito, disponibilidad garantizada o cobertura regional.
• Mantén la traducción de auditoría en chino debajo del resultado en pt-BR e inclúyela en el texto completo del copy.
• Trata las URL de localtunnel como vistas previas temporales, no como despliegue en producción.

Flujo de trabajo

1. Inspecciona la implementación actual con rg -n "copywriter|Gemini|GEMINI|generate_copywriter".
2. Para cambios en el comportamiento de generación, actualiza tanto el prompt/normalización de Gemini en dashboard.py como las plantillas de respaldo locales en copywriter.js.
3. Para cambios en la UI, mantén los controles accesibles, responsivos y consistentes con el diseño denso de herramientas existente.
4. Verifica con:

python3 -m py_compile src/jaguartv_factory/dashboard.py tests/test_dashboard.py
PYTHONPATH=src python3 -m pytest tests/test_dashboard.py -q
node --check src/jaguartv_factory/web/copywriter.js
git diff --check -- src/jaguartv_factory/dashboard.py src/jaguartv_factory/web/copywriter.js src/jaguartv_factory/web/copywriter.css tests/test_dashboard.py

5. Para verificación en el navegador, inicia el dashboard y prueba ambos modos:

cd "/path/to/jaguartv-project"
PYTHONPATH="$PWD/src" python3 -m jaguartv_factory.cli ui --host 127.0.0.1 --port 8788

6. Si el usuario necesita acceso público temporal, crea un túnel al dashboard en ejecución, no a un servidor estático:

npx --yes localtunnel --port 8788 --local-host 127.0.0.1 --subdomain jaguartv-copywriter-ai

Valores predeterminados de Gemini

Usa estas variables de entorno cuando el usuario quiera generación con modelo real:

export GEMINI_API_KEY="..."
export GEMINI_MODEL="gemini-3.1-pro-preview"
export GEMINI_TIMEOUT_SECONDS="20"

El backend normaliza alias comunes de la versión 3.1 y retrocede de gemini-3.1-pro-preview a gemini-3.1-flash-lite, luego a gemini-2.5-flash.