oma-translation

翻訳 — コンテキストを考慮したローカライズ

スケジューリング

目標

プレースホルダー、コード、リンク、書式、用語、ファイル構造など、正確さを保つ必要がある部分を維持しながら、多言語コンテンツを忠実かつ自然に翻訳、レビュー、または調整します。

インテントの特徴

• 翻訳、ローカライズ、翻訳のレビュー、文面の調整、用語集やスタイルガイドの作成。
• 原文の変更後に、対象言語のファイルを更新する。

使用する場合

• UI 文字列、エラーメッセージ、ロケールファイル、ドキュメント、レポート、マーケティング文、散文。
• 正確さ、レジスター、用語、自然さを確認するための既存訳のレビュー。

使用しない場合

• i18n インフラストラクチャ、ロケールの登録、キーの抽出 → 該当する開発スキルを使用します。
• 日付／複数形 API やその他のコードレベルのローカライズ → 該当するコード領域のスキルを使用します。

想定される入力

• 原文、対象言語またはロケール、コンテンツの種類、希望する出力形式。
• 既存のロケールファイル、用語集、周辺の文脈、任意の著者サンプル。
• 原文が構造化されている場合は、プレースホルダーと書式に関する制約。

想定される出力

• 自然な対象言語のテキスト、または根拠に基づくレビュー結果。
• プレースホルダー、コードスパン、リンク、見出し、リスト構造、ロケールキーの厳密な維持。
• 重要な曖昧さや文化的な説明が必要な場合に限った翻訳者向けの注記。

依存関係

• 対象言語のプロファイル：存在する場合は resources/lang/{code}.md。
• 実質的な内容またはレビューでは resources/translation-rubric.md。
• 散文のスタイルレビューが必要な場合は、../_shared/core/anti-ai-prose.md と resources/anti-ai-patterns.md を併用します。
• プロジェクトに翻訳する場合は、既存の同種ファイルと用語集。

制御フローの特徴

• UI の一括処理か散文か、プロファイルの有無、ロケールの種類、曖昧さ、レビュー形式に応じて分岐します。
• コンテンツの種類に必要な対象言語のプロファイルと参照情報のみを読み込みます。
• ユーザーがファイルの変更を依頼した場合に限り、ファイルを編集します。

構造的なフロー

開始

1. 原文、対象ロケール、コンテンツの種類、翻訳・レビュー・差分同期のいずれかを特定します。
2. まず、プレースホルダー、コード、URL、キー、構造マーカーなどの厳密に維持するトークンを保護します。
3. 対象言語のプロファイルがあれば読み込みます。対象がプロジェクト内にある場合は、同種の翻訳も確認します。

各段階

1. 準備：ロケール、出力形式、対象読者、保護対象の構文を確認します。
2. 情報収集：対象言語のプロファイル、関連する同種ファイル、用語集、原文の文脈を確認します。散文またはレビューでは評価基準を読み込み、スタイルレビューでは共通の散文診断資料と翻訳例外を併せて読み込みます。
3. 検討：意味、レジスター、用語、文化的な言及、曖昧さを判断します。慣用表現を解釈するか、置き換えるか、そのまま残すかを決めます。
4. 実行：自然な対象言語のテキストを作成します。意味、意見、個性を付け加えず、プロジェクトで確立されたパターンに合わせます。
5. 検証：保護対象の構文と構造を確認します。実質的な内容については、評価基準に照らして意味、用語、レジスター、対象言語としての自然さを確認します。
6. 仕上げ：依頼されたテキスト、パッチ、またはレビュー結果を、裏付けのある指摘だけに絞って返します。

遷移

• プロファイルがある → 読み込みます。対象言語のルールは共通ガイダンスより優先されます。
• ロケールの種類を指定する必要がある → 下書きの前に確定します。
• プロファイルがない → 共通ガイダンスを使用し、その制約について一度だけ伝えます。他言語のルールは流用しません。
• 独立した短い UI 文字列で、同種の訳が確立されている → 保護対象の構文と同種の訳を確認します。散文の完全なレビューは任意です。
• 長文、ドキュメント、マーケティング文、表とコードが混在する内容、またはレビュー形式 → 評価基準を使用します。
• 結果に影響する曖昧さがある → 要点を絞った質問を一つするか、採用した判断を明示します。
• 差分同期 → 行番号ではなく、見出しと前後の文脈で該当箇所を特定し、原文が変更された箇所に対応する部分のみを変更します。

