translate-content

/digital-marketing-pro:translate-content

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定していない場合、スクリプトは skills/ と同じ階層にあるこのプラグインの scripts/ フォルダーにあります。Python 3.10 以降で実行してください。python、または python が見つからない環境（macOS、多くの Linux システム）では python3 を使用します。

目的

機能を優先したサービスのルーティングと品質保証により、マーケティングコンテンツを翻訳します。各対象言語について、ルーターは翻訳サービスに必要な要件（インド系言語には文字体系を認識するネイティブモデル、ヨーロッパ言語にはフォーマリティのレジスター、CJK 言語には分割と文字体系の混在への対応）を特定し、実行時に具体的なサービスを解決します。ブランドが記録した希望、またはユーザーがすでに接続している翻訳 MCP サーバーから選択します。解決できるサービスがない場合は、ハーネス独自の多言語機能を使用して翻訳を続行し、必須の品質スコアリングを行います。記憶だけを頼りに製品名を挙げることはなく、特定の製品も必要ありません。ブランドの声、書式、重要な用語は一貫して保持されます。

逐語訳にとどまらず、このコマンドは、慣用句、言葉遊び、ユーモア、感情に訴える行動喚起、文化的な言及など、翻訳ではなくトランスクリエーションが必要な要素をコンテンツから分析します。これらが検出された場合（またはユーザーがトランスクリエーションを明示的に依頼した場合）は、意図の保持度をスコアリングしながら、複数の創造的な案を作成します。これにより、言語を越えて感情的なインパクトとマーケティング効果を保ちます。すべての翻訳は、提供前に品質スコアリングとブランドの声のチェックを受けます。

必要な入力

ユーザーは次の情報を指定する必要があります（または、入力を求められます）。

