sadcoderlabs · yurenju · Aug 18, 2026 · Aug 18, 2026 · Aug 18, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,9 +1,12 @@
+> 這是唯一正本，`CLAUDE.md` 是指向本檔的 symlink。要改指引改這裡，不要動 `CLAUDE.md`。
+
 # 語言規則
 
 - 對話、討論、解釋：繁體中文
 - README.md / DEVELOPER.md / CLAUDE.md / AGENTS.md：以中文為主，技術術語（HTTP、RPC、TDD、worker、binding 等）保留英文
 - docs/superpowers/ 下的所有文件（spec、plan、研究筆記等）：一律繁體中文撰寫散文段落、章節標題、表格內容。技術術語保留英文
 - 程式碼、程式碼註解、commit message、issue/PR 標題、log 訊息字串：英文
+- PR 敘述（body）：繁體中文。技術術語、錯誤訊息、路徑、程式碼區塊保留英文原文。PR 標題維持英文（見上一條）
 
 # Repo 導覽
 
@@ -27,6 +30,8 @@
 
 ## PR 敘述怎麼寫
 
+用繁體中文寫。技術術語、錯誤訊息與路徑保留英文原文，標題還是英文。
+
 按這個順序寫，順序本身就是重點：
 
 1. **使用者遇到的問題。** 第一段就講使用者實際看到什麼，用他們的語言，不要用內部術語。不是「快取的 key 沒有失效」，是「改了設定之後，舊的值還會再出現一個小時」。看 PR 的人第一個要知道的是「這在修什麼」，不是「這改了哪一行」。

diff --git a/CLAUDE.md b/CLAUDE.md
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md