universal-dev-standards 6.6.0 → 6.7.1

package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md

@@ -1,10 +1,14 @@
 ---
 source: ../../../../skills/slo-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引导 SLI 选取、SLO 设置和 Error Budget 管理"
+description: |
+  引导 SLI 选取、SLO 设置与 Error Budget 管理。
+  Use when: 定义服务质量目标、建立以 SLO 为基础的告警、Error Budget 策略。
+  Not for: 埋点与指标收集——请用 /observability；处理正在违反目标的状况——请用 /incident。
+  Keywords: SLI, SLO, SLA, Error Budget, burn rate, service level, 服务等级, 错误预算, 燃烧率, 服务质量目标.
 ---
 
 # SLO 助手

package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md

@@ -2,13 +2,16 @@
 name: spec-derive
 source: ../../../../skills/spec-derivation/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-16
-source_hash: 094ceb9af93a
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: 3f875cea1cad
 status: current
 scope: partial
 description: |
-  [UDS] 从规格衍生 BDD 场景、TDD 骨架或 ATDD 表格
+  [UDS] 从已批准的规格推导出 BDD 场景、TDD 骨架、集成与 E2E 测试，以及 ATDD 表格。
+  Use when: 规格已批准且需要产出测试产物、从验收条件生成带标签的测试骨架、从规格生成契约桩。
+  Not for: 从既有代码回推规格——请用 /reverse；撰写或审查规格本身——请用 /sdd。
+  Keywords: forward derivation, spec to test, BDD scenario, TDD skeleton, ATDD table, 正向推演, 规格衍生, 测试生成, 契约桩.
 allowed-tools: Read, Write, Grep, Glob
 argument-hint: "[all|bdd|tdd|it|e2e|atdd] <spec-file>"
 prerequisites: ["spec-approved"]

package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/spec-driven-dev/SKILL.md
 source_version: 1.2.0
-translation_version: 1.2.0
-last_synced: 2026-07-16
-source_hash: 488aea3f5120
+translation_version: 1.3.0
+last_synced: 2026-08-17
+source_hash: 989b50cd2147
 status: current
 description: |
-  在编写代码前，建立、审查和管理规格文件。
-  使用时机：建立规格、审查设计、规格驱动开发流程。
-  关键字：spec, specification, SDD, design, review, 规格, 设计, 审查, 验证。
+  [UDS] 在写代码之前建立并审查规格文档——规格格式、状态与差异操作。
+  Use when: 某项变更需要先有书面规格、审查规格的完整性、用 delta 区段修订既有规格。
+  Not for: 执行带关卡的 SDD 生命周期——该部分已移至采用层（XSPEC-095）；快速迭代用的轻量微规格——请用 uds spec 命令。
+  Keywords: SDD, spec, specification, design document, delta operation, spec review, 规格驱动开发, 规格文档, 变更操作, 规格审查.
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
   SDD 生命周期编排（7 阶段状态机、阶段转换、闸门检查）已迁移至

package/bundled/locales/zh-CN/skills/sweep/SKILL.md

@@ -2,15 +2,16 @@
 name: sweep
 source: ../../../../skills/sweep/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-16
-source_hash: 340ed7c83bbd
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: 85af5ee0d1f4
 status: current
 scope: universal
 description: |
-  [UDS] 扫描代码库的调试残留与代码质量问题；可自动修正安全模式。
-  Use when: before committing, during PR review, or periodic codebase cleanup.
-  Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理.
+  扫描代码库中的调试残留与代码质量问题；可选择自动修正安全的模式。
+  Use when: 提交前、PR 审查期间，或定期清理代码库。
+  Not for: 结构性的代码改善——请用 /refactor；针对安全的专门扫描——请用 /scan。
+  Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理, 调试残留.
 allowed-tools: Read, Grep, Glob, Bash(find:*), Edit, Write
 argument-hint: "[--fix] [--report] [--path <dir>] [--exclude <pattern>]"
 ---

package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/tdd-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
-  引导测试驱动开发（TDD）流程：红-绿-重构。
-  使用时机：TDD 开发、撰写测试先行的代码、学习 TDD。
-  关键字：TDD, test-driven, red-green-refactor, 测试驱动, 红绿重构。
+  [UDS] 测试驱动开发（TDD）的参考资料：红-绿-重构循环、FIRST 原则与 Arrange-Act-Assert 结构。
+  Use when: 在实现前先写一个会失败的测试、用 Arrange-Act-Assert 组织测试、以 FIRST 检视既有测试。
+  Not for: 交互式地驱动 RED/GREEN 循环——该部分已移至采用层（XSPEC-095）；测量测试覆盖了多少代码——请用 /coverage。
+  Keywords: TDD, test first, Red Green Refactor, FIRST, Arrange Act Assert, unit test, 测试驱动开发, 红绿重构, 单元测试.
 ---
 
 # TDD 助手

