JaguarTV 카피라이터은(는) 무엇을 하나요?
JaguarTV의 중국어-브라질 포르투갈어 카피 생성 도구를 유지보수합니다.
이 도구는 두 가지 모드가 있습니다:
tv: 브라질 사용자를 위한 JaguarTV 제품 프로모션.generic: TV 제품 언급 없이 사용자의 중국어 키워드만으로 콘텐츠 카피 생성.
파일
- 프론트엔드:
src/jaguartv_factory/web/copywriter.html - UI 스타일:
src/jaguartv_factory/web/copywriter.css - 클라이언트 생성기 및 폴백 템플릿:
src/jaguartv_factory/web/copywriter.js - 서버 API 및 Gemini 프록시:
src/jaguartv_factory/dashboard.py - 테스트:
tests/test_dashboard.py - 제품/팩토리 운영 스킬:
.agents/skills/jaguartv-content-factory/SKILL.md
동작 변경, Gemini 통합, 배포 또는 퍼블릭 접근 시 references/tool-spec.md를 읽으십시오.
가드레일
GEMINI_API_KEY나 어떤 시크릿도 하드코딩하지 마십시오. 환경 변수만 사용하십시오.- 브라우저 코드에 API 키가 포함되지 않도록 하십시오. Gemini 호출은 반드시
/api/copywriter/generate를 통해 이루어져야 합니다. generic모드 경계를 유지하십시오:JaguarTV,Jarg.top,TV ao vivo, Android TV, 또는 제품/다운로드 사이트 주장을 출력해서는 안 됩니다.tv모드에서는 저작권이 있는 채널, 가격, 무료 접근, 보장된 가용성 또는 지역 커버리지에 대한 검증되지 않은 약속을 피하십시오.- 중국어 감사 번역을 pt-BR 출력 아래에 유지하고 복사-전체 텍스트에 포함시키십시오.
- localtunnel URL을 임시 미리보기로 취급하고 프로덕션 배포로 간주하지 마십시오.
워크플로우
rg -n "copywriter|Gemini|GEMINI|generate_copywriter"로 현재 구현을 검사하십시오.- 생성 동작 변경 시
dashboard.py의 Gemini 프롬프트/정규화와copywriter.js의 로컬 폴백 템플릿을 모두 업데이트하십시오. - UI 변경 시 컨트롤을 접근 가능하고 반응형으로 유지하며 기존의 조밀한 도구 레이아웃과 일관성을 유지하십시오.
- 다음으로 검증하십시오:
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
- 브라우저 검증을 위해 대시보드를 시작하고 두 모드를 테스트하십시오:
cd "/path/to/jaguartv-project"
PYTHONPATH="$PWD/src" python3 -m jaguartv_factory.cli ui --host 127.0.0.1 --port 8788
- 사용자가 임시 퍼블릭 접근이 필요한 경우, 정적 서버가 아닌 실행 중인 대시보드를 터널링하십시오:
npx --yes localtunnel --port 8788 --local-host 127.0.0.1 --subdomain jaguartv-copywriter-ai
Gemini 기본값
사용자가 실제 모델 생성을 원할 때 다음 환경 변수를 사용하십시오:
export GEMINI_API_KEY="..."
export GEMINI_MODEL="gemini-3.1-pro-preview"
export GEMINI_TIMEOUT_SECONDS="20"
백엔드는 일반적인 3.1 별칭을 정규화하고 gemini-3.1-pro-preview에서 gemini-3.1-flash-lite로, 그 다음 gemini-2.5-flash로 폴백합니다.