失敗と復旧

失敗	復旧
対象言語のコンテキストが不足している	ソースレジスターを使用し、意味が変わるほどの曖昧さがない限り、前提を明記します
文字どおりの表現とプロジェクトの慣例が矛盾している	確立された対象言語の慣例に従い、重要な違いがあれば説明します
プレースホルダーまたは構造が一致しない	出力またはパッチの適用前に修正します
プロファイルがない	共通ガイダンスを使用し、対象範囲の制限を一度明記します
文化的な表現が不明瞭	対象読者に必要な場合に限り、簡潔な注記を追加します

終了条件

• 成功：テキストが忠実かつ自然で、構造上安全であり、内容のリスクに応じて確認されています。
• 部分完了：未解決の曖昧さや不足しているコンテキストを明記し、答えを捏造していません。

言語プロファイルの読み込み

BCP 47 の主要サブタグを特定し、一致するプロファイルがあれば読み込みます。

対象言語	プロファイル
韓国語	resources/lang/ko.md
日本語	resources/lang/ja.md
中国語	resources/lang/zh.md。宣言されたバリアントを特定します
英語	resources/lang/en.md
その他	プロファイルなし。共通ガイダンスを使用します

プロファイルでは、表記、文体、対象言語での確認項目を定めます。共通ガイダンスでは、よくあるリスクを説明します。両者が矛盾する場合は、プロファイルを優先します。このスキルを拡張するタスクである場合に限り、resources/lang/_template.md を使って新しいプロファイルを追加します。

翻訳方法

1. 意味、意図する効果、分野固有の用語、保護対象の構文を読み取ります。比喩的な表現は、解釈する、置き換える、維持するのいずれかに分類します。理由なく新しい比喩を加えたり、意図された比喩を取り除いたりしないでください。
2. 原文、対象読者、類似の翻訳をもとに文体を選びます。.agents/oma-config.yaml の translation_voice は、リズムと形式の好みとしてのみ適用します。選択肢は formal、balanced（既定）、interpreter です。意味や対象言語の規範より優先されることはありません。
3. 対象言語で文章を組み立て直します。対象言語に合わせて語順を変え、文を分割または結合し、省略された主語を補わないこともできます。
4. 原文の文体を維持するのは、説明文、会話文、翻案、またはユーザーが明示的に作成したドキュメントに限ります。確認できるリズムと語彙に合わせ、事実、立場、冗談、一人称、強い感情を新たに加えないでください。

検証

必ず次の項目を確認します。

• すべてのプレースホルダー、コードスパン、識別子、URL、ロケールキーが変更されていないこと。
• 見出し、リンク、表の行、リストの入れ子、コードブロックの構造が維持されていること。
• 対象言語のプロファイルに定められた表記と文体に従っていること。
• 既存の類似文書で用語や UI の表記が定まっている場合、それに合わせていること。

内容の充実した翻訳とレビューでは、評価基準も確認します。評価項目は、意味、自然さ、用語、文体、文化的適合性、感情的な強さです。AI らしさを避けるためのパターンは診断として使い、文章を飾り立てたり、意図された原文の文体を取り除いたりするために使わないでください。

レビューモード

すべての草稿が機械翻訳だと決めつけず、根拠に基づいてレビューします。重大な欠陥が確認できない場合は、指摘をゼロ件とします。次の項目を分けて記録します。

• 正確性または安全性の欠陥：意味の変更、プレースホルダーの破損、誤った用語、または不適切な文体。
• 根拠のあるスタイル上の指摘：問題の理由と修正案を示した、対象言語に関する具体的な問題。
• 好み：既存の訳を誤りにしない、任意の代替案。

問題のない翻訳を、指摘を作り出すためだけに書き換えないでください。

一括処理と差分同期

一括処理では、まず対象全体を読み、値のみを翻訳して、用語と文体の決定を一貫させます。対象全体を通してプレースホルダーとキー構造を確認します。

