@vantagesec/socc 0.1.13 → 0.1.15

package/socc-canonical/.agents/soc-copilot/skills/translation-expertise/translation-challenges.md

@@ -1,603 +0,0 @@
-# Common Translation Challenges
-
-This document provides detailed examples and strategies for handling common translation challenges between English, Japanese, and Traditional Chinese.
-
-## Challenge 1: Idioms and Expressions
-
-**Strategy**: Find equivalent expressions, not word-for-word translations. The goal is to convey the same meaning and impact in the target language, even if the imagery or metaphor changes completely.
-
-### Example 1: "Break a leg"
-
-**Context**: Wishing someone good luck before a performance
-
-**Literal Translation Issues**:
-
-- **Japanese**: 「足を折って」(ashi wo otte) - Sounds like wishing harm on someone
-- **Chinese**: 「打斷腿」(daduan tui) - Violent and inappropriate
-
-**Correct Translation with Reasoning**:
-
-**Japanese**: 頑張って (ganbatte) - "Do your best"
-
-- **Why**: Standard encouragement phrase in Japanese culture
-- **Cultural note**: Japanese culture prefers direct encouragement over superstitious phrases
-- **Alternative**: 成功を祈ります (seikou wo inorimasu) - "I pray for your success" (more formal)
-
-**Chinese**: 加油 (jiayou) - "Add oil" (idiomatic: "Go for it")
-
-- **Why**: Common encouragement phrase that matches the supportive tone
-- **Alternative**: 祝你成功 (zhu ni chenggong) - "Wishing you success" (more formal)
-- **Regional note**: 加油 is universal across all Chinese-speaking regions
-
-### Example 2: "It's raining cats and dogs"
-
-**Context**: Describing heavy rain
-
-**Literal Translation Issues**:
-
-- Would be completely incomprehensible in both Japanese and Chinese
-- Animal metaphors for weather differ across cultures
-- Direct translation would sound bizarre and confusing
-
-**Correct Translation with Reasoning**:
-
-**Japanese**: 土砂降りだ (doshaburi da) - "Dirt and sand pouring"
-
-- **Why**: Standard Japanese idiom for heavy rain
-- **Cultural note**: Uses earthy imagery of mud/landslide intensity
-- **Alternatives**:
-  - バケツをひっくり返したような雨 (baketsu wo hikkuri kaeshita you na ame) - "Rain like overturned buckets" (more descriptive)
-  - どしゃ降り (doshaburi) in hiragana for casual contexts
-
-**Chinese**: 傾盆大雨 (qingpen dayu) - "Overturning basin big rain"
-
-- **Why**: Classical four-character idiom (成語) for heavy rain
-- **Cultural note**: Uses water vessel imagery common in Chinese idioms
-- **Alternatives**:
-  - 下大雨 (xia dayu) - "Big rain falling" (simpler, less idiomatic)
-  - 滂沱大雨 (pangtuó dayu) - "Torrential rain" (literary)
-
-### Example 3: "Piece of cake"
-
-**Context**: Something very easy to do
-
-**Literal Translation Issues**:
-
-- Food metaphors don't transfer between cultures
-- Each culture has different associations with cake
-- Cake as "luxury/special" varies across cultures
-
-**Correct Translation with Reasoning**:
-
-**Japanese**: 朝飯前 (asameshi mae) - "Before breakfast"
-
-- **Why**: Traditional Japanese idiom meaning something so easy it can be done before breakfast
-- **Cultural note**: Reflects Japanese value of early morning productivity
-- **Alternatives**:
-  - 楽勝 (rakushou) - "Easy victory" (more casual, modern)
-  - 簡単だよ (kantan da yo) - "It's simple" (direct but less idiomatic)
-
-**Chinese**: 小菜一碟 (xiaocai yidie) - "Small dish"
-
-- **Why**: Common idiom comparing easy tasks to a simple side dish
-- **Cultural note**: Uses food metaphor but with different food item (small dish vs. cake)
-- **Alternatives**:
-  - 輕而易舉 (qing'er yijǔ) - "Light and easy to lift" (formal)
-  - 易如反掌 (yi rú fan zhang) - "Easy as turning over palm" (classical)
-
-### Example 4: "Spill the beans"
-
-**Context**: Reveal a secret
-
-**Literal Translation Issues**:
-
-- Bean-related metaphor doesn't exist in Japanese/Chinese
-- Would sound completely nonsensical if translated literally
-- No cultural connection between beans and secrets
-
-**Correct Translation with Reasoning**:
-
-**Japanese**: 秘密をばらす (himitsu wo barasu) - "Expose the secret"
-
-- **Why**: Direct and clear; Japanese often prefers clarity over metaphor in this context
-- **Alternatives**:
-  - 口を滑らす (kuchi wo suberasu) - "Slip the mouth" (implies accidental revealing)
-  - ネタバレする (netabare suru) - "Spoil" (modern slang, from internet culture)
-
-**Chinese**: 洩漏秘密 (xielou mimi) - "Leak the secret"
-
-- **Why**: Straightforward expression commonly used
-- **Alternatives**:
-  - 說漏嘴 (shuo lou zui) - "Speak leaked mouth" (colloquial, implies accidental)
-  - 揭露秘密 (jielu mimi) - "Reveal secret" (more formal)
-
-### Example 5: "Hit the nail on the head"
-
-**Context**: Be exactly right / Get to the point accurately
-
-**Literal Translation Issues**:
-
-- Carpentry metaphor doesn't translate culturally
-- Different cultures have different expressions for accuracy
-- The physical act of nailing has no metaphorical meaning in target cultures
-
-**Correct Translation with Reasoning**:
-
-**Japanese**: 的を射る (mato wo iru) - "Hit the target"
-
-- **Why**: Uses archery metaphor instead, widely understood idiom
-- **Cultural note**: Archery (kyudo) has cultural significance in Japan
-- **Alternatives**:
-  - 正鵠を得る (seikoku wo eru) - "Get the bullseye" (more formal, same origin)
-  - 核心をつく (kakushin wo tsuku) - "Strike the core" (direct)
-
-**Chinese**: 一針見血 (yi zhen jian xue) - "One needle sees blood"
-
-- **Why**: Classical idiom using acupuncture metaphor for getting to the point
-- **Cultural note**: Medical/acupuncture metaphor reflects Chinese cultural background
-- **Alternatives**:
-  - 切中要害 (qiezhong yaohai) - "Cut to the vital point"
-  - 一語中的 (yi yǔ zhongdi) - "One phrase hits the target"
-
-### Example 6: "Kill two birds with one stone"
-
-**Context**: Accomplish two things with one action
-
-**Japanese**: 一石二鳥 (isseki nichou)
-
-- **Why**: This idiom actually exists in Japanese (borrowed concept)
-- **Note**: Direct parallel exists, so translation is straightforward
-
-**Chinese**: 一石二鳥 (yi shi er niao) or 一舉兩得 (yi jǔ liǎng dé)
-
-- **Why**: Both versions exist; the second means "one action, two gains" (more common)
-- **Note**: Shows how some Western idioms have been adopted
-
-## Challenge 2: Cultural References
-
-**Strategy**: Adapt or explain references unfamiliar to target culture. Consider whether the specific cultural reference is essential to meaning, or if the underlying concept can be conveyed through a more familiar equivalent.
-
-### Example 1: "Turkey on Thanksgiving"
-
-**Original Context**: American holiday tradition, centerpiece of family gathering meal
-
-**Translation Approaches**:
-
-**Japanese**:
-
-**Option 1 - Direct + Explanation**: 感謝祭の七面鳥 (Kanshasai no shichimenchou)
-
-- Add brief explanation: アメリカの感謝祭に食べる伝統的な料理
-- **When to use**: When discussing American culture specifically
-- **Pros**: Accurate, educational
-- **Cons**: May feel distant to Japanese readers
-
-**Option 2 - Cultural Adaptation**: お正月のおせち料理 (Oshougatsu no osechi ryouri)
-
-- Translation: New Year's feast dishes
-- **Why**: Similar role as holiday feast centerpiece in Japanese culture
-- **When to use**: When the function matters more than the specific tradition
-- **Pros**: Relatable to Japanese audience
-- **Cons**: Changes the specific cultural reference
-
-**Option 3 - Generalization**: 伝統的な祝日料理 (dentouteki na shukujitsu ryouri)
-
-- Translation: Traditional holiday food
-- **When to use**: When specific holiday doesn't matter
-- **Pros**: Clear and neutral
-- **Cons**: Loses cultural specificity
-
-**Chinese**:
-
-**Option 1 - Direct + Explanation**: 感恩節火雞 (gan'en jie huoji)
-
-- Add context: 美國感恩節的傳統大餐
-- **When to use**: Educational or cultural content about America
-
-**Option 2 - Cultural Adaptation**: 年夜飯 (nianye fan)
-
-- Translation: New Year's Eve dinner (reunion dinner)
-- **Why**: Important family gathering meal in Chinese culture
-- **When to use**: When emphasizing family gathering aspect
-
-**Option 3 - Keep + Context**: 美國感恩節的傳統火雞大餐
-
-- Translation: American Thanksgiving's traditional turkey feast
-- **Why**: Makes the American context clear while keeping the specific reference
-
-### Example 2: Baseball metaphors
-
-**Original Context**: "Home run" (great success), "Strike out" (fail completely)
-
-**Translation Approaches**:
-
-**Japanese**:
-
-**Option 1 - Keep original**: ホームラン (hoomuran), ストライクアウト (sutoraiku auto)
-
-- **Why**: Baseball is extremely popular in Japan; terms are widely understood
-- **Best choice**: Keep the baseball reference in most cases
-- **Cultural note**: Japan has professional baseball leagues; the sport is culturally familiar
-
-**Option 2 - Adapt meaning**: 大成功 (daiseikou) / 失敗 (shippai)
-
-- Translation: Great success / Failure
-- **When to use**: If baseball context isn't relevant or might be confusing
-- **Pros**: Universal understanding
-- **Cons**: Loses the vivid imagery
-
-**Chinese**:
-
-**Option 1 - Keep + explain**: 全壘打 (quanlei da)
-
-- **Context**: Baseball terminology understood in Taiwan and Hong Kong
-- **Regional note**: More familiar in Taiwan than mainland China
-
-**Option 2 - Adapt**: 一舉成功 (yiju chenggong) / 完全失敗 (wanquan shibai)
-
-- Translation: Succeed in one stroke / Complete failure
-- **Why**: Baseball less culturally prominent in mainland China
-- **When to use**: When audience is primarily mainland Chinese
-
-**Decision factors**:
-
-- Taiwan readers: Keep baseball terms (baseball is popular)
-- Hong Kong readers: Keep with brief explanation
-- Mainland readers: Consider adapting unless in sports context
-
-### Example 3: Roman mythology references
-
-**Original Context**: "Achilles' heel" (fatal weakness)
-
-**Translation Approaches**:
-
-**Japanese**:
-
-**Direct translation**: アキレス腱 (Akiresu ken)
-
-- **Why**: This particular reference has become international; commonly used in Japanese
-- **Best choice**: Keep as is; widely understood even outside sports/medical contexts
-- **Note**: Used metaphorically in Japanese just as in English
-
-**Alternative**: 弱点 (jakuten) or 急所 (kyuusho)
-
-- Translation: Weakness / Vital point
-- **When to use**: If context makes the reference unclear or overly foreign
-
-**Chinese**:
-
-**Option 1 - Direct translation**: 阿基里斯腱 (Ajiilisi jian)
-
-- Used in formal/academic contexts
-- **Pros**: Accurate for educated audiences
-- **Cons**: May be unfamiliar to general readers
-
-**Option 2 - Cultural adaptation**: 致命弱點 (zhiming ruodian)
-
-- Translation: Fatal weakness
-- **Better choice**: More accessible to general audience
-- **Pros**: Clear meaning without requiring classical Western knowledge
-
-**Option 3 - Literary option**: 命門 (mingmen)
-
-- Translation: "Life gate" (vital point/weakness)
-- **Why**: Classical Chinese term from martial arts/medicine
-- **When to use**: Formal or literary texts
-- **Cultural note**: Has roots in traditional Chinese medicine
-
-### Example 4: Biblical references
-
-**Original Context**: "Good Samaritan" (someone who helps strangers)
-
-**Japanese**:
-
-- **Direct**: 良きサマリア人 (yoki samaria jin) - rarely understood
-- **Adapted**: 困っている人を助ける親切な人 (komatte iru hito wo tasukeru shinsetsu na hito)
-  - Translation: "Kind person who helps people in trouble"
-- **Best approach**: Explain or adapt, as Christianity is minority religion
-
-**Chinese**:
-
-- **Direct**: 好撒馬利亞人 (hǎo Samǎlìyà rén) - understood in Christian contexts only
-- **Adapted**: 樂於助人的好心人 (lè yú zhù rén de hǎo xīn rén)
-  - Translation: "Warm-hearted person happy to help others"
-- **Context matters**: Christian audiences understand reference; general audiences don't
-
-## Challenge 3: Wordplay and Puns
-
-**Strategy**: Recreate the effect, not the exact wordplay. Puns are highly language-specific. The translator's goal is to convey that humor exists and ideally create a similar effect, even if the mechanism changes completely.
-
-### Example 1: "Time flies like an arrow; fruit flies like a banana"
-
-**Original Wordplay**: "Flies" used as verb (time) and noun (fruit)
-
-**Translation Challenge**: This specific wordplay is impossible to recreate in target languages
-
-**Solutions**:
-
-**Japanese**:
-
-**Option 1 - Explain**: 時は矢のように飛ぶが、ミバエはバナナが好きだ
-
-- Translation: "Time flies like an arrow, but fruit flies like bananas"
-- **Why**: Preserves the joke structure even though wordplay is lost
-- **Result**: Audience understands it was a pun in English
-- **Add note**: (英語の言葉遊び) "English wordplay"
-
-**Option 2 - Different wordplay**: Create new pun in Japanese
-
-- Example: 時は金なり、銀なりたくない (toki wa kin nari, gin naritakunai)
-  - Translation: "Time is money (gold), (but I) don't want to become silver"
-  - **Why**: Creates new wordplay on 金 (gold/money) and なり (is/become)
-  - **Pros**: Maintains the humor and surprise
-  - **Cons**: Completely different from original joke
-
-**Chinese**:
-
-**Option 1 - Preserve structure**: 時光飛逝如箭,果蠅喜歡香蕉
-
-- Translation: "Time flies like arrow, fruit flies like banana"
-- **Result**: Keeps the surprising twist but loses the linguistic pun
-- **Add note**: (英語雙關語) "English pun"
-
-**Option 2 - Create new pun**: 時間不等人,但人可以等時間
-
-- Translation: "Time waits for no one, but people can wait for time"
-- **Why**: Creates parallel structure with philosophical twist
-- **Pros**: Maintains surprise element
-- **Cons**: Different type of wordplay (philosophical rather than grammatical)
-
-### Example 2: Business name puns
-
-**Original**: "Curl Up and Dye" (hair salon)
-**Wordplay**: Sounds like "curl up and die"
-
-**Translation Challenge**: Sound-based wordplay specific to English pronunciation
-
-**Solutions**:
-
-**Japanese**:
-
-**Option 1 - Explain meaning**: カールアップ・アンド・ダイ (髪を染めてカールする店)
-
-- Keep romanization + add explanation in parentheses
-- **When to use**: When the English name is kept for branding
-
-**Option 2 - Create Japanese pun**:
-
-- Example: 髪切るべー (kamikiru bē)
-  - Sounds like casual "let's cut hair" in some dialects
-  - Plays on 髪 (kami - hair) and casual invitation
-- Example: カミングアップ (kamingu appu)
-  - Plays on 髪 (kami - hair) and "coming up"
-  - **Why**: Creates bilingual wordplay (Japanese 髪 + English "coming up")
-
-**Chinese**:
-
-**Option 1 - Direct translation**: 捲染髮廊
-
-- Translation: "Curl and dye salon"
-- **Result**: Loses the pun entirely; just descriptive
-
-**Option 2 - Create Chinese pun**:
-
-- Example: 髮現美 (faxian mei)
-  - Sounds like 發現美 (discover beauty)
-  - Uses 髮 (hair) character instead of 發
-- Example: 剪愛你 (jian ai ni)
-  - Sounds like 見愛你 (see love you) or 建愛你 (build love for you)
-  - Uses 剪 (cut/scissors) character
-  - **Why**: Creates Chinese-specific sound-based wordplay
-
-### Example 3: "Why did the scarecrow win an award? He was outstanding in his field"
-
-**Original Wordplay**: "Outstanding in his field" means both "excellent in his profession" and "standing in a field"
-
-**Translation Challenge**: Double meaning specific to English
-
-**Solutions**:
-
-**Japanese**:
-
-**Option 1 - Explain joke**:
-
-- かかしが賞を取った理由は?畑で最も優れていたから(実際に畑に立っていた)
-- Translation: "Why did scarecrow win? Because he was most excellent in the field (actually standing in the field)"
-- **Result**: Joke explained but less punny; parenthetical clarifies the wordplay
-
-**Option 2 - Create new scarecrow joke**:
-
-- Example: かかしが人気者になった理由は?いつも畑にいるから
-  - Translation: "Why did scarecrow become popular? Because he's always in the field"
-  - Plays on いる (present/committed) - weaker pun but maintains humor structure
-
-**Chinese**:
-
-**Option 1 - Adapt the pun**:
-
-- 稻草人為什麼得獎?因為他在自己的領域裡站得最高(出眾)
-- Translation: "Why did scarecrow win? Because he stood tallest in his field (outstanding)"
-- **Result**: Partially preserves the standing/outstanding wordplay using 站 (stand) and 出眾 (outstanding/standing out)
-
-**Option 2 - Different approach**:
-
-- Use 田間 (field) and 傑出 (outstanding) with footnote explaining English pun
-- **When to use**: When precision matters more than humor preservation
-
-## Challenge 4: Formality Levels
-
-**Strategy**: Understand formality indicators in each language and match them appropriately across languages.
-
-### English Formality Indicators
-
-**Informal**:
-
-- Contractions: don't, can't, won't
-- Simple vocabulary: buy, help, get
-- Personal pronouns: you, I, we
-- Short sentences
-- Colloquialisms and slang
-
-**Formal**:
-
-- No contractions: do not, cannot, will not
-- Sophisticated vocabulary: purchase, assist, obtain
-- Passive voice: "It is recommended that..."
-- Complex sentence structures
-- Technical or literary terms
-
-### Japanese Formality Levels
-
-**Casual (Plain form)**:
-
-- 食べる (taberu), 行く (iku), いい (ii), だ (da)
-- Pronouns: 俺 (ore - masculine), あたし (atashi - feminine)
-- Sentence endings: だ, だよ, だね
-
-**Standard Polite (です/ます form)**:
-
-- 食べます (tabemasu), 行きます (ikimasu), いいです (ii desu)
-- Pronouns: 私 (watashi), あなた (anata - use sparingly)
-- Sentence endings: です, ます
-
-**Formal/Respectful**:
-
-- いらっしゃる (irassharu), 召し上がる (meshiagaru)
-- Pronouns: わたくし (watakushi)
-- Honorific prefixes: ご〜 (go-), お〜 (o-)
-- Sentence endings: でございます (de gozaimasu)
-
-### Chinese Formality Indicators
-
-**Informal**:
-
-- Simple vocabulary: 吃 (chi - eat), 買 (mai - buy)
-- Pronouns: 你 (ni - you), 我們 (women - we)
-- Colloquial expressions
-- Sentence-final particles: 啦, 嘍, 唄
-
-**Formal**:
-
-- Literary vocabulary: 用餐 (yongcan - dine), 購買 (goumai - purchase)
-- Pronouns: 您 (nin - polite "you"), 本人 (benren - "this person" for "I")
-- Classical expressions: 誠摯 (chengzhi - sincere), 敬請 (qingqing - respectfully request)
-- More complex sentence structures
-- Formal sentence patterns
-
-### Translation Example: "Please let me know if you have any questions"
-
-**English Informal**: Let me know if you have any questions
-
-**English Formal**: Please do not hesitate to contact me should you have any inquiries
-
-**Japanese Casual**: 質問があったら教えてね (Shitsumon ga attara oshiete ne)
-
-**Japanese Polite**: ご質問があればお知らせください (Go-shitsumon ga areba o-shirase kudasai)
-
-**Japanese Formal**: ご不明な点がございましたら、お気軽にお問い合わせくださいませ
-
-- (Go-fumei na ten ga gozaimashitara, o-kigaru ni o-toiawase kudasaimase)
-
-**Chinese Informal**: 有問題就告訴我 (You wenti jiu gaosu wo)
-
-**Chinese Polite**: 如有問題請告訴我 (Ru you wenti qing gaosu wo)
-
-**Chinese Formal**: 如有任何疑問,敬請隨時與我聯繫 (Ru you renhe yiwen, qingqing suishi yu wo lianxi)
-
-## Challenge 5: Ambiguity Resolution
-
-**Strategy**: When source text is ambiguous, use context clues, research, and informed judgment to determine the most likely intended meaning.
-
-### Types of Ambiguity
-
-**1. Lexical Ambiguity** (word has multiple meanings)
-
-**Example**: "I saw her duck"
-
-- Did I see her pet duck?
-- Did I see her lower her head?
-
-**Resolution approach**:
-
-- Check surrounding context
-- Consider what makes sense in the situation
-- If truly ambiguous, choose most common meaning
-- Note the ambiguity for reviewer
-
-**2. Structural Ambiguity** (sentence structure creates multiple meanings)
-
-**Example**: "The chicken is ready to eat"
-
-- The chicken is cooked and ready for us to eat
-- The chicken (alive) is hungry and ready to eat food
-
-**Resolution approach**:
-
-- Analyze broader context
-- Consider the document type (recipe vs. farm guide)
-- Choose interpretation that fits the context
-
-**3. Referential Ambiguity** (unclear what a pronoun refers to)
-
-**Example**: "John told Mike that he needed to leave"
-
-- Who needs to leave - John or Mike?
-
-**Resolution approach**:
-
-- Look at preceding and following sentences
-- Consider the logical flow
-- In translation, may need to use names instead of pronouns for clarity
-
-**4. Cultural Ambiguity** (meaning unclear across cultures)
-
-**Example**: "Let's table this discussion"
-
-- US English: Postpone the discussion
-- UK English: Put it on the table (discuss it now)
-
-**Resolution approach**:
-
-- Determine the source variety (US vs. UK English)
-- Consider speaker's cultural background
-- Ask for clarification if possible
-
-### Ambiguity Resolution Checklist
-
-When encountering ambiguous source text:
-
-1. **Analyze context**: Read surrounding paragraphs
-2. **Research domain**: Check if it's domain-specific terminology
-3. **Consult references**: Use dictionaries, corpora, native speaker resources
-4. **Apply logic**: What makes sense in this situation?
-5. **Check consistency**: How are similar terms used elsewhere in the document?
-6. **Note uncertainty**: Flag for reviewer if truly unresolvable
-7. **Choose most likely**: Make informed decision based on available evidence
-8. **Document reasoning**: Keep notes on why you chose this interpretation
-
-### Example Workflow
-
-**Source**: "The professor didn't recommend the book because it was too advanced"
-
-**Ambiguity**: Did the professor:
-
-- NOT recommend it because it's too advanced (too difficult)?
-- Recommend it for reasons other than being advanced?
-
-**Resolution process**:
-
-1. Check context: Is this about a beginner or advanced course?
-2. Consider logical meaning: First interpretation is more common
-3. Make decision: Choose first interpretation (didn't recommend due to difficulty)
-4. Note for reviewer: Add comment about potential ambiguity
-5. Translate with chosen interpretation
-
-**Japanese translation** (first interpretation):
-教授はその本を推薦しなかった。内容が高度すぎるためだ。
-
-- Explicitly clarifies the causal relationship
-
-**Chinese translation** (first interpretation):
-教授沒有推薦那本書,因為內容太深奧了。
-
-- Uses 因為 (because) to make causal relationship explicit