universal-dev-standards 6.5.0 → 6.7.0

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

@@ -15,7 +15,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 6.5.0 | **發布日期**: 2026-08-14 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.7.0 | **發布日期**: 2026-08-17 | **授權**: [雙重授權](../../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.5.0 | ✅ 最新正式版 |
+| 6.7.0 | ✅ 最新正式版 |
 | < 6.0.0 | ❌ 已終止支援 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 

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

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/ai-response-navigation.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-06-10
+source_version: 1.3.0
+translation_version: 1.3.0
+last_synced: 2026-08-17
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **語言**: [English](../../../core/ai-response-navigation.md) | 繁體中文 | [简体中文](../../zh-CN/core/ai-response-navigation.md)
 
-**版本**: 1.1.0
-**最後更新**: 2026-06-10
+**版本**: 1.3.0
+**最後更新**: 2026-08-17
 **適用範圍**: 所有使用 AI 輔助開發的專案
 **範圍**: universal
 **產業標準**: 無（新興 AI 工具實踐）
@@ -27,6 +27,12 @@ status: current
 
 **解決方案**：在每個實質性 AI 回應結尾附加標準化的「導航區塊」，包含情境模板、推薦標記和彈性選項數量。
 
+**範圍註記（v1.2.0，v1.3.0 擴充）**：規則 1–6 管的是答案**之後**要附什麼。
+規則 7–11 **全部屬選用**，管的是答案本身：先講發現（R7）、每輪重述進度（R8）、不要開場白（R9）、
+白話是主詞（R10）、每個選項都要帶自己的優劣而非只有推薦項有（R11）。新增的理由是——
+一個回應可以滿足規則 1–6 的每一條，同時把結論埋起來；
+**而找不到答案的讀者，不會因為結尾有一個正確的導航區塊被告知下一步而得到幫助。**
+
 ---
 
 ## 核心規則
@@ -103,6 +109,103 @@ status: current
 
 ---
 
+## 導航之前的那個答案（規則 7–11，選用）
+
+> **規則 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) 重複。
+
+**這一節為何存在**：規則 1–6 管的是答案**之後**要附什麼，而答案本身沒有任何規則在管——
+一個回應可以把結論埋在一整面證據底下，只要結尾附上正確的導航區塊，
+它仍然滿足本標準的每一條。**找不到答案的讀者，不會因為被告知下一步而得到幫助。**
+
+**這五條是選用的**，語義同規則 6：採用專案不必啟用，既有 skill 也不需回頭補。
+專案**可以**在自己的設定中把任一條提升為必須。**不可選的是它們必須有精確的觸發條件**——
+一條鬆到永遠不會啟動的規則，與沒有這條規則無從分辨。
+
+### 規則 7：先講發現，不要先講過程（選用）
+
+**觸發條件**：回答問題、回報調查結果、或提出決策的回應。
+
+第一行寫**查到了什麼**或**該做什麼**。不是方法、不是把問題複述一遍、不是回答的計畫。
+
+證據——`file:line`、指令輸出、表格、量測數字——是**佐證**，應放在它所支持的主張**之後**。
+以證據開場會迫使讀者自行重建結論，而那正是他請你做的工作。
+
+| 不要寫 | 改寫成 |
+|---|---|
+| 「我檢查了 44 天、63 個網域的資料，發現……」 | 「那三組查詢刪掉。它回傳的東西有 46% 是下載頁。」 |
+| 「讓我看看這是怎麼設定的。」 | 「設定在 `x.yaml:12`，值是錯的，因為……」 |
+
+**這不代表可以省略證據**，它規範的是順序。
+
+### 規則 8：多輪工作中每一輪重述進度（選用）
+
+**觸發條件**：跨 3 輪以上的對話，或含 3 個以上步驟的任務。
+
+每則回應用一行說明工作進行到哪裡。不能假設讀者能在訊息之間記住
+「我們在 5 步中的第 3 步」，而重述它的成本是一個句子。
+
+本條與下方模板 4（進行中）互補：**規則 8 管開頭，模板 4 管結尾。**
+
+### 規則 9：不要開場白（選用）
+
+**觸發條件**：任何實質性回應。
+
+從答案開始。不要以「我接下來要做什麼」的預告、對請求的確認、或對問題本身的評價開場。
+
+本條把一項既有禁令一般化：[anti-sycophancy-prompting](anti-sycophancy-prompting.md)
+已經禁止「以正面肯定開場批評」，但**僅限批評情境**。規則 9 把同一項禁令擴及每一個實質回應，
+理由不同：不是為了防拍馬屁，而是為了消除它在讀者與答案之間製造的延遲。
+
+**規則 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 的上限**更**要緊，不是更不要緊。
+
+---
+
 ## 情境模板
 
 ### 模板 1：任務完成