差分同期では、見出しと周辺のコンテキストを使って、各ソースの差分範囲を対応づけます。影響を受ける対象言語のセクションだけを編集し、無関係なテキストはバイト単位で変更しないでください。更新したセクション、省略した表記上のみの変更、重要な用語の決定を明記します。

出力形式

単一のテキストの場合は、翻訳と、曖昧さや調整についての簡単な注記を提示します。ファイルの場合は、入力形式を維持し、依頼された値のみを変更します。レビューの場合は、原文、必要な場合に限った修正案、および各指摘の根拠を示します。

論理操作

アクション

アクション	SSL プリミティブ	根拠
ロケールとモードを特定する	SELECT	ユーザーの依頼とファイルのコンテキスト
条件に応じてプロファイルと関連ファイルを読む	READ	対象プロファイル、用語集、近接する翻訳
構文と構造を保護する	VALIDATE	原文のトークンと構造マーカー
意味と文体を推測する	INFER	原文、読者、プロジェクトの規約
翻訳または修正する	WRITE	翻訳文または依頼されたファイルのパッチ
内容の実質的な部分をレビューする	VALIDATE	評価基準と具体的な指摘
結果と制限を報告する	NOTIFY	翻訳、パッチ、またはレビュー

ツールと手段

• ローカルの原文と関連する翻訳には、ネイティブの検索／読み取り機能を使用します。
• 利用可能な場合は、コードコンテキストのナビゲーションに設定済みの code_intelligence 機能を使用します。利用できない場合やタイムアウトした場合は、ネイティブの検索／読み取り機能を使用します。
• 上記で選択した対象プロファイル、評価基準、AI らしさを避けるためのパターン、および言語テンプレートのリソース。

標準的なワークフロー

1. 対象ロケールを特定し、正確な構文を保護します。
2. 該当する言語プロファイルを 1 つと関連するファイルを読み込みます。内容の実質的な部分を扱う場合やレビューの場合は、評価基準も読み込みます。文章スタイルのレビューでは、共有スタイルの修正より先に、翻訳上の例外を適用しながら ../_shared/core/anti-ai-prose.md と resources/anti-ai-patterns.md を読み込みます。
3. 意味、文体、用語、比喩表現の扱いを推測します。
4. 対象言語の自然な語順とプロジェクトのスタイルで下書きします。
5. 正確な構文と構造を確認し、評価基準に照らして内容の実質的な部分をレビューします。
6. 依頼された翻訳、パッチ、または根拠に基づくレビューを出力します。重要なプロファイルやコンテキストが不足している場合は、その制限を明記します。

リソースの範囲

範囲	リソースの対象
LOCAL_FS	原文／対象ファイル、用語集、言語プロファイル
CODEBASE	関連する翻訳とコードコンテキスト
PROCESS	ネイティブの検索と構文チェック
MEMORY	ロケール、用語、文体、保護対象の構文、未解決の曖昧さ

効果と副作用

• 翻訳文またはレビューの指摘を生成します。
• 明示的に依頼された場合に限り、ロケール／ドキュメントのファイルを変更します。
• 原文の構造、識別子、プレースホルダーを保持します。

ガードレール

1. 文体上の好みより、意味、保護対象の構文、ファイル構造を優先します。
2. 事実、意見、感情的な強調、例、引用、個性を作り出しません。
3. 別の言語のプロファイルを代用しません。
4. 差分同期では、変更対象ではないセクションを変更しません。
5. 利用可能な原文では裏付けられないチェックの完了を主張しません。

参考資料

• 翻訳評価基準：resources/translation-rubric.md（内容の実質的な部分を扱う場合やレビューの場合に読み込みます）
• 一般的な文章の診断：../_shared/core/anti-ai-prose.md（文章スタイルのレビューが必要な場合、翻訳上の例外とともに読み込みます）
• 翻訳上の例外と文法の診断：resources/anti-ai-patterns.md（文章スタイルのレビューが必要な場合、一般的な診断とともに読み込みます）
• 対象言語のプロファイル：resources/lang/{ko,ja,zh,en}.md（該当するプロファイルを 1 つ読み込みます）
• プロファイルのテンプレート：resources/lang/_template.md（プロファイルを追加する場合に限り使用します）
• 共有コンテキストの読み込み：../_shared/core/context-loading.md
• 共有品質原則：../_shared/core/quality-principles.md