fix: improve translation consistency and clarity in import documentation, also update skill

Author: ken

.claude/skills/terminology-check.md

@@ -80,6 +80,28 @@ These Simplified Chinese terms MUST be converted:
 | 轉義 | 跳脫 | escape |
 | 基類 | 基底類別 | base class |
 
+## Context Decision Log (Rule)
+When a reviewer decides a translation depends on nearby context (above/below),
+record the decision here for future reference. Keep entries short and specific.
+
+Format:
+- **Term/pattern:** ...
+- **Decision:** ...
+- **Context cue:** ...
+- **Example:** `source` -> `translation`
+
+Example:
+- **Term/pattern:** 類型 / 型別
+- **Decision:** 用語依上下文；Python 型別物件用「型別」，一般分類用「類型」
+- **Context cue:** 出現 `int/str/dict/type` 或 "type object"
+- **Example:** "two types of packages" -> "兩種類型的套件"
+
+Decision Log:
+- **Term/pattern:** 類型 / 型別
+- **Decision:** 用語依上下文；Python 型別物件用「型別」，一般分類用「類型」
+- **Context cue:** 出現 `int/str/dict/type` 或 "type object"
+- **Example:** "two types of packages" -> "兩種類型的套件"
+
 ## High-Frequency Terms (Keep in English)
 
 These terms should NOT be translated, even if glossary has translations:
@@ -143,9 +165,10 @@ Core Python terms with required zh_TW translations:
 
 1. **Extract terms** - Parse msgstr for Chinese phrases and English words
 2. **Check forbidden** - Flag any zh_CN variants from the forbidden list
-3. **Check consistency** - Compare with other translations of same term
-4. **Check glossary** - Verify against official glossary.po
-5. **Report issues** - List violations with suggestions
+3. **Consult context log** - Check the Context Decision Log for any applicable rules
+4. **Check consistency** - Compare with other translations of same term
+5. **Check glossary** - Verify against official glossary.po
+6. **Report issues** - List violations with suggestions
 
 ## Output Format
 
@@ -157,6 +180,9 @@ FORBIDDEN TERMS (must fix):
   Line 78: "返回" -> "回傳" (return)
   Line 156: "對象" -> "物件" (object)
 
+REVIEW (context-dependent):
+  Line 88: "類型" (see Context Decision Log)
+
 INCONSISTENT TERMS (review):
   "iterator" translated as:
     - "疊代器" (45 occurrences) <- standard

.claude/skills/validate-translation.md

@@ -57,6 +57,11 @@ metadata:
 | Inconsistent term | WARNING | Same term translated differently |
 | High-freq term translated | INFO | Terms like `int`, `list` should stay English |
 
+### 7. Context-Dependent Decisions
+| Check | Severity | Description |
+|-------|----------|-------------|
+| Reviewer context rule | INFO | If a reviewer decides a term/pattern depends on nearby context, record it in the Context Decision Log in `terminology-check` for future reference. |
+
 ## Validation Process
 
 1. **Read the PO entry** - Parse msgid, msgstr, comments, and flags
@@ -65,7 +70,8 @@ metadata:
 4. **Check spacing** - Verify CJK-Latin spacing
 5. **Check line length** - Ensure <= 79 characters
 6. **Check reST** - Validate roles, links, escaping
-7. **Check terminology** - Cross-reference with glossary
+7. **Check terminology** - Cross-reference with glossary and Context Decision Log
+8. **Record context rules** - If a decision depends on nearby context, add it to the Context Decision Log
 
 ## Output Format
 

reference/import.po

@@ -252,7 +252,7 @@ msgstr ""
 "命名空間套件是由不同的\\ :term:`部分 <portion>` 組成的，每個部分都為父套件提"
 "供一個子套件。這些部分可以位於檔案系統上的不同位置。部分可能也存在於壓縮檔案"
 "中、網路上，或 Python 在引入時搜尋的任何其他地方。命名空間套件不一定直接對應"
-"於檔案系統中的對象；它們可能是沒有具體表示的虛擬模組。"
+"於檔案系統中的物件；它們可能是沒有具體表示的虛擬模組。"
 
 #: ../../reference/import.rst:143
 msgid ""
@@ -406,14 +406,14 @@ msgstr ""
 "Python 包含多個預設的尋檢器和引入器。第一個尋檢器知道如何定位內建模組，第二個"
 "尋檢器知道如何定位凍結模組。第三個預設尋檢器會在 :term:`import path` 中搜尋模"
 "組。:term:`import path` 是一個位置的列表，這些位置可能是檔案系統路徑或壓縮檔"
