0925lyz/jaguartv-copywriter-skill

JaguarTV Copywriter

Mantenha o gerador de cópias do chinês para o português brasileiro da JaguarTV.

A ferramenta possui dois modos:

1. tv: Promoção de produtos JaguarTV para usuários brasileiros.
2. generic: Cópias de conteúdo baseadas apenas nas palavras-chave em chinês do usuário, sem menções a produtos de TV.

Arquivos

• Frontend: src/jaguartv_factory/web/copywriter.html
• Estilos de UI: src/jaguartv_factory/web/copywriter.css
• Gerador de cliente e templates de fallback: src/jaguartv_factory/web/copywriter.js
• API do servidor e proxy Gemini: src/jaguartv_factory/dashboard.py
• Testes: tests/test_dashboard.py
• Skill de operação de produto/fábrica: .agents/skills/jaguartv-content-factory/SKILL.md

Leia references/tool-spec.md ao alterar comportamento, integração Gemini, implantação ou acesso público.

Diretrizes

• Nunca codifique GEMINI_API_KEY ou qualquer segredo. Use apenas variáveis de ambiente.
• Mantenha o código do navegador livre de chaves de API; chamadas ao Gemini devem passar por /api/copywriter/generate.
• Preserve o limite do modo generic: ele não deve gerar JaguarTV, Jarg.top, TV ao vivo, Android TV ou alegações sobre produtos/sites de download.
• No modo tv, evite promessas não verificáveis sobre canais protegidos por direitos autorais, preços, acesso gratuito, disponibilidade garantida ou cobertura regional.
• Mantenha a tradução de auditoria em chinês abaixo da saída pt-BR e inclua-a no texto completo da cópia.
• Trate URLs do localtunnel como prévias temporárias, não como implantação de produção.

Fluxo de Trabalho

1. Inspecione a implementação atual com rg -n "copywriter|Gemini|GEMINI|generate_copywriter".
2. Para alterações no comportamento de geração, atualize tanto o prompt/normalização Gemini em dashboard.py quanto os templates de fallback locais em copywriter.js.
3. Para alterações de UI, mantenha os controles acessíveis, responsivos e consistentes com o layout denso existente da ferramenta.
4. Verifique com:

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 verificação no navegador, inicie o dashboard e teste ambos os modos:

cd "/caminho/para/o/projeto-jaguartv"
PYTHONPATH="$PWD/src" python3 -m jaguartv_factory.cli ui --host 127.0.0.1 --port 8788

6. Se o usuário precisar de acesso público temporário, faça um túnel do dashboard em execução, não de um servidor estático:

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

Padrões Gemini

Use estas variáveis de ambiente quando o usuário quiser geração com modelo real:

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

O backend normaliza aliases comuns da versão 3.1 e faz fallback de gemini-3.1-pro-preview para gemini-3.1-flash-lite, depois para gemini-2.5-flash.