JaguarTV コピーライター
JaguarTV向け中国語からブラジルポルトガル語へのコピー生成ツールを保守します。
このツールには2つのモードがあります：
tv: JaguarTV製品をブラジルユーザー向けにプロモーションします。generic: ユーザーの中国語キーワードのみに基づくコンテンツコピー。テレビ製品に関する言及はありません。
ファイル
- フロントエンド:
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にフォールバックします。