package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/test-coverage-assistant/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-02-10
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  多维度分析测试覆盖率并提供可执行的建议。
-  使用时机：分析覆盖率、识别测试缺口、制定测试策略。
-  关键字：coverage, test, analysis, dimension, 覆盖率, 测试, 分析, 维度。
+  [UDS] 以八维度框架分析代码层级的测试覆盖率，并建议该优先补上哪些缺口。
+  Use when: 覆盖率数字看起来很健康但缺陷照样流出、要在行覆盖率之外判断测试完整性、设定覆盖率目标。
+  Not for: 需求层级的 AC 与测试追踪——请用 /ac-coverage；补写缺少的测试——请用 /tdd 或 /spec-derive。
+  Keywords: test coverage, eight dimensions, line coverage, branch coverage, test quality, 测试覆盖率, 八维度, 测试完整性, 覆盖缺口.
 ---
 
 # 测试覆盖率助手

package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md

@@ -1,16 +1,17 @@
 ---
 source: ../../../../skills/testing-guide/SKILL.md
 source_version: 1.2.0
-translation_version: 1.2.0
-last_synced: 2026-07-16
-source_hash: 2a5e2a667b04
+translation_version: 1.3.0
+last_synced: 2026-08-17
+source_hash: 372f9eca773d
 status: current
 name: testing
 description: |
-  面向 UT/IT/ST/E2E 的测试金字塔与测试编写标准。
+  测试金字塔，以及 UT/IT/ST/E2E 的测试编写标准。
   支持 ISTQB 与业界通行金字塔两种框架。
-  使用时机：编写测试、讨论测试覆盖率、测试策略或测试命名时。
-  关键词：test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 测试, 单元, 集成, 端对端。
+  Use when: 编写测试、讨论测试覆盖率、测试策略或测试命名时。
+  Not for: 驱动红-绿-重构循环——请用 /tdd；测量实际达成的覆盖率——请用 /coverage。
+  Keywords: test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 测试, 单元测试, 集成测试, 端对端.
 ---
 
 # 测试指南

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -1,7 +1,7 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.6.0
-translation_version: 6.6.0
+source_version: 6.7.1
+translation_version: 6.7.1
 last_synced: 2026-08-17
 status: current
 ---
@@ -17,10 +17,36 @@ status: current
 
 ## [Unreleased]
 