@@ -290,6 +393,11 @@ AI 需要使用者做出選擇或提供資訊時使用。
 | R4 | 1–5 個選項，依情境調整 |
 | R5 | 適用時使用 `/command` 格式 |
 | R6 | *（選用）* 等級明確時附加 `〔模型：Fast｜Standard｜Capable〕` |
+| R7 | *（選用）* 先講發現；證據放在它所支持的主張之後 |
+| R8 | *（選用）* 跨 3 輪或 3 步以上 → 用一行重述進度 |
+| R9 | *（選用）* 不要開場白。結語仍為必須——見 R1 |
+| R10 | *（選用）* 白話是主詞；識別字放在主張之後當佐證 |
+| R11 | *（選用）* 每個選項都要說明換到什麼、代價是什麼——不只推薦那一個 |
 
 | 豁免 | 不豁免 |
 |------|--------|
@@ -313,6 +421,8 @@ 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/core/spec-driven-development.md

@@ -4,7 +4,7 @@ source_version: 2.3.0
 translation_version: 2.3.0
 last_synced: 2026-06-10
 source_hash: 08dd8c2bee20
-status: current
+status: stale
 ---
 
 # 規格驅動開發 (SDD) 標準

package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md

@@ -2,10 +2,14 @@
 name: ac-coverage
 source: ../../../../skills/ac-coverage/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-28
+translation_version: 1.1.0
+last_synced: 2026-08-17
 scope: universal
-description: "[UDS] 分析驗收條件（AC）與測試之間的追蹤關係並產生覆蓋率報告"
+description: |
+  [UDS] 分析驗收條件（AC）與測試之間的追蹤關係，並產生需求層級的覆蓋率報告。
+  Use when: 稽核哪些驗收條件已有測試、從 SPEC 檔建立追蹤矩陣、發布前找出尚未被覆蓋的 AC。
+  Not for: 程式碼層級的行／分支／函式覆蓋率——請用 /coverage；補寫缺少的測試——請用 /tdd 或 /spec-derive。
+  Keywords: AC coverage, traceability, acceptance criteria, SPEC, traceability matrix, 驗收條件, 需求追蹤, 覆蓋率矩陣, 追蹤矩陣.
 allowed-tools: Read, Grep, Glob
 argument-hint: "[規格檔案路徑]"
 ---

package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md

@@ -3,10 +3,14 @@ name: adr-assistant
 source: ../../../../skills/adr-assistant/SKILL.md
 source_version: 1.0.0
 source_hash: 7d8bf5944cf4
-translation_version: 1.0.0
-last_synced: 2026-06-01
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 建立、管理和追蹤架構決策記錄（ADR）"
+description: |
+  [UDS] 建立、管理並追蹤架構決策記錄（ADR）。
+  Use when: 架構決策、技術選型、設計取捨、模式選擇。
+  Not for: 不改變架構的決策——記在規格或 commit 裡即可；想法還沒成形到足以下決定——請用 /brainstorm。
+  Keywords: ADR, architecture decision, decision record, trade-off, 架構決策, 決策記錄, 設計取捨.
 ---
 
 # 架構決策記錄助手

