universal-dev-standards 5.14.0 → 5.16.0

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

@@ -2,49 +2,73 @@
 source: ../../../../skills/testing-guide/SKILL.md
 source_version: 1.2.0
 translation_version: 1.2.0
-last_synced: 2026-02-10
+last_synced: 2026-06-02
+source_hash: 49b6f9e0c6a4
 status: current
 name: testing
 description: |
-  Testing pyramid and test writing standards for UT/IT/ST/E2E.
-  Supports ISTQB and Industry Pyramid frameworks.
-  Use when: writing tests, discussing test coverage, test strategy, or test naming.
-  Keywords: test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 测试, 单元, 集成, 端对端.
+  面向 UT/IT/ST/E2E 的测试金字塔与测试编写标准。
+  支持 ISTQB 与业界通行金字塔两种框架。
+  使用时机：编写测试、讨论测试覆盖率、测试策略或测试命名时。
+  关键词：test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 测试, 单元, 集成, 端对端。
 ---
 
 # 测试指南
 
 > **语言**: [English](../../../../skills/testing-guide/SKILL.md) | 简体中文
 
-**版本**: 1.1.0
-**最後更新**: 2025-12-29
-**適用範圍**: Claude Code Skills
+**版本**: 1.2.0
+**最后更新**: 2026-01-29
+**适用范围**: Claude Code Skills
 
 ---
 
 ## 目的
 
-本 Skill 提供测试金字塔标准和系统化测试的最佳实踐，支援 ISTQB 和业界通行金字塔框架。
+本 Skill 提供测试金字塔标准和系统化测试的最佳实践，同时支持 ISTQB 与业界通行金字塔两种框架。
+
+## 测试技能导航 | Testing Skills Navigator
+
+UDS 提供 6 个与测试相关的 Skill。使用以下决策树找到合适的那一个：
+
+```
+你想做什么？ | What do you want to do?
+├── 测量代码覆盖率（行/分支/函数）             → /coverage
+├── 追踪哪些需求已有测试（AC 可追溯性）         → /ac-coverage
+├── 以测试驱动开发进行（红-绿-重构）           → /tdd
+├── 编写 BDD 场景（Given-When-Then）           → /bdd
+├── 与利益相关者定义验收测试                   → /atdd
+└── 学习测试标准与最佳实践                     → /testing（本 Skill）
+```
+
+| Skill | 焦点 | Focus |
+|-------|------|-------|
+| `/testing` | 测试标准与最佳实践参考 | Standards and best practices reference |
+| `/coverage` | 代码层级覆盖率分析 | Code-level coverage analysis |
+| `/ac-coverage` | 需求层级 AC 可追溯性 | Requirement-level AC traceability |
+| `/tdd` | 红-绿-重构开发循环 | Red-Green-Refactor development cycle |
+| `/bdd` | Given-When-Then 行为场景 | Behavior scenarios with Given-When-Then |
+| `/atdd` | 与利益相关者定义验收条件 | Acceptance criteria with stakeholders |
 
 ## 框架选择
 
-| 框架 | 层级 | 適用場景 |
+| 框架 | 层级 | 适用场景 |
 |-----------|--------|----------|
-| **ISTQB** | UT → IT/SIT → ST → AT/UAT | 企业级、合規性、正式 QA |
+| **ISTQB** | UT → IT/SIT → ST → AT/UAT | 企业级、合规性、正式 QA |
 | **业界通行金字塔** | UT (70%) → IT (20%) → E2E (10%) | 敏捷、DevOps、CI/CD |
 
-**集成测试縮写说明：**
-- **IT** (Integration Testing)：敏捷/DevOps 社群常用
-- **SIT** (System Integration Testing)：企业/ISTQB 環境常用
-- 兩者指的是相同的测试层级
+**集成测试缩写说明：**
+- **IT** (Integration Testing)：敏捷/DevOps 社区常用
+- **SIT** (System Integration Testing)：企业/ISTQB 环境常用
+- 两者指的是相同的测试层级
 
-## 快速參考
+## 快速参考
 
 ### 测试金字塔（业界标准）
 
 ```
               ┌─────────┐
-              │   E2E   │  ← 10%（較少、較慢）
+              │   E2E   │  ← 10%（较少、较慢）
              ─┴─────────┴─
             ┌─────────────┐
             │   IT/SIT    │  ← 20%（集成测试）
@@ -54,33 +78,36 @@ description: |
           └─────────────────┘
 ```
 
