universal-dev-standards 6.6.0 → 6.7.0

package/bundled/locales/zh-CN/skills/release-standards/SKILL.md

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/release-standards/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: |
-  引导遵循语义化版本和变更日志最佳实践的发布流程。
-  使用时机：版本发布、版本管理、变更日志更新。
-  关键字：release, version, semver, changelog, 发布, 版本, 语义化。
+  [UDS] 引导发布流程——语义化版本、发布模式，以及 start/finish/promote/deploy 的顺序。
+  Use when: 切一个发布版本、决定语义化版本要升哪一位、把 release candidate 晋级为稳定版、记录一次部署。
+  Not for: 撰写变更日志条目本身——请用 /changelog；部署的实现机制——请用 /deploy。
+  Keywords: release, semantic versioning, version bump, release candidate, promote, 发布, 语义化版本, 发版流程, 版本晋级.
 ---
 
 # 发布助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/requirement-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: |
-  编写结构良好的用户故事和需求文件，遵循 INVEST 准则。
-  使用时机：编写需求、定义用户故事、验收条件。
-  关键字：requirement, user story, INVEST, acceptance criteria, 需求, 用户故事, 验收条件。
+  [UDS] 撰写符合 INVEST 准则的用户故事与需求。
+  Use when: 把一个功能构想转成用户故事、定义可测试的验收条件、检视待办项目的质量。
+  Not for: 带有设计与差异操作的完整规格文档——请用 /sdd；判断这个构想本身对不对——请用 /brainstorm。
+  Keywords: requirement, user story, INVEST, acceptance criteria, backlog refinement, 需求, 用户故事, 验收条件, 待办梳理.
 ---
 
 # 需求助手

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

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/retrospective-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: e9de3576878e
-translation_version: 1.0.0
-last_synced: 2026-07-16
+source_hash: 3efae30b9297
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
   [UDS] 引导 Sprint 与 Release 周期的结构化团队回顾。
-  使用时机：迭代结束、发布复盘、流程改善。
-  关键字：retrospective, retro, 回顾, 复盘, 持续改善。
+  Use when: Sprint 结束、发布后复盘、迭代审视、流程改善。
+  Not for: 生产环境事故的事后复盘——请用 /incident；追踪两次回顾之间的指标趋势——请用 /metrics。
+  Keywords: retrospective, retro, sprint review, lessons learned, action items, 回顾, 复盘, 迭代审视, 流程改善.
 ---
 
 # 回顾助手

package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/reverse-engineer/SKILL.md
 source_version: 1.2.0
-source_hash: 469dcdc76a83
-translation_version: 1.2.0
-last_synced: 2026-07-16
+source_hash: 4645517162ab
+translation_version: 1.3.0
+last_synced: 2026-08-17
 status: current
 description: |
-  系统考古——跨逻辑、数据、运行时三维度逆向工程代码。
-  使用时机：从代码提取规格、分析数据模型、分析运行时基准、生成 Gherkin 场景、分析测试覆盖率。
-  关键字：reverse engineering, spec, data, runtime, bdd, tdd, 逆向工程, 规格, 覆盖率。
+  [UDS] 系统考古——从逻辑、数据、运行时三个维度对既有系统做逆向工程。
+  Use when: 为没有文档的系统补上文档、从既有代码回推规格、绘制未知的数据模型或运行时拓扑。
+  Not for: 动工前评估健康度与风险——请用 /discover；从已批准的规格正向推导测试——请用 /spec-derive。
+  Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 逆向工程, 系统考古, 规格提取, 数据模型.
 ---
 
 # 逆向工程助手

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

@@ -1,10 +1,14 @@
 ---
 source: ../../../../skills/runbook-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] 引导 Runbook 撰写、维护、演练和覆盖率报告"
+description: |
+  引导 Runbook 的撰写、维护与演练。
+  Use when: 撰写 Runbook、规划演练、审计 Runbook 覆盖范围、事故后更新 Runbook。
+  Not for: 处理正在进行中的事故——请用 /incident；部署流程本身——请用 /deploy。
+  Keywords: runbook, operations, drill, on-call, procedure, 运维手册, 演练, 值班, 标准流程.
 ---
 
 # Runbook 助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/security-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: |
-  引导安全审查和漏洞评估，遵循 OWASP 标准。
-  使用时机：安全审计、漏洞检查、安全编码审查、威胁建模。
-  关键字：security, OWASP, vulnerability, authentication, authorization, 安全, 漏洞, 认证。
+  引导安全审查与漏洞评估，遵循 OWASP 标准。
+  Use when: 安全审计、漏洞检查、安全编码审查、威胁建模。
+  Not for: 自动化的依赖包、CVE 与密钥扫描——请用 /scan；处理正在发生的安全事件——请用 /incident。
+  Keywords: security, OWASP, vulnerability, authentication, authorization, 信息安全, 漏洞, 认证, 授权, 威胁建模.
 ---
 
 # 安全审计助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/security-scan-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: |
-  引导自动化安全扫描、依赖包审计和机密检测。
-  使用时机：依赖审计、CVE 扫描、机密检测、许可证合规。
-  关键字：scan, audit, CVE, dependency, secret, SBOM, vulnerability, 扫描, 漏洞。
+  引导自动化安全扫描、依赖包审计与密钥检测。
+  Use when: 依赖包审计、CVE 扫描、密钥检测、许可证合规。
+  Not for: 人工的威胁建模与安全设计审查——请用 /security；一般的代码整洁度——请用 /sweep。
+  Keywords: scan, audit, CVE, dependency, secret, SBOM, vulnerability, 扫描, 审计, 依赖包, 密钥检测.
 ---
 
 # 安全扫描助手

package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md

@@ -2,13 +2,16 @@
 name: skill-builder
 source: ../../../../skills/skill-builder/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-16
-source_hash: 1c5f079e0851
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: 8eee581c49c4
 status: current
 scope: universal
 description: |
-  [UDS] 识别重复流程并以正确的开发深度构建 Skill
+  [UDS] 把重复的手动流程转成范围界定得宜的 Skill，过程中拿捏恰当的流程分量。
+  Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。
+  Not for: 记录历史事实或项目状态——那属于记忆，不是 Skill；不会再发生的一次性任务。
+  Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.
 allowed-tools: Read, Glob, Grep, Write, Edit, Bash
 argument-hint: "[process description | 流程描述]"
 ---

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.0
+translation_version: 6.7.0
 last_synced: 2026-08-17
 status: current
 ---
@@ -17,10 +17,29 @@ status: current
 
 ## [Unreleased]
 
+## [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.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.6.0 | ✅ 最新正式版 |
+| 6.7.0 | ✅ 最新正式版 |
 | < 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/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 設計助手