/f5-translate

description: Translate Japanese documents to Vietnamese using AI assistance (Claude Code)
argument-hint: <path> [--dry-run] [--format=xlsx|pdf|md] [--batch] [review|approve]

/f5-translate - Document Translation Command V1.2

Dịch tài liệu tiếng Nhật sang tiếng Việt với sự hỗ trợ của AI, phục vụ BRSE/Comtor.

> **Version:** 1.2 > **Nguyên tắc:** AI hỗ trợ - BRSE/Comtor quyết định > **Vai trò:** BRSE, Comtor, BA > **New in V1.2:** AI Flag (Không Quyết) + Uncertainty Tracking

---

🎯 VAI TRÒ CỦA F5-TRANSLATE

┌─────────────────────────────────────────────────────────────────────────────────┐
│  f5-translate KHÔNG PHẢI là dịch máy hoàn toàn                                  │
│  f5-translate KHÔNG thay thế BRSE/Comtor                                        │
├─────────────────────────────────────────────────────────────────────────────────┤
│  VAI TRÒ ĐÚNG:                                                                  │
│  ✅ Hỗ trợ dịch nhanh các đoạn text                                            │
│  ✅ Gợi ý thuật ngữ chuyên ngành                                               │
│  ✅ Giữ nguyên cấu trúc tài liệu                                               │
│  ✅ Highlight phần cần BRSE review kỹ                                          │
│  ✅ Tạo glossary thuật ngữ                                                     │
│  ✅ Track translation coverage                                                  │
│  ✅ 🆕 Flag uncertainty - không tự tin giả                                     │
├─────────────────────────────────────────────────────────────────────────────────┤
│  QUYẾT ĐỊNH CUỐI CÙNG: BRSE / Comtor                                           │
└─────────────────────────────────────────────────────────────────────────────────┘

---

⚠️ TRANSLATION RULES (MANDATORY - V1.2)

Nguyên tắc cốt lõi: AI FLAG, KHÔNG QUYẾT

┌─────────────────────────────────────────────────────────────────────────────────┐
│  AI KHÔNG ĐƯỢC "TỰ TIN GIẢ" VỚI THUẬT NGỮ KỸ THUẬT                              │
│  Nếu không chắc → PHẢI FLAG, không được lặng lẽ chọn 1 cách dịch               │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                  │
│  3 LOẠI TEXT TRONG TÀI LIỆU JP:                                                 │
│                                                                                  │
│  1️⃣ TECHNICAL IDENTIFIERS → ❌ KHÔNG DỊCH                                      │
│     • API paths: /api/v1/traffic-control                                        │
│     • Field names: traffic_type, start_date                                     │
│     • Codes/Enums: ACTIVE, INACTIVE, ERR_001                                    │
│     • DB columns: T_USER.USER_ID                                                │
│     → Action: Keep as-is, ghi rõ lý do                                          │
│                                                                                  │
│  2️⃣ DOMAIN TERMS (EN common) → ⚠️ FLAG CHO BRSE                                │
│     • mode, status, flag, master, batch                                         │
│     • システム管理モード, 処理区分, 運用種別                                         │
│     → Action: Gợi ý options, BRSE quyết định                                    │
│                                                                                  │
│  3️⃣ BUSINESS CONTENT → ✅ DỊCH + FLAG NẾU AMBIGUOUS                            │
│     • Rules, flows, explanations                                                │
│     • 処理 có thể là "xử lý" hoặc "màn hình xử lý"                              │
│     → Action: Dịch theo context, flag nếu nhiều nghĩa                           │
│                                                                                  │
└─────────────────────────────────────────────────────────────────────────────────┘

AI MUST (Bắt buộc)

translation_rules:
  must:
    - Keep technical identifiers UNCHANGED
    - Use glossary if term exists and verified
    - Flag ANY term with multiple plausible meanings
    - NEVER silently choose between domain translations
    - Provide context where term was found
    - List all possible translations for uncertain terms
    
  must_not:
    - Auto-translate technical codes
    - Assume single meaning for ambiguous terms
    - Hide uncertainty behind confident translation
    - Skip flagging just because "it seems obvious"

Uncertainty Output Format

⚠️ UNCERTAIN TERM DETECTED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Japanese: システム管理モード

Contexts found:
  1. 「システム管理モードに切り替える」 (Sheet: 画面項目, Cell: B15)
  2. 「システム管理モード中は編集不可」 (Sheet: 処理フロー, Cell: C8)

Possible translations:
  1. Chế độ điều khiển giao thông
  2. Chế độ quản lý giao thông  
  3. Chế độ kiểm soát giao thông
  4. [Keep as-is: システム管理モード]

Recommendation:
  → Verify with customer or domain expert
  → Check existing glossary in similar projects

Status: PENDING_BRSE_REVIEW

Keep-As-Is Output Format

✅ TECHNICAL IDENTIFIER (Kept as-is)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Original: traffic_type
Translation: traffic_type
Reason: Database column name - technical identifier
Location: Sheet: テーブル定義, Column: フィールド名

---

📊 WORKFLOW VỊ TRÍ TRONG PIPELINE

┌─────────────────────────────────────────────────────────────────────────────────┐
│                         DOCUMENT PIPELINE                                        │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                  │
│  PHASE 0.5: TRANSLATE (NEW)              PHASE 1: CLASSIFY                      │
│  ─────────────────────────               ────────────────────                    │
│