-### 测试层级概覽
+### 测试层级概览
 
-| 层级 | 範圍 | 速度 | 相依性 |
+| 层级 | 范围 | 速度 | 依赖 |
 |-------|-------|-------|-------------|
-| **UT** | 单一函式/类别 | < 100ms | Mock |
-| **IT/SIT** | 元件互动 | 1-10秒 | 真实数据庫（容器化） |
-| **ST** | 完整系统（ISTQB） | 分鐘级 | 类生产環境 |
-| **E2E** | 使用者旅程 | 30秒+ | 所有真实環境 |
-| **AT/UAT** | 业务验证（ISTQB） | 视情况 | 所有真实環境 |
+| **UT** | 单一函数/类 | < 100ms | Mock |
+| **IT/SIT** | 组件交互 | 1-10秒 | 真实数据库（容器化） |
+| **ST** | 完整系统（ISTQB） | 分钟级 | 类生产环境 |
+| **E2E** | 用户旅程 | 30秒+ | 一切均为真实 |
+| **AT/UAT** | 业务验证（ISTQB） | 视情况 | 一切均为真实 |
 
-### 覆蓋率目標
+### 覆盖率目标
 
-| 指標 | 最低要求 | 建议值 |
+| 指标 | 最低要求 | 建议值 |
 |--------|---------|-------------|
-| 行覆蓋率 | 70% | 85% |
-| 分支覆蓋率 | 60% | 80% |
-| 函式覆蓋率 | 80% | 90% |
+| 行覆盖率 | 70% | 85% |
+| 分支覆盖率 | 60% | 80% |
+| 函数覆盖率 | 80% | 90% |
 
 ## 详细指南
 
-完整标准請參考：
-- [测试金字塔](./testing-pyramid.md)
+完整标准请参考：
+- [测试标准](../../core/testing-standards.md) - 可执行的规则
+- [测试理论](./testing-theory.md) - 教学型知识库
+- [测试金字塔](./testing-pyramid.md) - 详细的金字塔比例
+- [测试骨架模板](./test-skeleton-templates.md) - 面向 UT/IT/ST/Perf/Contract 的多语言骨架
 
-### AI 優化格式（Token 高效）
+### AI 优化格式（Token 高效）
 
-供 AI 助理使用，請採用 YAML 格式文件以減少 Token 使用量：
-- 基礎标准：`ai/standards/testing.ai.yaml`
+供 AI 助理使用，请采用 YAML 格式文件以减少 Token 用量：
+- 基础标准：`ai/standards/testing.ai.yaml`
 - 框架选项：
   - ISTQB 框架：`ai/options/testing/istqb-framework.ai.yaml`
   - 业界通行金字塔：`ai/options/testing/industry-pyramid.ai.yaml`
@@ -89,8 +116,12 @@ description: |
   - 集成测试：`ai/options/testing/integration-testing.ai.yaml`
   - 系统测试：`ai/options/testing/system-testing.ai.yaml`
   - E2E 测试：`ai/options/testing/e2e-testing.ai.yaml`
+  - 安全测试：`ai/options/testing/security-testing.ai.yaml`
+  - 性能测试：`ai/options/testing/performance-testing.ai.yaml`
+  - 契约测试：`ai/options/testing/contract-testing.ai.yaml`
+- 骨架模板（涵盖所有层级、多语言）：[test-skeleton-templates.md](./test-skeleton-templates.md)
 
-## 命名慣例
+## 命名惯例
 
 ### 文件命名
 
@@ -113,70 +144,159 @@ test_[method]_[scenario]_[expected]()
 
 | 类型 | 用途 | 使用时机 |
 |------|---------|-------------|
-| **Stub** | 回传预定義值 | 固定 API 响应 |
-| **Mock** | 验证互动 | 检查方法是否被呼叫 |
-| **Fake** | 簡化实作 | 记忆体数据庫 |
-| **Spy** | 记录呼叫、委派 | 部分 Mock |
+| **Stub** | 返回预定义值 | 固定的 API 响应 |
+| **Mock** | 验证交互 | 检查方法是否被调用 |
+| **Fake** | 简化实现 | 内存数据库 |
+| **Spy** | 记录调用、委派 | 部分 Mock |
 