• 翻訳するコンテンツ：テキストの直接入力、ファイルパス、または貼り付けたコンテンツブロック。見出し、メール、広告コピーなどの単一のコンテンツでも、ランディングページやセクションを含むメールテンプレートなどの構造化ドキュメントでもかまいません
• 対象言語：1 つ以上の対象言語。言語コード（hi、de、ja、fr-CA、pt-BR）または言語名（ヒンディー語、ドイツ語、日本語、カナダフランス語、ブラジルポルトガル語）を指定できます。バッチ翻訳では、複数の対象言語を指定できます
• 原文の言語：任意。翻訳元のコンテンツの言語です。省略すると、language-router.py によって自動検出されます
• トランスクリエーションのフラグ：任意。true に設定すると、コンテンツ分析の結果にかかわらず、すべてのコンテンツにトランスクリエーションのアプローチを強制します。コンテンツの創造性が非常に高い、または文化的に配慮が必要だとユーザーが把握している場合に便利です
• 翻訳禁止用語：任意。原文の言語のままにする必要がある特定の用語、製品名、ブランド要素です。ブランドプロファイルですでに定義されている翻訳禁止リストより優先されます
• フォーマリティレベル：任意。ドイツ語の Sie/du、フランス語の vous/tu など、フォーマルとインフォーマルのレジスターがある言語で使用する formal または informal を指定します。解決された翻訳サービスがレジスター制御に対応している場合はそのサービスに渡され、対応していない場合は翻訳指示で適用し、レビューで確認します。省略した場合は、ブランドプロファイルの設定に従い、設定がなければフォーマルが既定値になります
• 用語集のエントリー：任意。重要な用語に特定の訳語を適用するための用語ペア（原文：訳文）です。ブランドレベルの用語集を補完します

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.jsonを読み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.jsonを読み込みます。言語設定（do_not_translate用語リスト、translation_preferences（言語ペアごとの優先サービス、フォーマル度のデフォルト設定、用語集）、locale_formattingルール（日付形式、数値の区切り記号、通貨記号））を抽出します。ターゲット市場向けのコンプライアンスルールをskills/context-engine/compliance-rules.mdから読み込みます。~/.claude-marketing/brands/{slug}/guidelines/_manifest.jsonにガイドラインがあるか確認し、存在する場合は、ブランドボイスによる翻訳のスコアリングに使用するボイス＆トーンのルールを読み込みます。~/.claude-marketing/sops/にエージェンシーのSOPがあるか確認します。ブランドがない場合は、「最初にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. 原文の言語を検出する：原文の言語が指定されていない場合は、python "${CLAUDE_PLUGIN_ROOT}/scripts/language-router.py" --action detect --text "{content_or_path}"を実行して、信頼度スコアとともに原文の言語を特定します。信頼度が95%未満の場合は、検出した言語をユーザーに伝えて確認を求めます。
3. 翻訳機能に振り分ける：ターゲット言語ごとに、python "${CLAUDE_PLUGIN_ROOT}/scripts/language-router.py" --action route --source "{source_lang}" --target "{target_lang}" --brand {slug}を実行します。結果には、言語ファミリーに応じたcapability_kindとservice_criteriaが示され、ブランドが記録した優先設定（basis: brand-preference）またはユーザーが接続した翻訳MCPサーバー（basis: connected-servers）からのみ、具体的なサービスが決定されます。候補が複数ある場合は、基準に最もよく合うものを選び、/digital-marketing-pro:language-configを通じて選択内容を記録するかユーザーに確認します。決定したサービスとその根拠をユーザーに伝えます。basis: unresolvedの場合は、その旨を明確に伝え、ペイロードの解決手順に従います。記憶を頼りにサービス名を挙げたり、そのインストールを指示したりしてはいけません。
4. コンテンツを分析し、トランスクリエーションの必要性を確認する：逐語訳になじまない要素（慣用表現や口語表現、言葉遊びやダジャレ、ユーモアや皮肉、感情に訴えるCTAやスローガン、文化的な言及やたとえ、韻やリズムのパターン、二重の意味）が原文に含まれているか確認します。トランスクリエーションフラグが設定されている場合、またはトランスクリエーションが必要な要素が多く含まれている場合は、skills/context-engine/transcreation-framework.mdで定義された方法に従ってトランスクリエーションの概要を作成します。フラグを付けた各要素について、創造的な翻案の指針となるよう、原文の意図、感情的なトーン、対象読者に期待する反応を記録します。
5. 翻訳を実行する：振り分け先に応じて、以下のいずれかの方法で実行します。
   • MCP サーバーが決定済み（basis: brand-preferenceまたはconnected-servers）：そのサーバーを呼び出します。利用できる場合は、フォーマル度／レジスターのパラメーター、用語集または翻訳禁止用語の適用、HTML/XMLを保持するためのタグ処理、インド系言語向けの文字体系や方言の設定、中国語の変種選択など、その機能を使用します。基準で求められている機能がサーバーにない場合は、送信する指示にその要件を含め、スコアリングの段階で適用されていることを確認します。
   • 未決定（basis: unresolved）：ハーネス独自の多言語機能を使って翻訳し、振り分け結果のservice_criteriaを自分で適用します（レジスター、文字体系の忠実性、変種）。この方法は正当な手段であり、性能が劣る代替手段ではありません。ただし、この方法では、ステップ6の品質スコアと、ステップ7で85未満の場合に人によるレビューを求めることが必須です。
   • すべての方法で、翻訳禁止用語（ブランドプロフィールとユーザー指定リストを統合したもの）、フォーマル度の設定、用語集の項目、書式の保持（HTMLタグ、{{first_name}}のようなプレースホルダー、Markdown構文）を反映または適用します。