package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md

@@ -2,13 +2,14 @@
 name: ai-collaboration-standards
 source: ../../../../skills/ai-collaboration-standards/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-05-28
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  [UDS] 防止 AI 幻覺、確保分析程式碼或提建議時以證據為基礎的回應。
-  Use when: analyzing code, making recommendations, providing options, or when user asks about confidence/certainty.
-  Keywords: certainty, assumption, inference, evidence, source, 證據, 假設, 推論.
+  防止 AI 幻覺，確保分析程式碼或提出建議時給出以證據為基礎的回應。
+  Use when: 分析程式碼、提出建議、提供選項，或使用者詢問把握度／確定性時。
+  Not for: 撰寫 AI 指令檔本身——請用 /ai-instruction-standards；審查具體的 diff——請用 /code-review。
+  Keywords: certainty, assumption, inference, evidence, source, 證據, 假設, 推論, 確定性, 反幻覺.
 ---
 
 # AI 協作標準

package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md

@@ -2,11 +2,15 @@
 name: ai-friendly-architecture
 source: ../../../../skills/ai-friendly-architecture/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-05
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 scope: universal
-description: "[UDS] 設計 AI 友善架構，包含明確模式、分層文件和語義邊界"
+description: |
+  設計 AI 友善架構，包含明確的模式、分層文件與語意邊界。
+  Use when: 為 AI 協作規劃專案結構、最佳化程式碼庫以利 AI 分析、建立 AI 上下文。
+  Not for: 撰寫指令檔本身——請用 /ai-instruction-standards；依語言慣例安排目錄配置——請用 /project-structure-guide。
+  Keywords: architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架構, AI 友善, 上下文, 語意邊界.
 ---
 
 # AI 友善架構指南

package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md

@@ -2,11 +2,15 @@
 name: ai-instruction-standards
 source: ../../../../skills/ai-instruction-standards/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-04-28
+translation_version: 2.1.0
+last_synced: 2026-08-17
 status: current
 scope: partial
-description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、AGENTS.md、.cursor/rules/ 等）並採用適當結構"
+description: |
+  建立並維護 AI 指令檔（CLAUDE.md、AGENTS.md、.cursor/rules/ 等），並採用適當結構。
+  Use when: 建立 AI 指令檔、區分通用規則與專案特定規則、設定 AI 工具。
+  Not for: 調整程式碼庫結構讓 AI 好導覽——請用 /ai-friendly-architecture；要求以證據為基礎的回答——請用 /ai-collaboration-standards。
+  Keywords: CLAUDE.md, AGENTS.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt, 指令檔, AI 設定, 系統提示詞.
 ---
 
 # AI 指令檔案標準指南

package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: api-design-assistant
 source: ../../../../skills/api-design-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-23
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導 API 設計，遵循 REST、GraphQL 和 gRPC 最佳實踐"
+description: |
+  引導 API 設計，遵循 REST、GraphQL 與 gRPC 最佳實踐。
+  Use when: 設計 API、審查端點、API 版本策略決策。
+  Not for: 驗證運行中的 API 是否符合消費端期待——請用 /contract-test；API 背後的 schema 設計——請用 /database。
+  Keywords: API, REST, GraphQL, gRPC, endpoint, versioning, 介面設計, 端點, 版本策略.
 ---
 
 # API 設計助手

package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: atdd-assistant
 source: ../../../../skills/atdd-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: "[UDS] 引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事"
+description: |
+  [UDS] 驗收測試驅動開發（ATDD）的參考資料：INVEST 準則、Gherkin 驗收條件格式與 Three Amigos 結構。
+  Use when: 與 Product Owner 一起定義驗收條件、進行規格工作坊、用 INVEST 檢視使用者故事。
+  Not for: 執行 ATDD 生命週期或強制 PO 簽核關卡——該部分已移至採用層（XSPEC-095）；撰寫單元測試——請用 /tdd。
+  Keywords: ATDD, acceptance test, acceptance criteria, INVEST, specification workshop, Three Amigos, 驗收測試驅動開發, 驗收條件, 規格工作坊.
 ---
 
 # ATDD 助手