-### 何时使用
+### 何时使用何种
 
-- **UT**: 对所有外部相依使用 mock/stub
-- **IT**: 数据庫使用 fake，外部 API 使用 stub
-- **ST**: 真实元件，僅对外部服务使用 fake
-- **E2E**: 全部使用真实環境
+- **UT**：对所有外部依赖使用 mock/stub
+- **IT**：数据库使用 fake，外部 API 使用 stub
+- **ST**：真实组件，仅对外部服务使用 fake
+- **E2E**：一切均为真实
 
 ## AAA 模式
 
 ```typescript
 test('method_scenario_expected', () => {
-    // Arrange - 设置测试数据
+    // Arrange - Setup test data
     const input = createTestInput();
     const sut = new SystemUnderTest();
 
-    // Act - 执行行为
+    // Act - Execute behavior
     const result = sut.execute(input);
 
-    // Assert - 验证結果
+    // Assert - Verify result
     expect(result).toBe(expected);
 });
 ```
 
-## FIRST 原則
+## FIRST 原则
 
-- **F**ast（快速） - 测试执行快速
-- **I**ndependent（獨立） - 测试之间不互相影響
-- **R**epeatable（可重複） - 每次执行結果相同
-- **S**elf-validating（自我验证） - 明确的通過/失败
-- **T**imely（及时） - 与产品代码一起撰写
+- **F**ast（快速） - 测试执行迅速
+- **I**ndependent（独立） - 测试之间互不影响
+- **R**epeatable（可重复） - 每次执行结果相同
+- **S**elf-validating（自我验证） - 明确的通过/失败
+- **T**imely（及时） - 与生产代码一起编写
 
 ## 应避免的反模式
 
-- ❌ 测试相依（测试必須按順序执行）
-- ❌ 不穩定测试（有时通過、有时失败）
-- ❌ 测试实作細节
-- ❌ 過度 Mock
-- ❌ 缺少斷言
-- ❌ 魔術數字/字串
+- ❌ 测试相互依赖（测试必须按顺序执行）
+- ❌ 不稳定测试（有时通过、有时失败）
+- ❌ 测试实现细节
+- ❌ 过度 Mock
+- ❌ 缺少断言
+- ❌ 魔术数字/字符串
+
+---
+
+## 测试理论要点（YAML 压缩）
+
+```yaml
+# === ISTQB FUNDAMENTALS ===
+terminology:
+  error: "Human mistake in thinking"
+  defect: "Bug in code (caused by error)"
+  failure: "System behaves incorrectly (caused by defect)"
+  chain: "Error → Defect → Failure"
+
+oracle_problem:
+  definition: "How do we know the expected result is correct?"
+  approaches:
+    - specification_oracle: "Compare against spec"
+    - reference_oracle: "Compare against reference impl"
+    - consistency_oracle: "Same input → same output"
+    - heuristic_oracle: "Reasonable approximation"
+
+# === STATIC vs DYNAMIC ===
+static_testing:
+  definition: "Examine without executing"
+  techniques: [reviews, walkthroughs, inspections, static_analysis]
+  finds: "Defects before runtime"
+  examples: [ESLint, SonarQube, code_review]
+
+dynamic_testing:
+  definition: "Execute and observe behavior"
+  techniques: [unit, integration, system, acceptance]
+  finds: "Failures during execution"
+
+# === TEST DESIGN TECHNIQUES ===
+black_box:
+  equivalence_partitioning:
+    principle: "Divide inputs into equivalent classes"
+    example: "Age: [<0 invalid], [0-17 minor], [18-64 adult], [65+ senior]"
+  boundary_value:
+    principle: "Test at boundaries of partitions"
+    example: "Age: test -1, 0, 17, 18, 64, 65"
+  decision_table:
+    principle: "Combinations of conditions → actions"
+    use: "Complex business rules"
+  state_transition:
+    principle: "Valid sequences of states"
+    use: "Workflow, state machines"
+
+white_box:
+  statement_coverage: "Every statement executed once"
+  branch_coverage: "Every decision branch taken"
+  condition_coverage: "Every condition T/F"
+  path_coverage: "Every possible path (often impractical)"
+
+# === RISK-BASED TESTING ===
+risk_assessment:
+  likelihood: "How likely to fail?"
+  impact: "How bad if fails?"
+  priority: "likelihood × impact"
+
+risk_matrix:
+  high_high: "Test extensively, first priority"
+  high_low: "Good coverage"
+  low_high: "Good coverage"
+  low_low: "Basic coverage"
+
+# === DEFECT MANAGEMENT ===
+defect_lifecycle:
+  states: [new, assigned, in_progress, fixed, verified, closed]
+  reopen_trigger: "Verification fails"
+
+severity_vs_priority:
+  severity: "Technical impact (critical/major/minor/trivial)"
+  priority: "Business urgency (high/medium/low)"
+  example: "Typo on login page: low severity, high priority (brand)"
+
+# === TEST ENVIRONMENT ===
+isolation_levels:
+  unit: "In-memory, mocked deps"
+  integration: "Containerized DB (Docker)"
+  staging: "Production-like, isolated"
+  production: "Real, feature flags for testing"
+
+test_data_strategies:
+  fixtures: "Static predefined data"
+  factories: "Dynamic generation (faker)"
+  snapshots: "Sanitized production copy"
+  synthetic: "Algorithm-generated edge cases"
+```
 
 ---
 