-"案，也可以擴展以搜尋任何可定位的資源，例如由 URL 識別的資源。"
+"案，也可以擴充以搜尋任何可定位的資源，例如由 URL 識別的資源。"
 
 #: ../../reference/import.rst:232
 msgid ""
 "The import machinery is extensible, so new finders can be added to extend "
 "the range and scope of module searching."
 msgstr ""
-"引入機制是可擴展的，因此可以增加新的尋檢器來擴展模組搜尋的範圍和作用域。"
+"引入機制是可擴充的，因此可以增加新的尋檢器來擴充模組搜尋的範圍和作用域。"
 
 #: ../../reference/import.rst:235
 msgid ""
@@ -433,7 +433,7 @@ msgid ""
 "import machinery."
 msgstr ""
 "以下各節將更詳細地描述尋檢器和載入器的協定，包括如何建立和註冊新的尋檢器和載"
-"入器來擴展引入機制。"
+"入器來擴充引入機制。"
 
 #: ../../reference/import.rst:243
 msgid ""
@@ -455,7 +455,7 @@ msgid ""
 "this are the *import hooks*.  There are two types of import hooks: *meta "
 "hooks* and *import path hooks*."
 msgstr ""
-"引入機制的設計是可擴展的；其主要機制是\\ *引入掛鉤*。引入掛鉤有兩種類型：*元"
+"引入機制的設計是可擴充的；其主要機制是\\ *引入掛鉤*。引入掛鉤有兩種類型：*元"
 "掛鉤 (meta hooks)* 和\\ *引入路徑掛鉤*。"
 
 #: ../../reference/import.rst:263
@@ -468,7 +468,7 @@ msgid ""
 msgstr ""
 "元掛鉤會在引入處理的開始階段被呼叫，除了查找 :data:`sys.modules` 快取外，其他"
 "引入處理還未發生時就會呼叫。這允許元掛鉤覆蓋 :data:`sys.path` 的處理、凍結模"
-"組，甚至是內建模組。元掛鉤透過將新的尋檢器物件添加到 :data:`sys.meta_path` 中"
+"組，甚至是內建模組。元掛鉤透過將新的尋檢器物件新增到 :data:`sys.meta_path` 中"
 "來註冊，具體描述請參閱以下段落。"
 
 #: ../../reference/import.rst:269
@@ -480,7 +480,7 @@ msgid ""
 msgstr ""
 "引入路徑掛鉤被視為 :data:`sys.path`\\ （或 ``package.__path__``）處理過程的一"
 "部分來呼叫，當遇到與其相關聯的路徑項目時就會被觸發。引入路徑掛鉤透過將新的可"
-"呼叫對象增加到 :data:`sys.path_hooks` 中來註冊，具體描述請參閱以下段落。"
+"呼叫物件增加到 :data:`sys.path_hooks` 中來註冊，具體描述請參閱以下段落。"
 
 #: ../../reference/import.rst:276
 msgid "The meta path"
@@ -719,7 +719,7 @@ msgid ""
 "code example above), as summarized in a :ref:`later section <import-mod-"
 "attrs>`."
 msgstr ""
-"模組建立後、在執行之前，引入機制會設置與引入相關的模組屬性（在上面的偽程式碼"
+"模組建立後、在執行之前，引入機制會設定與引入相關的模組屬性（在上面的偽程式碼"
 "範例中為 \"_init_module_attrs\"），具體內容在\\ :ref:`之後的段落<import-mod-"
 "attrs>`\\ 會總結。"
 
@@ -1241,7 +1241,7 @@ msgid ""
 "protocol described below, which was then used to get a loader for the module "
 "from the web."
 msgstr ""
-"基於路徑的尋檢器提供了額外的掛鉤和協定，讓你可以擴展和自訂可搜尋的路徑條目類"
+"基於路徑的尋檢器提供了額外的掛鉤和協定，讓你可以擴充和自訂可搜尋的路徑條目類"
 "型。例如，如果你希望支援將路徑條目作為網路 URLs，你可以撰寫一個實作 HTTP 語意"
 "的掛鉤，用於在網路上尋找模組。這個掛鉤（一個可呼叫物件）會回傳一個支援下述協"
 "定的 :term:`path entry finder` ，該尋檢器隨後用於從網路中取得模組的載入器。"