+## [6.7.1] - 2026-08-18
+
+### 修正
+
+- **各語系的速查表內嵌的是英文 skill 描述——每一個語系、每一次都是。** `scripts/generate-usage-docs.mjs` 在語系迴圈**之外**掃描 skill 一次，且固定讀 `skills/`（英文來源），於是三份速查表與功能參考共用同一組描述。修正前實測：**`locales/zh-TW/docs/CHEATSHEET.md` 的 82 則描述與英文版逐位元組相同**——而且是 6.7.0 之前那個被剝過的 `[UDS] <標籤>` 形式，所以繁體中文讀者看到的是**用錯語言的過期描述**，而他實際安裝的 `SKILL.md` 帶著完整的中文觸發面。`scanSkills()` 現在接受語系並在**迴圈內**呼叫，優先取語系版、缺漏時逐個 skill 回退英文。**修在產生器而不是那 82 列**：手改的速查表下一次編輯必然再度與 `SKILL.md` 分岔。
+- **`code-review-assistant` 與 `checkin-assistant` 的 `disable-model-invocation: true` 已移除。** 那個旗標**不遵循任何可陳述的規則**：六個帶 `status: reference` 的 skill 中，**有四個（`tdd`、`bdd`、`atdd`、`pr-automation`）從未被禁用**，而它們經歷的是同一次 XSPEC-095 生命週期遷移——同一個類別、相反的處置——另外八個被禁用的**連 `status` 都沒有**。系統自己早已記下後果：`pr-automation-assistant` 把*「審查的實質內容——請用 `/code-review`」*導向那裡，**而那條轉介在任何模型自主的路徑上都到不了**。六個 reference 現在處置一致，規則因此說得出口：**reference 一律可被模型叫用**。兩個檔案內都就地記錄了理由。**其餘八個刻意不動**——它們沒有 `status`，拿掉等於用另一個沒有規則的動作覆蓋一個沒有規則的狀態；它們已在 XSPEC-378 R5 具名，不再是「不知道為什麼關著」。
+
+## [6.7.0] - 2026-08-17
+
+### 修正
+
+- **skill 觸發面在三層全數復原——55 個 skill × 英文、zh-TW、zh-CN。** 一個 skill 的 `description` 是模型決定要不要叫用它時**唯一看得到的東西**。commit `d415937e`（2026-02-10）把其中 17 個改寫成 `[UDS] <標籤>`，刪掉 `Use when:` 與 `Keywords:` 兩行、**連中文關鍵字一起**；相鄰 commit 的標題寫著 `token optimization`。當時**只有 token 可數**——沒有任何東西在量觸發面，於是那個取捨看起來是單邊的，而它不是。2026-08-14 量測：55 個含 `SKILL.md` 的 skill 中，**27 個有觸發條件、27 個有關鍵字、0 個有排除條件、28 個兩者皆無**——而那 28 個正是方法論核心：tdd、bdd、atdd、spec-driven-dev、code-review、commit-standards、checkin、requirement。
+  - **英文來源**：28 個復原，且**全部 55 個補上排除條件**（`Not for:`）。只加觸發不加排除，換來的是過度觸發；而一個不該響卻響的 skill 會被整個關掉，**連帶拖走還能用的那些**。15 個可從 git 歷史救回者中**有 8 個被重寫**，因為歷史文字已不描述現行行為——其中六個宣稱自己會引導某套生命週期，而那已於 XSPEC-095 移交採用層。**救回一個過期的描述，比不救更糟。**
+  - **語系層**：zh-TW 與 zh-CN **各 55/55，是翻譯不是轉碼**。**這一半才是重點**——以 `--locale zh-tw` 安裝的專案，在英文來源已修好時仍拿到被剝過的描述，這個修正本來到不了它要給的那個讀者。繁體與簡體各自用道地用詞，另修正三份 zh-CN 描述中混入的繁體字。
+  - **翻譯 drift 62 → 38**，剩下的 38 是刻意的停點：24 份漂移完全來自本次 description 編輯者更新了 hash，12 份本文早已漂移者保留過期 hash——更新它們等於宣稱整份檔案已同步，而那件事沒有人驗證過。
+  - ⚠️ **28 個中有 10 個帶著 `disable-model-invocation: true`**，由同一個 `d415937e` 加入。對那 10 個而言，補描述**並不會**讓它們變成可被選中——擋住的是那個旗標，而要不要拿掉它是**設計決定不是缺陷**。模型真正選得到的數量是 **45，不是 55**。
+
+### 新增
+
+- **`ai-response-navigation` 1.2.0 → 1.3.0 —— 選用規則 R10 與 R11。** 它們的來源與 R7–R9 不同：使用者在同一次工作階段中**兩度**指出，一個正確且完整的回答讀不懂，而當時 R7–R9 已經出貨且正在被遵守。**先講發現並不足夠。**
+  - **R10 —— 白話是主詞，識別字是佐證。** *觸發*：任何向人解釋一個情況、一個缺陷、或一個系統行為的回應。用讀者會用的話說清楚發生了什麼；路徑、符號、行號、指令輸出、版本字串屬於它們所支持的那句話**之後**，而不是那句話本身。它**不是**可以省略它們的許可——想驗證的讀者必須驗得了。**與 R7 分開是刻意的**：R7 管的是「先發現後證據」的順序，而一個回應可以先講發現、卻仍用只有作者持有的詞彙講它。兩者都讓讀者無法行動，但它們是不同的失效。
+  - **R11 —— 每個選項都要帶自己的優劣。** *觸發*：要求讀者在兩個以上做法之間選擇的回應。規則 2 已要求標示推薦項並給出**它的**理由；R11 要求**每一個**選項都說明它換到什麼、代價是什麼。一份只有推薦項被論證的清單，等於**把比較的工作丟回給讀者**——而那正是他請你做的事；而沒標代價的選項讀起來像是沒有代價。**優劣不是模稜兩可**：「稍微難一點」不是代價，「重寫 110 個檔且翻譯需要人審」才是。空白的代價欄讀起來是「沒有分析過」，而讀者分不出這兩者。
+
 ## [6.6.0] - 2026-08-17
 
 ### 新增
 
