ブログ翻訳、SEO最適化ブログ翻訳 は何をしますか?
既存のブログ記事を1つ以上の対象言語に翻訳します。単なる翻訳ではなく、このスキルはSEO最適化され、公開準備が整ったコンテンツを生成し、ローカライズされたキーワード、メタタグ、文化的に正しいフォーマットを提供します。
主要な参照ファイル
必要に応じて読み込みます:
references/translation-rules.md、フォーマット保持、ロケールごとの数値・日付・通貨フォーマット、引用処理、品質基準。references/cultural-adaptation.md、ロケールごとの文化プロファイル(DACH、フランコフォン、ヒスパニック、日本語、カスタム)。このファイルはblog-localizeと共有されます(重複しないこと)。
ワークフロー
フェーズ1:入力解析
- ソースファイル(Markdown、MDX、またはHTML)を読み取ります。
- ソース言語を自動検出します。優先順位:
- フロントマターの
langフィールド。 - HTMLの
lang属性。 - コンテンツ分析(スクリプト、一般的なストップワード)。
- フロントマターの
--toから対象言語をカンマ区切りのISO 639-1コード(de,fr,es,ja,pt-BR)として解析します。--toがない場合は、ユーザーに一度だけ質問します:「どの言語に翻訳しますか? ISO 639-1コードを指定してください(例:de, fr, es, ja, pt-BR)。」- すべてのコードを検証します。無効なものは提案とともに拒否します(
jpは「日本語の場合はjaのことですか?」)。対象言語がソース言語と等しい場合は、通知とともにスキップします。
フェーズ2:コンテンツ分析
翻訳可能な表面を抽出します:
- フロントマター:
title、description、tags、author(翻訳可能な場合のみ。例:役割ラベル、個人名は不可)。 - すべての見出し(H1、H2、H3)。
- 本文段落。
- 画像の
altテキストと<figcaption>コンテンツ。 - チャートの
<text>および<tspan>コンテンツ。すべてのSVG属性(x、y、font-size、fill、transform)を保持。 - FAQの質問と回答。
- 引用カプセルのテキスト。
- 重要ポイントまたは要約ボックス。
- CTAテキスト。
- 内部リンクゾーンのアンカーテキスト。
変更せずに保持:
- MarkdownおよびHTMLの構造、タグ、属性。
- 画像URL、リンクURL、フロントマターのキー。
- コードブロック(インラインコメントは意味がある場合のみ翻訳)。
- 内部リンクゾーンのマーカー(
[INTERNAL-LINK: ...])。 - 引用内のソース組織名(Gartner、McKinseyなど)。
- 個人名。
- スキーマJSON-LDブロック(ユーザー向けの文字列値のみ翻訳)。
フェーズ3のためのプライマリキーワードとセカンダリキーワードを特定します。
フェーズ3:キーワードローカライゼーション
各対象言語に対して:
- ソースキーワードが対象市場で確立された用語かどうかを判断します。そうである場合(例:「Content Marketing」はドイツ語のまま)、そのまま保持します。
- ローカルに相当する用語に実際の検索行動がある場合は、それに置き換えます。
- セカンダリキーワードにも同じロジックを適用します。
- マッピングを記録します。翻訳エージェントはこれを使用して、タイトル、メタ説明、H2見出しを一貫して更新します。
フェーズ4:翻訳
各対象言語に対して、blog-translatorエージェントを(Task経由で)起動し、以下を渡します:
- ソースコンテンツ。
- フェーズ3からのキーワードローカライゼーションマップ。
- 対象言語コード。
- 対象ロケールに文化プロファイルが存在する場合、
references/translation-rules.mdおよびreferences/cultural-adaptation.mdへのポインタ。
複数言語に翻訳する場合は、エージェントを並列で実行します。
エージェントは、入力と同じ形式で完全に翻訳された投稿を返します。
フェーズ5:後処理
各翻訳バージョンに対して:
- ロケールフロントマターを追加または更新します:
lang: "de" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "wie-man-ki-slop-vermeidet" - 構造的一貫性を確認します:
- オリジナルと同じ数のH2セクションとH3セクション。
- すべての画像が存在し、翻訳されたaltテキストがあること。
- すべてのSVGチャートが存在し、翻訳されたテキストラベルがあること(長さ調整:DE +30%、FR +15%、JA -20%、その他は
references/translation-rules.mdを参照)。 - FAQの数が一致すること。
- 各H2に引用カプセルが存在すること。
- 翻訳ファイルを保存します:
translations/ {lang}/{localized-slug}.{ext}blog-multilingualから呼び出された場合、代わりにmultilingual/{lang}/{localized-slug}.{ext}に保存します。
フェーズ6:翻訳品質ガードレール
完了を報告する前に、出力を機械翻訳アーティファクトについてスキャンします:
- 文字通りのイディオム(英語のイディオムが翻字され、適応されていない)。
- 不自然な語順(SVO言語以外でSOVがSVOとして翻訳されている、またはその逆)。
- 混合言語の文(確立された借用語以外)。
- 数値、日付、または通貨文字列がまだソースフォーマットのまま。
- フロントマターの文字列がまだソース言語のまま。
すべての問題をインラインでフラグ付けします(ファイルパス、行番号、修正提案)。翻訳エージェントは、納品前にフラグ付けされた箇所を再パスする必要があります。
フェーズ7:納品
## 翻訳完了: [元のタイトル]
### ソース
- 言語: [ソース]
- ファイル: [ソースパス]
### 翻訳
| 言語 | ファイル | 適応されたキーワード | ステータス |
|--------|---------|---------------------|----------|
| de | translations/de/{slug}.md | [N] | ok |
| fr | translations/fr/{slug}.md | [N] | ok |
### 品質チェック
- 構造的一貫性: 合格 / 不合格(言語ごと)
- メタタグのローカライズ: 合格 / 不合格(言語ごと)
- 数値、日付、通貨のロケールごとのフォーマット: 合格 / 不合格
- キーワードのローカライズ: [N] キーワードを適応
- 機械翻訳アーティファクトのフラグ: [N] (上記の注を参照)
### 次のステップ
- 文化的な深い適応のために `/blog localize <file> --locale <code>` を実行します。
- 完全性を確認するために `/blog locale-audit translations/` を実行します。
- 書き込み、翻訳、ローカライズ、hreflangを1つのコマンドで組み合わせるには `/blog multilingual` を使用します。
エラー処理
| シナリオ | アクション |
|---|---|
| サポートされていない言語コード | 正しいISO 639-1コードを提案する |
| ソース言語と対象言語が同じ | 「ソースは既に [lang] です」と通知してスキップ |
| ファイルが見つからない | 提案されたパスとともにエラーを報告 |
| 翻訳エージェントのタイムアウト | 1回再試行し、その後部分的な結果を報告 |
| バイナリファイルまたは非テキストファイル | エラーを報告し、正しいファイルを提案 |
相互参照
- 次のステップ(文化的深度):
/blog localize <file> --locale <code> - 全言語バージョンのQAスイープ:
/blog locale-audit <directory> - ワンコマンドパイプライン:
/blog multilingual <topic> --languages <codes>