潤飾模式

潤飾模式會精修現有文字——修正文法、提高清晰度、讓文字更自然——而不將它翻譯成另一種語言。當你用還在學習的語言寫作時特別好用。

基本用法

echo "I want talk about the deploy issue" | yaku --mode polish --to en

輸出：

I'd like to discuss the deployment issue

--to 選項指定文字要以哪種語言進行潤飾。

潤飾模式會做什麼

• 修正文法、拼寫和標點
• 讓表達方式對母語者來說更自然
• 保留原始含義和段落結構
• 如果文字已經寫得很好，只做最小幅度的修改

潤飾模式不會做什麼

• 翻譯成另一種語言（請使用預設的 translate 模式）
• 加入原文沒有的資訊
• 改變結構或合併／拆分段落

範例

修正英文文法

echo "I want talk about the deploy issue and we need fix it quick" | \
  yaku --mode polish --to en

輸出：

I'd like to discuss the deployment issue, and we need to fix it quickly.

修正日文文法

echo "昨日のミーティングで話したことについてフォローアップしたいんだけど" | \
  yaku --mode polish --to ja --context "formal business email"

輸出：

昨日の会議でお話しした件について、フォローアップさせていただきたく存じます。

潤飾檔案

yaku --mode polish --to en -f draft.md -o polished.md

對 Markdown 檔案，yaku 會保留結構（標題、程式碼區塊、連結）並只潤飾文字部分。

用上下文控制語氣

echo "The server went down again yesterday" | \
  yaku --mode polish --to en --context "formal incident report"

輸出：

The production server experienced an unplanned outage yesterday.

echo "Someone needs to look at the login bug" | \
  yaku --mode polish --to en --context "casual Slack message"

輸出：

Hey, can someone take a look at the login bug?

潤飾日文文字

潤飾模式適用於任何語言——當你用還在學習的語言寫作時特別好用：

echo "昨日のミーティングで話したことについてフォローアップしたいんだけど" | \
  yaku --mode polish --to ja --context "formal business email"

輸出：

昨日の会議でお話しした件について、フォローアップさせていただきたく存じます。

翻譯 vs 潤飾：何時使用哪個

	--mode translate	--mode polish
用途	將文字從一種語言轉換成另一種	改善已經是目標語言的文字
輸入語言	與 --to 不同	與 --to 相同
--from 選項	支援（或自動偵測）	忽略（顯示警告）
--glossary	支援	忽略（顯示警告）
--context	引導領域用語	引導語氣和正式程度

常見錯誤：對錯誤的語言使用潤飾

如果輸入文字的語言和 --to 不同，請一律使用 translate 模式：

# 正確：將日文翻譯成中文
echo "会議は明日の10時です" | yaku --to zh-TW

# 錯誤：用「中文」潤飾日文文字沒有意義
echo "会議は明日の10時です" | yaku --mode polish --to zh-TW

潤飾模式告訴 LLM「改善這段文字，使其以中文聽起來自然」——但輸入是日文。LLM 收到矛盾的指示，結果會不可靠。當輸入和目標語言不同時，請使用 translate 模式。

使用情境

• 用第二語言寫作 — 潤飾你的英文、日文、韓文，或任何你還在學習的語言。
• 內容編修 — 精修任何語言的部落格文章、README 或使用者介面文字。
• 語氣調整 — 使用 --context 改變正式程度（詳見上下文提示）。
• CI/CD 品質檢查 — 在 pull request 中檢查文字品質。