0925lyz/jaguartv-copywriter-skill

JaguarTV Copywriter

Wartung des chinesisch-zu-brasilianisch-portugiesischen Kopiergenerators für JaguarTV.

Das Tool hat zwei Modi:

1. tv: JaguarTV-Produktwerbung für brasilianische Nutzer.
2. generic: Inhaltskopie basierend nur auf den chinesischen Schlüsselwörtern des Nutzers, ohne Erwähnung von TV-Produkten.

Dateien

• Frontend: src/jaguartv_factory/web/copywriter.html
• UI-Styles: src/jaguartv_factory/web/copywriter.css
• Client-Generator und Fallback-Vorlagen: src/jaguartv_factory/web/copywriter.js
• Server-API und Gemini-Proxy: src/jaguartv_factory/dashboard.py
• Tests: tests/test_dashboard.py
• Produkt-/Factory-Betriebsskill: .agents/skills/jaguartv-content-factory/SKILL.md

Lesen Sie references/tool-spec.md, wenn Sie Verhalten, Gemini-Integration, Bereitstellung oder öffentlichen Zugriff ändern.

Leitplanken

• Hartcodieren Sie niemals GEMINI_API_KEY oder ein anderes Geheimnis. Verwenden Sie ausschließlich Umgebungsvariablen.
• Halten Sie den Browsercode frei von API-Schlüsseln; Gemini-Aufrufe müssen über /api/copywriter/generate erfolgen.
• Bewahren Sie die Grenzen des generic-Modus: Er darf weder JaguarTV, Jarg.top, TV ao vivo, Android TV noch Produkt-/Download-Seitenangaben ausgeben.
• Vermeiden Sie im tv-Modus nicht überprüfbare Versprechen zu urheberrechtlich geschützten Kanälen, Preisen, kostenlosem Zugriff, garantierter Verfügbarkeit oder regionaler Abdeckung.
• Behalten Sie die chinesische Prüfungsübersetzung unterhalb der pt-BR-Ausgabe bei und fügen Sie sie in den Kopier-All-Text ein.
• Behandeln Sie LocalTunnel-URLs als temporäre Vorschauen, nicht als Produktionsbereitstellung.

Arbeitsablauf

1. Untersuchen Sie die aktuelle Implementierung mit rg -n "copywriter|Gemini|GEMINI|generate_copywriter".
2. Ändern Sie für Generierungsverhaltensänderungen sowohl das Gemini-Prompting/die Normalisierung in dashboard.py als auch die lokalen Fallback-Vorlagen in copywriter.js.
3. Für UI-Änderungen halten Sie die Steuerelemente zugänglich, reaktionsschnell und konsistent mit dem bestehenden dichten Tool-Layout.
4. Überprüfen Sie mit:

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. Für die Browser-Überprüfung starten Sie das Dashboard und testen beide Modi:

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

6. Wenn der Nutzer temporären öffentlichen Zugriff benötigt, tunneln Sie das laufende Dashboard, nicht einen statischen Server:

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

Gemini-Standardwerte

Verwenden Sie diese Umgebungsvariablen, wenn der Nutzer echte Modellgenerierung wünscht:

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

Das Backend normalisiert gängige 3.1-Aliase und fällt von gemini-3.1-pro-preview auf gemini-3.1-flash-lite, dann auf gemini-2.5-flash zurück.