6. 翻訳品質をスコアリングする：python "${CLAUDE_PLUGIN_ROOT}/scripts/language-router.py" --action score --source "{source}" --target "{target}" --original "{source_content}" --translated "{translated_content}"を実行し、以下の項目で品質を評価します。
   • 長さの比率（翻訳文と原文の長さを比較し、不自然な増減を検出）
   • 書式の保持（HTMLタグ、Markdown、プレースホルダーが維持されているか）
   • 重要用語の一貫性（翻訳禁止用語が守られ、用語集の項目が正しく適用されているか）
   • プレースホルダーの整合性（{{name}}や{price}などの動的変数がすべて保持されているか）
   • 完全性（文や段落の欠落がないか）
7. 品質上の問題に対処する：翻訳品質スコアが85未満の場合は、スコアリングの内訳から具体的な問題を特定します。問題のある箇所を再翻訳する、書式の崩れを修正する、欠落したプレースホルダーを復元するなど、対象を絞って修正を試みます。修正後に再スコアリングします。品質が85未満のままの場合は、具体的な問題を明記し、人によるレビューを求めます。
8. トランスクリエーションを実行する（該当する場合）：トランスクリエーション対象のコンテンツ、またはトランスクリエーションフラグが設定されている場合は、フラグを付けた要素ごとに、創造的な翻案案を2～3件作成します。各案には以下を含めます。
   • ターゲット言語での創造的な翻案
   • 確認用の英語への逆翻訳
   • 意図の保持スコア（原文のマーケティング上の意図がどの程度維持されているか）
   • 文化的な適合性に関する注記（ターゲット市場にこの翻案が適している理由）
   • トーンの適合性に関する評価（フォーマル／遊び心のある／緊急性の高いトーンが原文のトーンに合っているか）
9. ブランドボイスを確認する：python "${CLAUDE_PLUGIN_ROOT}/scripts/brand-voice-scorer.py" --brand {slug} --text "{translated_content}"を実行し、翻訳文がブランドボイスの特徴を保っているか評価します。ブランドボイスからの逸脱があれば、具体例と改善案を添えて指摘します。
10. 品質指標とともに翻訳文を提示する：最終的な翻訳文を、すべての品質データと併せて、確認と承認がしやすい形式で提示します。

出力

以下を含む、構成化された翻訳成果物です。

• 翻訳済みコンテンツ：各対象言語の最終翻訳テキスト。元の書式（HTML、Markdown、プレースホルダー）を保持します
• 翻訳品質スコア：全体スコア（0～100）と、各評価項目の内訳（長さの比率、書式の保持、重要用語の一貫性、プレースホルダーの整合性、完全性）
• 使用したサービス：この言語ペアの翻訳を担当した翻訳サービスと、その選定理由
• 原文の言語：検出または確認した原文の言語と信頼度
• 翻訳対象外項目の遵守状況：すべての保護対象語句が原文のまま保持されたことの確認、または違反箇所の報告
• ブランドボイススコア：翻訳後のコンテンツがブランドボイスの特徴をどの程度維持しているかを示すスコア。検出された場合は、ブランドボイスのずれに関する具体的な所見も含みます
• トランスクリエーションの選択肢（該当する場合）：フラグが付いた各要素について、逆翻訳、意図の保持スコア、文化的な適合性に関する注記、トーンの整合性評価を含む、2～3件の創造的な翻案案
• 書式保持レポート：HTML タグ、Markdown 構文、プレースホルダー、構造要素が翻訳後もそのまま維持されていることの確認
• 品質フラグ：しきい値を下回った項目の詳細な説明と重大度（重大：コンテンツの欠落またはプレースホルダーの破損、警告：軽微な書式のずれまたは不自然な長さの比率、情報：軽微なスタイル上の所見）
• 推奨事項：翻訳の改善提案。人によるレビューを優先すべき箇所、今後の翻訳に向けて用語集に追加する用語、ロケール固有の調整（例：日付形式、通貨記号、計量単位）を含みます

使用したエージェント

• localization-specialist -- サービスの振り分け、トランスクリエーションの分析、品質スコアリング、文化的な適応の評価、対象言語におけるブランドボイスの維持、品質問題の解決など、翻訳ワークフロー全体を管理します