+- **`spec-driven-development` 2.3.0 → 2.4.0 —— 沒有驗證項的 AC 不是 AC。** 每一條驗收標準都必須有一個**指向它的驗證項**——測試、檢查、閘門，或一則明確記錄的手動步驟。沒有任何驗證項引用的 AC 是一張沒有人兌現的支票，而且它**不會**大聲失敗：它只是安靜地停止成立，而規格繼續宣稱它為真。**規則**：這樣的 AC 必須**降級為設計意圖**，不得繼續掛在 AC 欄——降級是誠實的，未經驗證的 AC 不是。標準同時寫明什麼**不算**驗證項：「審查者會注意到」不是驗證項，因為審查者讀的是規格，而規格說那條 AC 成立。新增規則 `SDD-AC-VERIFIED`。
+  - **實測案例**：一份 2026-05-14 的規格寫著 `AC-7：舊版系統報告完整保留（無回歸）`。它的 Test Plan 有七項，**沒有一項指向 AC-7**。該報告的 timer 是 disabled、部署函式從未被呼叫——**從那條 AC 被寫下的同一天起**。三個月後在驗證一件無關的安裝時偶然撞到。它不是接上了檢查後來鬆脫，**它從來沒有被接上過**。
+
 - **`ai-response-navigation` 1.1.0 → 1.2.0 —— 選用規則 R7–R9，管答案本身**（XSPEC 借鑒 B-10，來源 [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)，MIT）。規則 1–6 管的是答案**之後**要附什麼：導航區塊、標記過的推薦、匹配回應類型的模板。**答案本身沒有任何規則在管。** 於是一個回應可以把結論埋在一整面證據底下，只要結尾附上正確的導航區塊，它仍然滿足**本標準的每一條**——而找不到答案的讀者，不會因為被告知下一步而得到幫助。
   - **R7 —— 先講發現，不要先講過程。** *觸發*：回答問題、回報調查結果、或提出決策的回應。第一行寫**查到了什麼**或**該做什麼**——不是方法、不是把問題複述一遍、不是回答的計畫。證據（`file:line`、指令輸出、表格、量測數字）是**佐證**，應放在它所支持的主張之後；以證據開場會迫使讀者自行重建結論，而那正是他請你做的工作。本條規範的是**順序**，**不**代表可以省略證據。
   - **R8 —— 每一輪重述進度。** *觸發*：跨 3 輪以上的對話，或含 3 個以上步驟的任務。用一行說明工作進行到哪裡。不能假設讀者能在訊息之間記住「我們在 5 步中的第 3 步」，而重述它的成本是一個句子。與模板 4（進行中）互補：**R8 管開頭，模板管結尾。**

package/bundled/locales/zh-TW/README.md

@@ -15,7 +15,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 6.6.0 | **發布日期**: 2026-08-17 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.7.1 | **發布日期**: 2026-08-18 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/bundled/locales/zh-TW/SECURITY.md

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支援狀態 |
 |------|--------|
-| 6.6.0 | ✅ 最新正式版 |
+| 6.7.1 | ✅ 最新正式版 |
 | < 6.0.0 | ❌ 已終止支援 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 

package/bundled/locales/zh-TW/core/ai-response-navigation.md

@@ -1,7 +1,7 @@
 ---
 source: ../../../core/ai-response-navigation.md
-source_version: 1.2.0
-translation_version: 1.2.0
+source_version: 1.3.0
+translation_version: 1.3.0
 last_synced: 2026-08-17
 status: current
 ---
@@ -10,7 +10,7 @@ status: current
 
 > **語言**: [English](../../../core/ai-response-navigation.md) | 繁體中文 | [简体中文](../../zh-CN/core/ai-response-navigation.md)
 
-**版本**: 1.2.0
+**版本**: 1.3.0
 **最後更新**: 2026-08-17
 **適用範圍**: 所有使用 AI 輔助開發的專案
 **範圍**: universal
@@ -27,8 +27,9 @@ status: current
 
 **解決方案**：在每個實質性 AI 回應結尾附加標準化的「導航區塊」，包含情境模板、推薦標記和彈性選項數量。
 
