translation について
AI エージェント向けの翻訳スキルで、文脈、対象読者、地域に合わせて訳文を調整します。書式と用語を保ちながら、慣用表現、文化的背景、丁寧さにも対応します。
主な機能
- 01文脈・分野・文体の分析
- 02用語集による用語の統一
- 03書式とプレースホルダーの保持
- 04文化的要素と地域慣習への適応
- 05正確さと自然さの確認
- 06曖昧な訳語の選択に関する注記
活用シーン
- 01技術文書の翻訳
- 02UI 文字列や構造化ファイルのローカライズ
- 03対象地域に合わせたマーケティング文案の調整
- 04法律文書や一般文章の翻訳
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ seb1n/ awesome-ai-agent-skills --skill translationインストール後、Claude Code で/translationを入力して読み込まれたか確認します。
詳細
翻訳
このスキルを使うと、AI エージェントは意味、トーン、文脈を保ちながら、言語間でテキストを翻訳できます。単語をそのまま置き換えるだけでなく、慣用表現、文化的なニュアンス、分野固有の用語、敬語のレベルにも対応します。技術文書、マーケティングコピー、UI 文字列、法的文書、一般的な文章を翻訳でき、出力は対象ロケールの慣習に合わせて調整されます。
ワークフロー
-
原文の文脈を分析する 原文を確認し、分野(技術、マーケティング、法律、カジュアルなど)、文体(フォーマル、インフォーマル、中立)、想定読者を判断します。直訳ではなく調整が必要な慣用表現、文化固有の言及、ユーモアを特定します。出力で構造を保てるよう、文書の形式(プレーンテキスト、Markdown、JSON、HTML)も確認します。
-
用語を調べる 専門的な内容では、用語の一貫性を保つため、用語集を作成するか参照します。技術文書では、分野の用語を正確に翻訳する必要があります(例:「endpoint」は多くの言語で「endpoint」のままにするか、広く受け入れられている同等の用語に置き換えます)。マーケティングコピーでは、直接翻訳ではなく、創造的な翻案が必要になる場合があります。ユーザーが用語集や翻訳メモリを提供した場合は、翻訳を始める前に取り入れます。
-
コンテンツを翻訳する 判断したトーン、敬語のレベル、用語に従って翻訳を作成します。Markdown の見出し、コードブロック、HTML タグ、JSON のキーなど、すべての書式マーカーを保持します。UI 文字列では、プレースホルダートークン(例:
{username}、%d)をそのまま残し、対象言語の文法に適した位置に配置します。対象言語固有の複数形の規則にも対応します。 -
文化的な言及をローカライズする 単位、日付形式、通貨記号、文化に根ざした比喩を対象ロケールに合わせて調整します。たとえば、ヨーロッパの読者向けに翻訳する場合はマイルをキロメートルに換算したり、アメリカのスポーツの比喩を対象文化になじみのあるものに置き換えたりします。マーケティングコンテンツでは、スローガンや行動喚起が対象言語でも同じ訴求力を持つようにします。
-
正確さと流暢さを確認する 翻訳を読み返し、文法的な正しさ、自然な表現、原文の意味が忠実に伝わっていることを確認します。文の抜けや重複がないことを確かめます。手順 2 で作成した用語集と照合し、文書全体で用語が一貫していることを確認します。
-
注釈を添えて提出する 原文と同じ形式で翻訳文を返します。翻訳の判断が難しい箇所があれば、その理由を説明する簡潔な翻訳者注を添えます。複数の敬語レベルや地域別の訳文を求められた場合は、それぞれを明確に区別して提示します。
使用方法
翻訳するテキストと対象言語を指定してください。必要に応じて、次の項目も指定できます。
- 原文の言語(自動判定できない場合)
- 敬語のレベル — フォーマル、インフォーマル、中立
- 分野 — 技術、マーケティング、法律、医療、一般
- 用語集 — 重要な用語と指定する訳語
- 出力形式 — プレーンテキスト、Markdown、JSON ロケールファイルなど
プロンプトの例:「次の API エラーメッセージを日本語(フォーマル)に翻訳してください。JSON の構造とすべてのプレースホルダートークンはそのまま保持してください。」
例
例 1:技術的な段落の翻訳(英語からドイツ語、フォーマル)
入力:
認証モジュールは OAuth 2.0 と PKCE を使用して API リクエストを保護します。ユーザーがログインを開始すると、クライアントはコードベリファイアとコードチャレンジを生成します。認可サーバーは、アクセストークンを発行する前にチャレンジを検証します。トークンは 3600 秒後に有効期限が切れるため、リフレッシュトークンエンドポイントを使用して更新する必要があります。
出力:
Das Authentifizierungsmodul verwendet OAuth 2.0 mit PKCE, um API-Anfragen abzusichern. Wenn ein Benutzer eine Anmeldung einleitet, erzeugt der Client einen Code-Verifier und eine Code-Challenge. Der Autorisierungsserver validiert die Challenge, bevor er ein Zugriffstoken ausstellt. Token laufen nach 3600 Sekunden ab und müssen über den Refresh-Token-Endpunkt erneuert werden.
翻訳者注:「Code Verifier」、「Code Challenge」、「Refresh-Token-Endpunkt」は、ドイツ語圏の開発者コミュニティで定着している用語のため、英語の原語に近い表現にしています。
例 2:UI 文字列のローカライズ(英語からスペイン語、JSON ロケールファイル)
入力:
{
"greeting": "Hello, {username}!",
"items_in_cart": "You have {count} item(s) in your cart.",
"checkout_button": "Proceed to Checkout",
"empty_cart": "Your cart is empty. Start shopping!",
"order_confirmation": "Your order #{orderId} has been placed on {date}."
}
出力:
{
"greeting": "Hola, {username}!",
"items_in_cart": "Tienes {count} artículo(s) en tu carrito.",
"checkout_button": "Proceder al pago",
"empty_cart": "Tu carrito está vacío. ¡Empieza a comprar!",
"order_confirmation": "Tu pedido n.º {orderId} se ha realizado el {date}."
}
**翻訳者注:**プレースホルダートークン {username}、{count}、{orderId}、{date} はそのまま保持します。くだけた「tú」形を使用しています。フォーマルな文脈では「usted」に切り替えてください。
ベストプラクティス
- 書式と構造を保持します。 翻訳時に Markdown、HTML タグ、JSON キーを削除しないでください。翻訳後の出力は、元の形式にそのまま差し替えて使用できる必要があります。
- 用語の一貫性を保ちます。 ドキュメント全体を通して、同じ原語には同じ訳語を使用してください。最初に用語集を作成し、常に参照してください。
- 敬語のレベルに配慮します。 日本語、韓国語、ドイツ語、スペイン語などの言語には、フォーマルとインフォーマルで異なる表現があります。翻訳を始める前に、希望する文体を必ず確認してください。
- 複数形のルールに対応します。 多くの言語には複雑な複数形の規則があります(例:アラビア語には 6 種類あります)。数に応じてテキストが変わる UI 文字列を翻訳する場合は、翻訳先の言語の複数形のシステムを考慮してください。
- 慣用句の直訳を避けます。 「hit the ground running」や「low-hanging fruit」のような表現は、一語一句訳すのではなく、翻訳先の言語で相当する表現に置き換えてください。
- 曖昧な訳語の選択に注記を付けます。 原語に複数の適切な訳がある場合は、選んだ訳語と別の候補を説明する短い注記を添えてください。
エッジケース
- 翻訳できない用語: 一部の技術用語(例:「API」、「OAuth」、「webhook」)には、言語によって標準的な訳語がありません。その場合は原語のままにし、その判断を注記してください。
- 右から左に記述する言語: アラビア語、ヘブライ語、ペルシア語に翻訳する場合は、アラビア語の文中にある英語のブランド名など、文字方向が混在するテキストを適切な双方向テキストマーカーで処理してください。
- 文字エンコーディング: CJK 言語では、固定幅の UI フィールドで文字列の長さに関する問題が発生することがあります。原文の文字数を大幅に超える翻訳にはフラグを付けてください。
- ジェンダーニュートラルな表現: 翻訳先の言語によっては、文法上の性が必要です。原文がジェンダーニュートラルな場合は、ユーザーに確認するか、性別ごとの表現を両方提示してください。
- 空またはプレースホルダーのみの原文: 原文がプレースホルダーのみ、または空文字列の場合は、変更せずに返し、翻訳が不要だったことを注記してください。