0925lyz/jaguartv-copywriter-skill

JaguarTV Copywriter

Maintenez le générateur de textes publicitaires du chinois vers le portugais brésilien pour JaguarTV.

L'outil dispose de deux modes :

1. tv : promotion des produits JaguarTV pour les utilisateurs brésiliens.
2. generic : contenu basé uniquement sur les mots-clés chinois de l'utilisateur, sans mention de produits TV.

Fichiers

• Frontend : src/jaguartv_factory/web/copywriter.html
• Styles d'interface : src/jaguartv_factory/web/copywriter.css
• Générateur client et modèles de secours locaux : src/jaguartv_factory/web/copywriter.js
• API serveur et proxy Gemini : src/jaguartv_factory/dashboard.py
• Tests : tests/test_dashboard.py
• Compétence d'exploitation produit/usine : .agents/skills/jaguartv-content-factory/SKILL.md

Lisez references/tool-spec.md lors de modifications du comportement, de l'intégration Gemini, du déploiement ou de l'accès public.

Garde-fous

• Ne jamais coder en dur GEMINI_API_KEY ou tout secret. Utilisez uniquement des variables d'environnement.
• Le code navigateur doit rester exempt de clés API ; les appels Gemini doivent passer par /api/copywriter/generate.
• Préservez la limite du mode generic : il ne doit pas produire JaguarTV, Jarg.top, TV ao vivo, Android TV, ni de mentions de produits ou de sites de téléchargement.
• En mode tv, évitez les promesses invérifiables concernant des chaînes protégées par le droit d'auteur, les prix, l'accès gratuit, la disponibilité garantie ou la couverture régionale.
• Conservez la traduction d'audit en chinois sous le résultat pt-BR et incluez-la dans le texte intégral.
• Traitez les URL localtunnel comme des aperçus temporaires, et non comme un déploiement de production.

Flux de travail

1. Inspectez l'implémentation actuelle avec rg -n "copywriter|Gemini|GEMINI|generate_copywriter".
2. Pour les modifications du comportement de génération, mettez à jour à la fois le prompt/normalisation Gemini dans dashboard.py et les modèles de secours locaux dans copywriter.js.
3. Pour les modifications de l'interface, gardez les contrôles accessibles, réactifs et cohérents avec la disposition dense existante.
4. Vérifiez avec :

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. Pour la vérification dans le navigateur, démarrez le tableau de bord et testez les deux modes :

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

6. Si l'utilisateur a besoin d'un accès public temporaire, créez un tunnel vers le tableau de bord en cours d'exécution, pas un serveur statique :

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

Valeurs par défaut de Gemini

Utilisez ces variables d'environnement lorsque l'utilisateur souhaite une génération réelle du modèle :

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

Le backend normalise les alias 3.1 courants et passe de gemini-3.1-pro-preview à gemini-3.1-flash-lite, puis gemini-2.5-flash.