visa-doc-translate

visa-doc-translate 技能概覽

visa-doc-translate 是一個工作流程型技能，用來把簽證申請文件影像轉成含原始頁面與英文翻譯的雙語 PDF。它最適合需要快速、結構化翻譯補充文件的使用者，例如銀行存款證明、在職證明、退休證明、收入證明、不動產資料、營業執照或身分證件。

visa-doc-translate 是用來做什麼的

visa-doc-translate skill 的設計目標很明確：把影像檔拿進來，可靠地擷取文字，專業地翻譯，並盡量保留文件結構，方便簽證審查使用。它不是通用翻譯提示，而是針對文件處理情境設計；這類情境特別在意版面、日期、姓名與金額。

誰適合安裝它

如果你經常處理掃描或拍攝的簽證文件，而且想要可重複、穩定的流程，而不是每次都臨時發揮，就適合安裝 visa-doc-translate。當你需要雙語輸出、需要 OCR 備援方案，或希望技能自動處理旋轉與 HEIC 轉檔時，它特別實用。

visa-doc-translate 有什麼不同

和單純的「翻譯這張圖片」提示相比，visa-doc-translate 內建了文件專用的處理：影像轉換、EXIF 旋轉、OCR 方法備援，以及 PDF 輸出格式。這讓它在簽證文件上更可靠，因為少一個數字、看錯一個姓名，都可能讓結果失效。

如何使用 visa-doc-translate 技能

安裝 visa-doc-translate

使用 repo 內容中提到的安裝指令：

npx skills add affaan-m/everything-claude-code --skill visa-doc-translate

安裝後，先確認這個技能已在你的環境中可用，並且可以用文件影像路徑來呼叫它。如果你的工作流程不是 Claude Code，請把這套技能邏輯移植到你的 agent 或 script runner，不要直接假設同一個指令語法在所有環境都能通用。

提供正確的輸入給技能

visa-doc-translate usage 的模式很簡單：傳入本機影像檔，而不是空泛的任務描述。好的輸入會像這樣：

• /visa-doc-translate ./documents/BankStatement.HEIC
• /visa-doc-translate ./scan/employment-certificate.jpg

如果你希望輸出更好，請在提示中加入文件類型與特殊要求，例如「公司名稱保留原文」或「金額與日期請完全照原文保留」。這有助於技能更安全地選詞與排版。

先讀這些檔案

要最快上手，先看 SKILL.md，再看 README.md。這兩個檔案會說明預期流程、支援的文件類型、輸出格式，以及必要的函式庫。因為這個 repo 沒有額外的 helper 資料夾，所以這兩個檔案幾乎承載了 visa-doc-translate guide 的主要實作意圖。

會影響結果的工作流程建議

如果可以，盡量使用乾淨、正向的掃描件；但當你無法這麼做時，就依賴技能內建的旋轉與 OCR 備援。HEIC 檔若本來就是來源格式，通常可以直接保留原樣，技能會處理轉換。若想要更好的翻譯品質，請避免裁切掉邊緣、低對比度、以及「螢幕截圖的截圖」，因為這些都會在翻譯前先降低 OCR 準確度。

visa-doc-translate 技能 FAQ

visa-doc-translate 只適用於簽證文件嗎？

是，這個技能的重點放在簽證相關的補充文件。你可以把它延伸到相近的正式文件，但 visa-doc-translate skill 最有說服力的使用情境，仍然是那種需要忠實保留版面、同時提供英文翻譯給申請審查的文件。

我需要先安裝 OCR 工具嗎？

通常需要，因為這個技能會依賴你環境中可用的 OCR 路徑。repo 中提到 macOS Vision、EasyOCR 與 Tesseract 作為備援選項。如果你要安裝 visa-doc-translate，請先檢查自己的環境，再把它用在正式流程中；尤其是在非 macOS 系統上處理文件時更要確認。

這比一般翻譯提示更好嗎？

針對文件影像來說，是的。通用提示可能會翻譯文字，卻常常忽略旋轉、文字擷取與 PDF 組裝。visa-doc-translate 加入了正式文件真正需要的流程控制：轉換、OCR 備援、結構保留與雙語輸出。

什麼時候不該用它？

如果你只需要大略摘要、來源本來就是乾淨的文字 PDF，或你要的是法律意見而不是翻譯，就不應該用它。若影像嚴重受損或幾乎無法辨識，這個技能仍可能產生草稿，但你應該預期需要人工修正。

如何改善 visa-doc-translate 技能

提供更乾淨的原始素材

品質提升最大的來源，通常是更好的輸入影像。在執行 visa-doc-translate 之前，先裁掉無關邊框、確認文字可讀，並盡量使用整頁影像，不要只用局部截圖。如果文件明顯是橫的或倒的，也請直接說明，尤其是在檔名或拍攝情境已經能看出來時。

明確告訴它哪些內容一定要保留

這個技能在你明確指定簽證審查會在意的限制時，效果最好：姓名要完全一致、護照號碼要保留、日期與幣別格式要照原文、官方標示不要改寫。如果中文姓名應該轉成拼音，請直接在提示中講清楚，不要假設它會自動推斷到完全正確。

對照原始文件檢查輸出

第一次產出後，請拿 PDF 翻譯內容和原始影像逐項比對數字、日期、章戳文字與機構名稱。如果有錯，請直接指向特定行或欄位來修正，不要只說要「整體再翻準一點」。這通常比泛泛要求「更精準」更能得到好的 visa-doc-translate 結果。

用文件類型脈絡來強化提示

當你先明確指出文件類別時，visa-doc-translate for Translation 這個流程會更強，例如銀行證明、在職證明或不動產證明。這能幫助技能選出更自然、符合簽證語境的術語，避免用過於通用的翻譯選項把正式措辭弄得太平。