-**範圍註記（v1.2.0）**：規則 1–6 管的是答案**之後**要附什麼。規則 7–9 於 1.2.0 新增、屬**選用**，
-管的是答案本身：先講發現、每輪重述進度、不要開場白。新增的理由是——
+**範圍註記（v1.2.0，v1.3.0 擴充）**：規則 1–6 管的是答案**之後**要附什麼。
+規則 7–11 **全部屬選用**，管的是答案本身：先講發現（R7）、每輪重述進度（R8）、不要開場白（R9）、
+白話是主詞（R10）、每個選項都要帶自己的優劣而非只有推薦項有（R11）。新增的理由是——
 一個回應可以滿足規則 1–6 的每一條，同時把結論埋起來；
 **而找不到答案的讀者，不會因為結尾有一個正確的導航區塊被告知下一步而得到幫助。**
 
@@ -108,9 +109,11 @@ status: current
 
 ---
 
-## 導航之前的那個答案（規則 7–9，選用）
+## 導航之前的那個答案（規則 7–11，選用）
 
-> **借鑒自**：[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)（MIT），十條中取三條。
+> **規則 7–9 借鑒自**：[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)（MIT），十條中取三條。
+> **規則 10–11 於 1.3.0 新增**，來源不同——使用者在同一次工作階段中兩度指出，
+> 一個正確且完整的回答讀不懂。當時規則 7–9 已經出貨且正在被遵守。
 > 其餘七條刪去：兩條已被上方規則 1–2 涵蓋，五條與本標準衝突
 > （它的「不要 recap／不要結語」與規則 1 的導航區塊直接矛盾；它的「清單上限 5 項」
 > 會切斷證據表格與走訪分母）或與 [estimation-standards](estimation-standards.md) 重複。
@@ -119,7 +122,7 @@ status: current
 一個回應可以把結論埋在一整面證據底下，只要結尾附上正確的導航區塊，
 它仍然滿足本標準的每一條。**找不到答案的讀者，不會因為被告知下一步而得到幫助。**
 
-**這三條是選用的**，語義同規則 6：採用專案不必啟用，既有 skill 也不需回頭補。
+**這五條是選用的**，語義同規則 6：採用專案不必啟用，既有 skill 也不需回頭補。
 專案**可以**在自己的設定中把任一條提升為必須。**不可選的是它們必須有精確的觸發條件**——
 一條鬆到永遠不會啟動的規則，與沒有這條規則無從分辨。
 
@@ -161,6 +164,46 @@ status: current
 **規則 9 不適用於結語。** 規則 1 要求的導航區塊依然成立——
 回應的結尾正是本標準安放「讀者下一步」的位置。
 
+### 規則 10：白話是主詞，識別字是佐證（選用）
+
+**觸發條件**：任何向人解釋一個情況、一個缺陷、或一個系統行為的回應。
+
+用讀者會用的話說清楚發生了什麼。檔案路徑、符號名稱、行號、指令輸出、版本字串是**佐證**——
+它們屬於它們所支持的那句話**之後**，而不是那句話本身。
+
+| 不要寫 | 改寫成 |
+|---|---|
+| 「`intel-scout.py:883` 的 `load_topics()` 讀 `intel-topics.yaml`，`:1033` 的 `load_feeds()` 讀 `intel-feeds.yaml`。」 | 「它有兩種取材方式：搜關鍵字，和訂閱固定幾個部落格。」*（然後再附兩個呼叫點）* |
+| 「`manifest.skillHashes` 有 137 條，key 是 `claude-code/project/<n>/SKILL.md`，而查詢用的是 `.claude/skills/<n>`。」 | 「雜湊值存在一套命名下，查詢用的是另一套，所以一個都找不到。」*（然後再貼兩邊的 key）* |
+
+這**不是**可以省略識別字的許可——想驗證的讀者必須驗得了。它規範的是**兩者之中哪一個當主詞**。
+
+**為什麼它與 R7 是兩條**：R7 規範的是**先講發現再給證據**的順序。R10 規範的是**語域**——
+一個回應可以先講發現，卻仍然用只有作者持有的詞彙講那個發現。兩者都讓讀者無法行動，但它們是不同的失效。
+
+### 規則 11：每個選項都要帶自己的優劣（選用）
+
+**觸發條件**：要求讀者在兩個以上做法之間選擇的回應。
+
+規則 2 要求標示推薦選項並給出**它的**理由。規則 11 把這件事擴及其餘：
+**每一個**選項都要用它自己的話說明它換到什麼、代價是什麼。
+
+一份只有推薦項被論證的選項清單，等於**把比較的工作丟回給讀者**——而那正是他請你做的事。
+而一個沒有標出代價的選項，讀起來像是沒有代價，這很少為真，且從清單本身無從驗證。
+
+```markdown
+> **請選擇：**
+> | 選項 | 換到什麼 | 代價是什麼 |
+> |---|---|---|
+> | **(A) …** ⭐ **推薦** — [為什麼是這個] | … | … |
+> | **(B) …** | … | … |
+```
+
+**優劣不是模稜兩可。**「這可能會稍微難一點」不是代價；「這要重寫 110 個檔，而且翻譯需要人審」才是。
+若某個選項真的沒有值得一提的代價，**明說**，不要留空——空白讀起來是「沒有分析過」，而讀者分不出這兩者。
+
+**與規則 4 相輔**：選項數維持在 1–5。優劣讓每個選項讀起來更花力氣，所以這條規則讓規則 4 的上限**更**要緊，不是更不要緊。
+
 ---
 
 ## 情境模板