package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: audit-assistant
 source: ../../../../skills/audit-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-04
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] UDS 健康檢查與回饋系統，診斷安裝完整性與偵測開發模式"
+description: |
+  [UDS] 診斷 UDS 安裝的健康狀態，並向上游提交結構化回饋。
+  Use when: .standards/ 看起來壞掉或不同步、驗證 manifest 完整性、回報既有 UDS 標準用起來的摩擦點。
+  Not for: 稽核你自己應用程式的程式碼品質——請用 /metrics 或 /code-review；相依套件與機密掃描——請用 /scan。
+  Keywords: UDS audit, health check, manifest integrity, standards feedback, friction, 安裝健康, 標準稽核, 回饋, 完整性檢查.
 ---
 
 # 審計助手

package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: bdd-assistant
 source: ../../../../skills/bdd-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: "[UDS] 引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式撰寫場景"
+description: |
+  [UDS] 行為驅動開發（BDD）的參考資料：Gherkin 的 Given-When-Then 格式與 Three Amigos 結構。
+  Use when: 撰寫或審查 .feature 場景、選定通用語言、針對行為進行探索式對話。
+  Not for: 執行 BDD 生命週期或 RED/GREEN 自動化——該部分已移至採用層（XSPEC-095）；把 .feature 檔轉成 E2E 骨架——請用 /e2e。
+  Keywords: BDD, Gherkin, Given When Then, feature file, scenario, Three Amigos, 行為驅動開發, 場景, 特性檔, 通用語言.
 ---
 
 # BDD 助手

package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md

@@ -2,11 +2,15 @@
 name: brainstorm-assistant
 source: ../../../../skills/brainstorm-assistant/SKILL.md
 source_version: 4.1.0
-source_hash: 0c1fa3392232
-translation_version: 4.1.0
-last_synced: 2026-07-09
+source_hash: 711404f2c4af
+translation_version: 4.2.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
+description: |
+  [UDS] 在規格出現之前執行的結構化多角色腦力激盪，並附帶評分品質關卡。
+  Use when: 想法還很模糊、在敲定方向前探索替代方案、需要多樣性而不是第一個看似合理的答案。
+  Not for: 方向已經定了的工作規劃——請用 /plan 或 /sdd；記錄已經做成的決策——請用 /adr。
+  Keywords: brainstorm, ideation, divergence, convergence, persona ensemble, devil advocate, 腦力激盪, 發想, 發散收斂, 多角色.
 ---
 
 # 腦力激盪助手

package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md

@@ -2,10 +2,14 @@
 name: changelog-guide
 source: ../../../../skills/changelog-guide/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: "[UDS] 根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目"