-## 设置偵测
+## 设置侦测
 
-本 Skill 支援项目特定设置。
+本 Skill 支持项目特定的设置。
 
-### 偵测順序
+### 侦测顺序
 
-1. 检查 `CONTRIBUTING.md` 的「停用 Skills」區段
-   - 如果列出此 Skill，則为該项目停用
-2. 检查 `CONTRIBUTING.md` 的「测试标准」區段
-3. 若未找到，**预设使用标准覆蓋率目標**
+1. 检查 `CONTRIBUTING.md` 的「Disabled Skills」（停用 Skills）区段
+   - 如果列出此 Skill，则其在该项目被停用
+2. 检查 `CONTRIBUTING.md` 的「Testing Standards」（测试标准）区段
+3. 若未找到，**默认使用标准覆盖率目标**
 
 ### 首次设置
 
 若未找到设置且上下文不清楚时：
 
-1. 詢問使用者：「此项目尚未设置测试标准。您想要自订覆蓋率目標嗎？」
-2. 使用者选择後，建议在 `CONTRIBUTING.md` 中记录：
+1. 询问用户：「此项目尚未配置测试标准。您想要自定义覆盖率目标吗？」
+2. 用户选择后，建议在 `CONTRIBUTING.md` 中记录：
 
 ```markdown
 ## Testing Standards
@@ -189,7 +309,7 @@ test('method_scenario_expected', () => {
 | Function | 85% |
 ```
 
-### 设置範例
+### 设置示例
 
 在项目的 `CONTRIBUTING.md` 中：
 