@@ -353,6 +396,8 @@ AI 需要使用者做出選擇或提供資訊時使用。
 | R7 | *（選用）* 先講發現；證據放在它所支持的主張之後 |
 | R8 | *（選用）* 跨 3 輪或 3 步以上 → 用一行重述進度 |
 | R9 | *（選用）* 不要開場白。結語仍為必須——見 R1 |
+| R10 | *（選用）* 白話是主詞；識別字放在主張之後當佐證 |
+| R11 | *（選用）* 每個選項都要說明換到什麼、代價是什麼——不只推薦那一個 |
 
 | 豁免 | 不豁免 |
 |------|--------|
@@ -376,6 +421,7 @@ AI 需要使用者做出選擇或提供資訊時使用。
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.3.0 | 2026-08-17 | 新增選用規則 R10–R11。R10 管語域：白話是句子的主詞、識別字當佐證——與 R7 不同,R7 管的是「先發現後證據」的順序,而一個回應可以先講發現卻仍用只有作者持有的詞彙講它。R11 把規則 2 從推薦選項擴及全部:只論證推薦項的清單等於把比較丟回給讀者,而沒標代價的選項讀起來像沒有代價 |
 | 1.2.0 | 2026-08-17 | 新增選用規則 R7–R9，管答案本身（先講發現、重述進度、不要開場白）。借鑒自 `ayghri/i-have-adhd`（MIT），十條取三；其餘七條因已被 R1–R2 涵蓋、與 R1 衝突、或與 estimation-standards 重複而刪去。規則 1–6 全部可以被一個把結論埋起來的回應滿足——R7–R9 補上這個缺口 |
 | 1.1.0 | 2026-06-10 | 新增規則 R6 選用模型級別標注（`〔模型：Fast｜Standard｜Capable〕`）；與廠商無關；不強制既有技能回改 |
 | 1.0.0 | 2026-03-25 | 初始版本 |

package/bundled/locales/zh-TW/docs/CHEATSHEET.md

@@ -1,6 +1,6 @@
 # UDS 速查表
 
-> Quick reference for all UDS features | Last updated: 2026-08-12
+> Quick reference for all UDS features | Last updated: 2026-08-17
 
 **Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
 
@@ -80,61 +80,61 @@
 
 | Skill | 說明 |
 |-------|-------------|