+description: |
+  [UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。
+  Use when: 從 commit 歷史撰寫變更日誌條目、填寫 Unreleased 區段、將變更分類為 Added/Changed/Fixed。
+  Not for: 決定下一個版本號或執行發版——請用 /release；撰寫 commit message 本身——請用 /commit。
+  Keywords: changelog, CHANGELOG.md, Keep a Changelog, release notes, unreleased, 變更日誌, 發布說明, 版本紀錄.
 ---
 
 # 變更日誌助手

package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: checkin-assistant
 source: ../../../../skills/checkin-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: "[UDS] 在提交程式碼前驗證品質關卡，確保程式碼庫穩定性"
+description: |
+  [UDS] 提交前品質關卡的參考資料：關卡定義、檢查清單項目，以及絕不可提交的規則。
+  Use when: 決定 commit 前必須通過哪些檢查、稽核專案實際強制了哪些品質關卡、確認是否已可簽入。
+  Not for: 執行關卡流程或中止 commit——該部分已移至採用層（XSPEC-095）；找出並清除除錯殘留——請用 /sweep。
+  Keywords: check-in, pre-commit, quality gate, commit readiness, never commit, 簽入, 提交前檢查, 品質關卡, 檢查清單.
 ---
 
 # 簽入助手

package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: ci-cd-assistant
 source: ../../../../skills/ci-cd-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-24
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導 CI/CD 管線設計、配置和優化"
+description: |
+  引導 CI/CD 管線的設計、設定與最佳化。
+  Use when: 建置管線、縮短建置時間、設定部署階段。
+  Not for: 沒有 CI/CD 平台的部署——請用 /deploy；版本號遞增與晉級——請用 /release。
+  Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署, 管線.
 ---
 
 # CI/CD 管線助手

package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: code-review-assistant
 source: ../../../../skills/code-review-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: "[UDS] 使用標準化檢查清單執行系統性程式碼審查"
+description: |
+  [UDS] 系統性程式碼審查的參考資料：八大審查類別，以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。
+  Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。
+  Not for: 執行有關卡的審查流程——該部分已移至採用層（XSPEC-095）；提交前的關卡驗證——請用 /checkin。
+  Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.
 ---
 
 # 程式碼審查助手

package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md

@@ -3,10 +3,14 @@ name: commit-standards
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
 source_hash: 8535f438ced8
-translation_version: 1.0.0
-last_synced: 2026-06-01
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
+description: |
+  [UDS] 產生符合 Conventional Commits 規範的 commit message，包含雙語格式。
+  Use when: 為已暫存的變更撰寫 commit message、選擇 type 與 scope、產出英文與中文並列的主旨與內文。
+  Not for: 判斷這份變更是否已可提交——請用 /checkin；把多個 commit 彙整成發布說明——請用 /changelog。
+  Keywords: commit message, Conventional Commits, feat, fix, refactor, scope, bilingual, 提交訊息, 雙語 commit, 提交規範.
 ---
 
 # Commit Message 助手

package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md

@@ -3,10 +3,14 @@ name: contract-test-assistant
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
 source_hash: f67623eb913a
-translation_version: 1.0.0
-last_synced: 2026-06-01
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導 API 和微服務的合約測試策略"
+description: |
+  [UDS] 引導 API 與微服務的合約測試策略。
+  Use when: API 合約、微服務、消費者驅動測試、提供者驗證。
+  Not for: 一開始的 API 介面設計——請用 /api-design；經由 UI 的使用者可見流程——請用 /e2e。
+  Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 合約測試, 消費者驅動, 提供者驗證.
 ---
 
 # 合約測試助手

package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: database-assistant
 source: ../../../../skills/database-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-23
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導資料庫設計、遷移規劃和查詢最佳化"
+description: |
+  引導資料庫設計、遷移與查詢最佳化。
+  Use when: schema 設計、遷移規劃、查詢最佳化、索引策略。
+  Not for: 應用程式碼遷移或框架升級——請用 /migrate；資料之上的 API 合約——請用 /api-design。
+  Keywords: database, schema, migration, SQL, index, query, 資料庫, 遷移, 查詢, 索引策略.
 ---
 
 # 資料庫助手

package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md

@@ -2,13 +2,14 @@
 name: deploy
 source: ../../../../skills/deploy-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-28
+translation_version: 1.1.0
+last_synced: 2026-08-17
 scope: universal
 description: |
-  [UDS] 無 CI/CD 平台環境下的可靠部署指引（不依賴 GitHub Actions / GitLab CI）。
-  Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure.
-  Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無CI/CD, 部署.
+  引導在沒有 CI/CD 平台（GitHub Actions／GitLab CI）的情況下完成可靠部署。
+  Use when: 部署到 VPS、離線隔離的伺服器，或任何沒有 CI/CD 基礎設施的環境。
+  Not for: 建立在 GitHub Actions 或 GitLab CI 上的管線——請用 /ci-cd；版本號遞增與發布晉級——請用 /release。
+  Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無 CI/CD, 部署, 藍綠部署, 回滾.
 allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
 argument-hint: "[專案類型: node/python/docker/go]"
 ---

package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md

@@ -2,13 +2,14 @@
 name: methodology
 source: ../../../../skills/dev-methodology/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-28
+translation_version: 1.1.0
+last_synced: 2026-08-17
 scope: partial
 description: |
-  [UDS] /methodology: 選擇並追蹤開發方法論（SDD/BDD/TDD）。
-  Use when: 選擇方法論、切換開發模式、查詢當前方法論狀態。
-  若要查詢各階段對應指令請用 /dev-workflow。
+  [UDS] 為專案選擇並追蹤當前採用的開發方法論（SDD、BDD、TDD）。
+  Use when: 決定專案該遵循哪一套方法論、切換方法論、查詢目前方法論處於哪個階段。
+  Not for: 查詢某個開發階段該執行哪個指令——請用 /dev-workflow；執行方法論本身——請用 /sdd、/bdd 或 /tdd。
+  Keywords: methodology, SDD, BDD, TDD, phase tracking, methodology selection, 方法論, 開發方法選擇, 階段追蹤.
 allowed-tools: Read, Write, Grep, Glob
 argument-hint: "[動作] [參數]"
 ---

package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md

@@ -2,11 +2,15 @@
 name: dev-workflow-guide
 source: ../../../../skills/dev-workflow-guide/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-02
+translation_version: 1.1.0
+last_synced: 2026-08-17
 source_hash: 5bf83f0db544
 status: current
-description: "[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南"
+description: |
+  [UDS] 把目前的軟體開發階段對應到正確的 UDS 指令與 Skill。
+  Use when: 不確定手上的任務該用哪個 UDS 指令、初次上手 UDS、帶著一個功能從規劃走到發布。
+  Not for: 選擇或切換方法論——請用 /methodology；實際執行某階段的工作——請用該階段自己的 Skill。
+  Keywords: workflow, development phase, command routing, which command, UDS guide, 開發階段, 指令對照, 流程指南.
 ---
 
 # 開發工作流程指南

package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md

@@ -2,10 +2,14 @@
 name: docs-generator
 source: ../../../../skills/docs-generator/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: "[UDS] 從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）"
+description: |
+  [UDS] 從專案原始檔產生使用文件（速查表、參考手冊、使用指南）。
+  Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。
+  Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide；變更日誌條目——請用 /changelog。
+  Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文件, 速查表, 文件產生, 參考手冊.
 ---
 
 # 文件產生器

package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md

@@ -2,10 +2,14 @@
 name: documentation-guide
 source: ../../../../skills/documentation-guide/SKILL.md
 source_version: 2.1.0
-translation_version: 2.1.0
-last_synced: 2026-03-17
+translation_version: 2.2.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導文件結構、內容需求和專案文件最佳實踐"
+description: |
+  引導文件結構、內容需求與專案文件的最佳實踐。
+  Use when: 建立 README、撰寫文件、規劃 docs 目錄、專案初始設定、技術文件。
+  Not for: 從原始碼機械式產生文件——請用 /docgen；變更日誌條目——請用 /changelog。
+  Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 說明文件, 技術文件.
 ---
 
 # 文件指南

package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: durable-execution-assistant
 source: ../../../../skills/durable-execution-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-24
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導工作流程故障恢復，包含檢查點、重試與回滾策略"
+description: |
+  [UDS] 引導容錯工作流程設計，包含檢查點、重試策略與回滾計畫。
+  Use when: 長時間執行的工作流程總是中途失敗、設計檢查點的粒度、選擇重試或退避策略。
+  Not for: 處理正在發生中的線上事故——請用 /incident；部署回滾的實作機制——請用 /deploy。
+  Keywords: durable execution, checkpoint, retry, backoff, idempotency, rollback, 持久執行, 檢查點, 重試策略, 冪等.
 ---
 
 # 持久執行助手