@@ -211,60 +331,37 @@ test('method_scenario_expected', () => {
 
 ---
 
-## 相关标准
-
-- [测试标准](../../../../core/testing-standards.md)
-- [程序码审查检查清单](../../../../core/code-review-checklist.md)
+## 下一步引导 | Next Steps Guidance
 
----
+`/testing` 完成后，AI 助理应建议：
 
-## 版本历史
-
-| 版本 | 日期 | 变更内容 |
-|---------|------|---------|
-| 1.1.0 | 2025-12-29 | 新增：框架选择（ISTQB/业界通行金字塔）、IT/SIT 縮写说明 |
-| 1.0.0 | 2025-12-24 | 新增：标准區段（目的、相关标准、版本历史、授权） |
+> **测试标准与最佳实践已掌握。建议下一步 / Testing standards and best practices understood. Suggested next steps:**
+> - 执行 `/tdd` 开始测试驱动开发（红-绿-重构循环） ⭐ **推荐 / Recommended** — 将测试知识立即转化为实践 / Turn testing knowledge into practice immediately
+> - 执行 `/coverage` 分析当前代码覆盖率 — 找出测试缺口 / Identify testing gaps
+> - 执行 `/bdd` 编写行为驱动的 Given-When-Then 场景 — 从用户角度定义测试 / Define tests from user perspective
 
 ---
 
-## 授权
-
-本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
-
-**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
-
-
-## Next Steps Guidance | 下一步引導
-
-After `/testing` completes, the AI assistant should suggest:
-
-> **測試標準與最佳實踐已掌握。建議下一步 / Testing standards and best practices understood. Suggested next steps:**
-> - 執行 `/tdd` 開始測試驅動開發（紅-綠-重構循環） ⭐ **Recommended / 推薦** — 將測試知識立即轉化為實踐 / Turn testing knowledge into practice immediately
-> - 執行 `/coverage` 分析目前程式碼覆蓋率 — 找出測試缺口 / Identify testing gaps
-> - 執行 `/bdd` 撰寫行為驅動的 Given-When-Then 場景 — 從使用者角度定義測試 / Define tests from user perspective
-
----
-
-## Related Standards
+## 相关标准
 
-- [Testing Standards](../../core/testing-standards.md) - Actionable rules
-- [Testing Theory](./testing-theory.md) - Educational knowledge base
-- [Code Review Checklist](../../core/code-review-checklist.md)
+- [测试标准](../../core/testing-standards.md) - 可执行的规则
+- [测试理论](./testing-theory.md) - 教学型知识库
+- [代码审查检查清单](../../core/code-review-checklist.md)
 
 ---
 
-## Version History
+## 版本历史
 
-| Version | Date | Changes |
+| 版本 | 日期 | 变更内容 |
 |---------|------|---------|
-| 1.2.0 | 2026-01-29 | Added links to new testing-theory.md knowledge base |
-| 1.1.0 | 2025-12-29 | Added Testing Theory Essentials YAML section |
-| 1.0.0 | 2025-12-24 | Initial: Standard sections (Purpose, Related Standards, Version History, License) |
+| 1.2.0 | 2026-01-29 | 新增指向新建 testing-theory.md 知识库的链接 |
+| 1.1.0 | 2025-12-29 | 新增测试理论要点 YAML 区段 |
+| 1.0.0 | 2025-12-24 | 初版：标准区段（目的、相关标准、版本历史、授权） |
 
 ---
 
-## License
+## 授权
 
-This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
 
-**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.14.0
-translation_version: 5.14.0
-last_synced: 2026-05-27
+source_version: 5.16.0
+translation_version: 5.16.0
+last_synced: 2026-06-08
 status: current
 ---
 
@@ -17,6 +17,49 @@ status: current
 
 ## [Unreleased]
 
+## [5.16.0] - 2026-06-08
+
+### 新增 — 測試推導鏈延伸至使用者指南（XSPEC-260）
+
+- **`core/forward-derivation-standards.md`**：新增 `## Terminal Projection: User Guide`（終端投影：使用者指南）段 + `### Single-Spine Principle`（單一主幹原則）。把推導管道從測試延伸到使用者指南——使用者指南是 journey／E2E 測試以機器驗證的同一條 AC 主幹的終端投影。定義共用 `T-NNN` 編號（使用者指南步驟的 `T-NNN` 必須等於某個真實 journey／E2E 測試的 id）、user-facing AC 篩選與保守預設，以及單一主幹原則：測試／文件來源是同一 AC 主幹的 N×1 投影、非 N×N 平行對照；另立平行編號體系即為違規。
+- **`ai/standards/forward-derivation-standards.ai.yaml`**：對應 `terminal_projection` 區塊 + 3 條 rules（`single-spine-no-parallel-numbering`、`user-guide-shared-tnnn`、`user-facing-ac-conservative-default`）。
+- **`core/acceptance-criteria-traceability.md`**：新增 `## User-Documentation Coverage`（使用者文件覆蓋）維度——追蹤 user-facing AC 是否被使用者指南記載。含 user-facing AC 篩選（保守預設：判不準歸 user-facing）、沿用 ✅/⚠️/❌ 狀態，及排除非 user-facing 與 `not_implemented` AC 的覆蓋率公式。
+- **`ai/standards/acceptance-criteria-traceability.ai.yaml`**：對應 `user_doc_coverage` 區塊 + 2 條 rules（`user-doc-user-facing-only`、`user-doc-shared-tnnn`）。
+- **zh-TW / zh-CN 語言版**：兩標準的新段落均完整翻譯。
+
+## [5.15.0] - 2026-05-28
+
+### 新增 — i18n 分層語言策略（XSPEC-239）
+
+- **`core/ai-instruction-standards.md` v1.0.0 → v1.1.0**：新增 `## 國際化（i18n）` 章節，定義 SKILL.md 與 root 級 AI 指令檔的 L1/L2/L3/L4 分層語言策略。**範圍延伸**自原本只規範 root 級（`CLAUDE.md`、`.cursorrules` 等）擴張至涵蓋 skill 級檔案（`SKILL.md`）。定義 canonical/locale 檔案結構、責任邊界、chimera 防範規則、採用者安裝模式。
+- **`ai/standards/ai-instruction-standards.ai.yaml` v1.0.0 → v1.1.0**：對應的 `i18n:` 區塊 + 4 條新規則（`i18n-canonical-english-only`、`i18n-locale-must-match-language`、`i18n-l3-template-language-controls-output`、`i18n-no-manual-canonical-edits-by-adopters`）。
+- **10 個缺漏 zh-TW locale skill 變體**：`ac-coverage`、`deploy-assistant`、`dev-methodology`、`journey-test-assistant`、`orchestrate`、`plan`、`push`、`skill-builder`、`spec-derivation`、`sweep`。zh-TW skill 覆蓋率達 54/54（100%）。
+- **`cli/src/lint/i18n.js` + `uds check --i18n` 命令**：強制執行 5 條 chimera 防範規則（`canonical:description-must-be-ascii` 錯誤、`locale:description-must-match-language` 錯誤、`locale:must-have-source-frontmatter` 錯誤、`canonical:l3-language-consistency` 警告、`translation-drift-warn` 警告）。Error 退出碼 1。`--json` 模式給 CI 用。
+- **`scripts/generate-locale-coverage.mjs` + 自動產生的 `locales/COVERAGE.md`**：依 skill/standard × locale 的覆蓋率矩陣 + drift 警告。npm script `docs:locale-coverage`。
+- **`UDS_LOCALE` 環境變數支援**：在 `cli/src/i18n/messages.js detectLanguage()` 與 `cli/src/commands/update.js resolveLocale()` 讀取。接受 `zh-tw`、`zh_tw`、`zh-cn`、`zh_cn`、`en`（不分大小寫）。
+- **`.uds/install.yaml` `locale:` 欄位支援**：`cli/src/utils/config-manager.js readInstallYaml()` 讀取可選 `locale:`，讓採用者宣告偏好 locale 一次，免去每次 `--locale`。
+- **Locale fallback WARN**：當 `installSingleSkill` 從缺漏的 locale 變體 fallback 到英文時，安裝結束時統一以黃色 WARN 區塊列出受影響 skill。取代原本的 silent fallback。
+- **i18n 訊息**：在 en/zh-tw/zh-cn locale 中新增 `localeFallbackTitle` / `localeFallbackHint` 鍵。
+
+### 變更
+
+- **CLI locale 解析優先順序**（`cli/src/commands/update.js resolveLocale()`）：現為 6 階層 — `--locale` CLI 旗標 > `.uds/install.yaml` `locale:` > `UDS_LOCALE` env > manifest > `.standards/` 偵測 > `'en'`。`init` 與 `update` 一致。
+- **`core/ai-instruction-standards.md` 譯本**：zh-TW 與 zh-CN locale 同步至 v1.1.0 含完整在地化 i18n 章節。（zh-CN 章節標記 pending-review，依 XSPEC-239 O-2 — 簡中翻譯品質策略未定。）
+
+### 修正
+
+- **29 個 canonical SKILL.md 描述 chimera 修正**（XSPEC-239 Phase 1B）：自下列 skill 的 `description:` frontmatter 移除 CJK 內容：`adr-assistant`、`ai-collaboration-standards`、`ai-friendly-architecture`、`ai-instruction-standards`、`api-design-assistant`、`audit-assistant`、`ci-cd-assistant`、`contract-test-assistant`、`database-assistant`、`deploy-assistant`、`documentation-guide`、`error-code-guide`、`git-workflow-guide`、`incident-response-assistant`、`journey-test-assistant`、`logging-guide`、`observability-assistant`、`orchestrate`、`plan`、`pr-automation-assistant`、`project-structure-guide`、`push`、`retrospective-assistant`、`runbook-assistant`、`security-assistant`、`security-scan-assistant`、`slo-assistant`、`sweep`、`testing-guide`。譯本改放於 `locales/{lang}/skills/`。原本依賴 `.claude/skills/` 中繁中描述的採用者應重跑 `uds update --locale zh-TW`（或 `--locale zh-CN`）。
+- **`skills/reverse-engineer/SKILL.md` description em dash（U+2014）** 改為 ASCII hyphen — canonical 描述必須純 ASCII（依新 lint 規則）。
+- **`locales/zh-TW/core/self-review-protocol.md` 缺 YAML frontmatter** 已補（`source:`、`source_version:`、`translation_version:`、`last_synced:`、`status:`），與其他 zh-TW core 變體一致。
+
+### 採用者升級注意
+
+對於以 `--locale zh-TW` 或 `--locale zh-CN` 安裝 UDS（或被 `LANG=zh_*` 偵測）的專案，本次 release 可能造成使用者可見的變化：
+
+- **升級後請執行 `uds update`**。原本描述含中文的 skill，canonical 中的 `description:` 會變英文，繁中 `description:` + body 在 locale 變體中。`.claude/skills/{name}/SKILL.md` 會從 locale 變體自動重新安裝。
+- **手動編輯過 canonical** 檔案（在 `.claude/skills/` 加繁中描述）的採用者，請將客製化內容調整至 locale 變體或 overlay — 詳見 `core/ai-instruction-standards.md` 的 `XSPEC-239` 遷移章節。
+- 新的 `uds check --i18n` lint 可驗證專案乾淨：errors 阻擋，warnings（例如 `translation-drift-warn`）只進 dashboard 不預設 fail CI。
+
 ## [5.14.0] - 2026-05-27
 
 ### 新增

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

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

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

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

package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md

@@ -116,6 +116,52 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
 
 ---
 
+## 使用者文件覆蓋
+
+上方的 AC↔測試矩陣驗證 AC 是否被*測試*。第二個維度則驗證 **user-facing AC 是否同時被使用者指南記載**。這把可追溯主幹從測試延伸到使用者指南——見正向推演標準 →《終端投影：使用者指南》。使用者指南與 journey／E2E 套件是同一作業流程的兩個投影，因此共用一把尺：`T-NNN`。
+
+### User-Facing AC 篩選
+
+此維度**只套用於 user-facing AC**——終端使用者可直接觀察或操作者。如此可避免此維度退化成對每個內部 AC 的全面文件義務。
+
+| AC 類型 | user-facing？ |
+|---------|--------------|
+| UI 流程、畫面、導覽 | 是 |
+| 使用者執行的 CLI 指令／旗標 | 是 |
+| 對外 API 的使用者語意（使用者呼叫的公開契約）| 是 |
+| 內部重構／模組契約 | 否 |
+| 效能門檻、容量 | 否 |
+| 安全內控、內部護欄 | 否 |
+
+**保守預設**：判不準時一律歸 user-facing。排除某個 AC 必須**明確標記**（如 `user_facing: false`），絕不靜默省略。
+
+### 使用者文件狀態
+
+沿用相同符號，改回答「此 user-facing AC 是否被某個使用者指南步驟覆蓋？」：
+
+| 狀態 | 符號 | 定義 |
+|------|------|------|
+| **已記載** | ✅ | 有使用者指南步驟覆蓋此 AC，並標上該 AC 共用的 `T-NNN` |
+| **部分** | ⚠️ | 有使用者指南步驟但不完整或標記模稜兩可 |
+| **未記載** | ❌ | 無任何使用者指南步驟引用此 user-facing AC |
+
+`not_implemented`（🚫）AC 排除於使用者文件分母之外，與測試覆蓋率計算一致。
+
+### 使用者文件覆蓋率計算
+
+```
+使用者文件覆蓋率 % = (已記載 + 部分 × 0.5) / (user_facing_ac_count - not_implemented_count) × 100
+
+其中：
+  user_facing_ac_count = 歸類為 user-facing 的 AC 數（套用保守預設）
+  非 user-facing AC 不計入分子也不計入分母
+  部分計為 0.5
+```
+
+> **同一把尺**：使用者指南步驟的 `T-NNN` 必須等於某個真實 journey／E2E 測試的 id（正向推演標準）。這把同一 AC 的三個投影——測試、journey、使用者指南——綁到單一主幹。自造平行 id 卻無對應測試的使用者指南步驟，一律報為**未記載**，絕不算覆蓋。
+
+---
+
 ## 品質門檻
 
 ### 預設門檻