-| `ac-coverage` | "[UDS] Analyze AC-to-test traceability and coverage" |
-| `adr-assistant` | [UDS] Create, manage, and track Architecture Decision Record |
-| `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses |
-| `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, laye |
-| `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, AGENTS. |
-| `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best prac |
-| `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development work |
-| `audit-assistant` | "[UDS] UDS Health & Feedback System" |
-| `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
-| `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec crea |
-| `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
-| `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
-| `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization |
-| `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
-| `commit-standards` | "[UDS] Generate commit messages following Conventional Commi |
-| `contract-test-assistant` | [UDS] Guide contract testing strategy for APIs and microserv |
-| `database-assistant` | Guide database design, migration, and query optimization. |
-| `deploy-assistant` | Guide reliable deployments without CI/CD platforms (GitHub A |
-| `dev-methodology` | "[UDS] Manage development methodology workflow" |
-| `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS  |
-| `docs-generator` | "[UDS] Generate usage documentation from project sources" |
-| `documentation-guide` | Guide documentation structure, content requirements, and pro |
-| `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, ret |
-| `e2e-assistant` | "[UDS] Generate E2E test skeletons from BDD scenarios" |
-| `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_ |
-| `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge ope |
-| `incident-response-assistant` | Guide incident response, root cause analysis, and post-morte |
-| `journey-test-assistant` | "[UDS] Generate coherent user journey test plans (TESTPLAN)  |
-| `knowledge-graph` | "[UDS] Trace spec/decision/code impact chains via a knowledg |
-| `logging-guide` | Implement structured logging with proper log levels and sens |
-| `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, a |
-| `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technol |
-| `observability-assistant` | Guide observability setup, metrics design, and alerting conf |
-| `orchestrate` | Orchestrate multi-task execution plans using Claude's native |
-| `plan` | Generate plan.json from Spec documents, OpenSpec changes, or |
-| `pr-automation-assistant` | Guide pull request creation, review automation, and merge st |
-| `project-discovery` | "[UDS] Assess project health, architecture, and risks before |
-| `project-structure-guide` | Guide for organizing project directories following language- |
-| `push` | AI-assisted safety layer for git push operations with qualit |
-| `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
-| `release-standards` | "[UDS] Guide release process and changelogs" |
-| `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST  |
-| `retrospective-assistant` | [UDS] Guide structured team retrospectives for Sprint and Re |
-| `reverse-engineer` | "[UDS] System archeology - reverse engineer code across Logi |
-| `runbook-assistant` | Guide runbook creation, maintenance, and drill exercises. |
-| `security-assistant` | Guide security review and vulnerability assessment following |
-| `security-scan-assistant` | Guide automated security scanning, dependency auditing, and  |
-| `skill-builder` | "[UDS] Identify repeated processes and build Skills with the |
-| `slo-assistant` | Guide SLI selection, SLO setting, and Error Budget managemen |
-| `spec-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables f |
-| `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Dri |
-| `sweep` | Scan codebase for debug artifacts and code quality issues; o |
-| `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
-| `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
-| `testing-guide` | Testing pyramid and test writing standards for UT/IT/ST/E2E. |
+| `ac-coverage` | [UDS] 分析驗收條件（AC）與測試之間的追蹤關係，並產生需求層級的覆蓋率報告。 |
+| `adr-assistant` | [UDS] 建立、管理並追蹤架構決策記錄（ADR）。 |
+| `ai-collaboration-standards` | 防止 AI 幻覺，確保分析程式碼或提出建議時給出以證據為基礎的回應。 |
+| `ai-friendly-architecture` | 設計 AI 友善架構，包含明確的模式、分層文件與語意邊界。 |
+| `ai-instruction-standards` | 建立並維護 AI 指令檔（CLAUDE.md、AGENTS.md、.cursor/rules/ 等），並採用適當結構。 |
+| `api-design-assistant` | 引導 API 設計，遵循 REST、GraphQL 與 gRPC 最佳實踐。 |
+| `atdd-assistant` | [UDS] 驗收測試驅動開發（ATDD）的參考資料：INVEST 準則、Gherkin 驗收條件格式與 Three Am |
+| `audit-assistant` | [UDS] 診斷 UDS 安裝的健康狀態，並向上游提交結構化回饋。 |
+| `bdd-assistant` | [UDS] 行為驅動開發（BDD）的參考資料：Gherkin 的 Given-When-Then 格式與 Three A |
+| `brainstorm-assistant` | [UDS] 在規格出現之前執行的結構化多角色腦力激盪，並附帶評分品質關卡。 |
+| `changelog-guide` | [UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。 |
+| `checkin-assistant` | [UDS] 提交前品質關卡的參考資料：關卡定義、檢查清單項目，以及絕不可提交的規則。 |
+| `ci-cd-assistant` | 引導 CI/CD 管線的設計、設定與最佳化。 |
+| `code-review-assistant` | [UDS] 系統性程式碼審查的參考資料：八大審查類別，以及 BLOCKING/IMPORTANT/SUGGESTION  |
+| `commit-standards` | [UDS] 產生符合 Conventional Commits 規範的 commit message，包含雙語格式。 |
+| `contract-test-assistant` | [UDS] 引導 API 與微服務的合約測試策略。 |
+| `database-assistant` | 引導資料庫設計、遷移與查詢最佳化。 |
+| `deploy-assistant` | 引導在沒有 CI/CD 平台（GitHub Actions／GitLab CI）的情況下完成可靠部署。 |
+| `dev-methodology` | [UDS] 為專案選擇並追蹤當前採用的開發方法論（SDD、BDD、TDD）。 |
+| `dev-workflow-guide` | [UDS] 把目前的軟體開發階段對應到正確的 UDS 指令與 Skill。 |
+| `docs-generator` | [UDS] 從專案原始檔產生使用文件（速查表、參考手冊、使用指南）。 |
+| `documentation-guide` | 引導文件結構、內容需求與專案文件的最佳實踐。 |
+| `durable-execution-assistant` | [UDS] 引導容錯工作流程設計，包含檢查點、重試策略與回滾計畫。 |
+| `e2e-assistant` | [UDS] 從 BDD 的 .feature 場景產生 E2E 測試骨架，並支援框架偵測與覆蓋缺口分析。 |
+| `error-code-guide` | 設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式。 |
+| `git-workflow-guide` | 引導 Git 分支策略、分支命名與合併操作。 |
+| `incident-response-assistant` | 引導事故回應、根因分析與事後檢討文件撰寫。 |
+| `journey-test-assistant` | [UDS] 從專案描述產生連貫的使用者旅程測試計畫（TESTPLAN）與旅程 E2E 骨架。 |
+| `knowledge-graph` | [UDS] 透過知識圖追蹤規格、決策與程式碼之間的影響鏈；沒有引擎時以 Markdown 後備方案運作。 |
+| `logging-guide` | 實作結構化日誌，包含適當的日誌層級與敏感資料處理。 |
+| `metrics-dashboard-assistant` | [UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 |
+| `migration-assistant` | [UDS] 引導系統性的程式碼遷移、框架升級與技術現代化。 |
+| `observability-assistant` | 引導可觀測性建置、指標設計與告警設定。 |
+| `orchestrate` | 以 Claude 原生 Agent tool 編排多任務執行計畫（以 DAG 為基礎，不需外部引擎）。 |
+| `plan` | 從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。 |
+| `pr-automation-assistant` | 引導 pull request 建立、審查自動化與合併策略。 |
+| `project-discovery` | [UDS] 在既有程式碼庫新增功能之前，評估專案健康度、架構與風險。 |
+| `project-structure-guide` | 依各語言的最佳實踐組織專案目錄結構的指南。 |
+| `push` | AI 輔助的 git push 安全層，提供品質關卡與協作護欄。 |
+| `refactoring-assistant` | [UDS] 引導重構決策與策略選擇，包含「重構還是重寫」這個判斷。 |
+| `release-standards` | [UDS] 引導發布流程——語意化版本、發布模式，以及 start/finish/promote/deploy 的順序。 |
+| `requirement-assistant` | [UDS] 撰寫符合 INVEST 準則的使用者故事與需求。 |
+| `retrospective-assistant` | [UDS] 引導 Sprint 與 Release 週期的結構化團隊回顧。 |
+| `reverse-engineer` | [UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 |
+| `runbook-assistant` | 引導 Runbook 的撰寫、維護與演練。 |
+| `security-assistant` | 引導安全審查與弱點評估，遵循 OWASP 標準。 |
+| `security-scan-assistant` | 引導自動化安全掃描、相依套件稽核與機密偵測。 |
+| `skill-builder` | [UDS] 把重複的手動流程轉成範圍界定得宜的 Skill，過程中拿捏恰當的流程份量。 |
+| `slo-assistant` | 引導 SLI 選取、SLO 設定與 Error Budget 管理。 |
+| `spec-derivation` | [UDS] 從已核准的規格推導出 BDD 場景、TDD 骨架、整合與 E2E 測試，以及 ATDD 表格。 |
+| `spec-driven-dev` | [UDS] 在寫程式碼之前建立並審查規格文件——規格格式、狀態與差異操作。 |
+| `sweep` | 掃描程式碼庫中的除錯殘留與程式碼品質問題；可選擇自動修正安全的模式。 |
+| `tdd-assistant` | [UDS] 測試驅動開發（TDD）的參考資料：紅-綠-重構循環、FIRST 原則與 Arrange-Act-Assert |
+| `test-coverage-assistant` | [UDS] 以八維度框架分析程式碼層級的測試覆蓋率，並建議該優先補上哪些缺口。 |
+| `testing-guide` | 測試金字塔，以及 UT/IT/ST/E2E 的測試撰寫標準。 |
 
 ## 🤖 代理