universal-dev-standards 5.15.1 → 5.17.0

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

@@ -3,145 +3,216 @@ name: spec-driven-dev
 source: ../../../../skills/spec-driven-dev/SKILL.md
 source_version: 1.2.0
 translation_version: 1.2.0
-last_synced: 2026-03-23
+last_synced: 2026-06-02
+source_hash: 195f50bcbfb7
 status: current
 description: "[UDS] 在撰寫程式碼前，建立、審查和管理規格文件"
 ---
+<!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
+  SDD 生命週期編排（7 階段狀態機、階段轉換、閘門檢查）已遷移至
+  採用層（adoption layer，XSPEC-095，2026-04-28）。本 Skill 保留：規格格式定義、狀態
+  描述、delta 操作、決策樹。
+  若需強制執行的生命週期，請使用你的採用層工具鏈。
+-->
 
-# 規格驅動開發助手
+# Spec-Driven Development Assistant | 規格驅動開發助手
+
+在撰寫程式碼前，建立、審查和管理規格文件。
 
 > **語言**: [English](../../../../skills/spec-driven-dev/SKILL.md) | 繁體中文
 
-在撰寫程式碼前，建立、審查和管理規格文件。
+## When to Use `/sdd` vs `uds spec` | 何時使用
+
+| 情境 | `/sdd` | `uds spec` |
+|----------|--------|------------|
+| 具審查循環的正式功能開發 | ✅ | ❌ |
+| 完整規格生命週期（Draft → Archived） | ✅ | ❌ |
+| 快速原型 / Vibe coding | ❌ | ✅ |
+| 小型漸進式變更 | ❌ | ✅ |
+| 需要利害關係人簽核 | ✅ | ❌ |
+| 從自然語言意圖產生微規格（micro-spec） | ❌ | ✅ |
 
-## 快速檢查清單
+> **`/sdd`** = 正式開發的完整規格生命週期
+> **`uds spec`** = 快速迭代的輕量微規格
+
+## TL;DR Quick Checklist | 快速檢查清單
 
 - 搜尋現有規格：查看 `specs/`、`docs/specs/` 或專案規格目錄
 - 決定範圍：新功能 vs 修改現有功能
-- 選擇唯一的規格 ID：`SPEC-NNN` 或 kebab-case 變更 ID
-- 撰寫包含明確 AC（Given/When/Then 格式）的提案
-- 實作前取得核准
-- 依序實作任務，對照規格驗證
-- 完成後歸檔規格
+- 挑選唯一的規格 ID：`SPEC-NNN` 或 kebab-case 變更 ID
+- 撰寫提案並附明確的 AC（Given/When/Then 格式）
+- 在開始實作前取得核准
+- 依序實作任務，並對照規格驗證
+- 完成後將規格歸檔
 
-## 決策樹
+## Decision Tree | 決策樹
 
 ```
-新需求？
-├─ 修復符合規格行為的 Bug？ → 直接修復
-├─ 錯字/格式/註解？ → 直接修復
-├─ 相依套件更新（不破壞相容性）？ → 直接修復
-├─ 新功能/能力？ → 建立提案
-├─ 破壞性變更？ → 建立提案
-├─ 架構變更？ → 建立提案
-└─ 不確定？ → 建立提案（較安全）
+New request? | 新需求？
+├─ Bug fix restoring spec behavior? → Fix directly | 直接修復
+├─ Typo/format/comment? → Fix directly | 直接修復
+├─ Dependency update (non-breaking)? → Fix directly | 直接修復
+├─ New feature/capability? → Create proposal | 建立提案
+├─ Breaking change? → Create proposal | 建立提案
+├─ Architecture change? → Create proposal | 建立提案
+├─ Agent/role definition (spans multiple features)? → Use spec-type: agent | 使用 Agent SPEC template
+└─ Unclear? → Create proposal (safer) | 建立提案（較安全）
 ```
 
-## 工作流程
+## Workflow | 工作流程
 
 ```
 DISCUSS ──► CREATE ──► REVIEW ──► APPROVE ──► IMPLEMENT ──► VERIFY ──► ARCHIVE
 ```
 
-### 0. Discuss - 釐清範圍
-在撰寫規格前，捕捉模糊地帶、建立治理原則、解決歧義。
+### 0. Discuss - Clarify Scope | 釐清範圍
+在撰寫規格前，捕捉灰色地帶、建立治理原則、解決模糊之處。
 
-### 1. Create - 撰寫規格
-定義需求、技術設計、驗收條件和測試計畫。
+### 1. Create - Write Spec | 撰寫規格
+定義需求、技術設計、驗收條件與測試計畫。
 
-### 2. Review - 審查驗證
-與利害關係人檢查完整性、一致性和可行性。
+### 2. Review - Validate | 審查驗證
+與利害關係人一同檢查完整性、一致性與可行性。
 
-### 3. Approve - 核准
-在實作開始前取得利害關係人簽核。
+### 3. Approve - Sign Off | 核准
+在開始實作前取得利害關係人簽核。
 
-### 4. Implement - 實作
-依據已核准的規格進行開發，參照需求和驗收條件。
+### 4. Implement - Code | 實作
+依照核准的規格進行開發，參照需求與 AC。
 
-### 5. Verify - 驗證
-確保實作符合規格，所有測試通過，驗收條件已滿足。
+### 5. Verify - Confirm | 驗證
+確保實作符合規格、所有測試通過、AC 已滿足。
 
-### 6. Archive - 歸檔
-歸檔已完成的規格，連結至 commits/PRs。
+### 6. Archive - Close | 歸檔
+將完成的規格歸檔，並附上 commit／PR 連結。
 
-## 規格狀態
+## Spec States | 規格狀態
 
-| 狀態 | 說明 | State | Description |
-|------|------|-------|-------------|
-| **Draft** | 草稿中 | Draft | Work in progress |
-| **Review** | 審查中 | Review | Under review |
-| **Approved** | 已核准 | Approved | Ready for implementation |
-| **Implemented** | 已實作 | Implemented | Code complete |
-| **Archived** | 已歸檔 | Archived | Completed or deprecated |
+| 狀態 | 說明（英） | 說明 |
+|-------|-------------|------|
+| **Draft** | Work in progress | 草稿中 |
+| **Review** | Under review | 審查中 |
+| **Approved** | Ready for implementation | 已核准 |
+| **Implemented** | Code complete | 已實作 |
+| **Archived** | Completed or deprecated | 已歸檔 |
 
-## 規格結構
+## Spec Structure | 規格結構
 
 ```markdown
 # [SPEC-ID] Feature: [Name]
 
 ## Overview
-簡短描述提案變更。
+Brief description of the proposed change.
 
 ## Motivation
-為什麼需要這個變更？解決什麼問題？
+Why is this change needed? What problem does it solve?
 
 ## Requirements
 ### Requirement: [Name]
-系統 SHALL [行為描述]。
+The system SHALL [behavior description].
 
-#### Scenario: [成功案例]
-- **GIVEN** [初始情境]
-- **WHEN** [執行動作]
-- **THEN** [預期結果]
+#### Scenario: [Success case]
+- **GIVEN** [initial context]
+- **WHEN** [action performed]
+- **THEN** [expected result]
 
 ## Acceptance Criteria
 - AC-1: Given [context], when [action], then [result]
 
 ## Technical Design
-[架構、API 變更、資料庫變更]
+[Architecture, API changes, database changes]
 
 ## Test Plan
-- [ ] [元件] 的單元測試
-- [ ] [流程] 的整合測試
+- [ ] Unit tests for [component]
+- [ ] Integration tests for [flow]
+```
+
+### Agent SPEC Structure | Agent 規格結構（`spec-type: agent`）
+
+```markdown
+# [SPEC-ID] Agent: [Role Name]
+<!-- spec-type: agent -->
+<!-- agent-id auto-referenced by feature SPECs -->
+
+## Role Definition
+- **Role**: [Agent Name]
+- **Responsibility**: [One sentence]
+- **Autonomy Level**: L[1-5] (per DEC-065)
+
+## Capability Scope
+**Owns:**
+- [Capability 1]
+- [Capability 2]
+
+**Does NOT own:**
+- [Explicit exclusion]
+
+## Interface Contract
+### Input
+| Message Type | Required Fields | Optional Fields |
+|---|---|---|
+| [Type] | [fields] | [fields] |
+
+### Output
+| Artifact Type | Success Condition | Failure Condition |
+|---|---|---|
+| [Type] | [condition] | [condition] |
+
+## Agent Interactions
+- **Upstream**: [Who calls this agent]
+- **Downstream**: [Who this agent calls]
+- **Parallel**: [Agents working alongside]
+
+## Related Feature SPECs
+- [SPEC-NNN] — [This agent's role in that spec]
 ```
 
-### 場景格式規則
+### Scenario Formatting Rules | 場景格式規則
 
-- 使用 `#### Scenario:` (h4 標題) 撰寫每個場景
-- 每個需求必須至少有一個場景
+- 每個場景使用 `#### Scenario:`（h4 標題）
+- 每個需求至少要有一個場景
 - 使用 **GIVEN/WHEN/THEN** 格式描述結構化行為
-- 使用 **SHALL/MUST** 表達強制需求，**SHOULD** 表達建議
+- 規範性需求使用 **SHALL/MUST**，建議性內容使用 **SHOULD**
 
-## 變更操作
+## Delta Operations | 變更操作
 
 修改現有規格時，使用 delta 區段：
 
-| 操作 | 說明 |
-|------|------|
-| `## ADDED Requirements` | 新增功能 |
-| `## MODIFIED Requirements` | 修改行為 |
-| `## REMOVED Requirements` | 移除功能 |
-| `## RENAMED Requirements` | 重新命名 |
+| 操作 | 說明（英） | 說明 |
+|-----------|-------------|------|
+| `## ADDED Requirements` | New capabilities | 新增功能 |
+| `## MODIFIED Requirements` | Changed behavior | 修改行為 |
+| `## REMOVED Requirements` | Deprecated features | 移除功能 |
+| `## RENAMED Requirements` | Name changes | 重新命名 |
 
-## 使用方式
+## Usage | 使用方式
 
-- `/sdd` - 互動式規格建立精靈
-- `/sdd auth-flow` - 為特定功能建立規格
-- `/sdd review` - 審查現有規格
-- `/sdd --sync-check` - 檢查同步狀態
+```
+/sdd                     - Interactive spec creation wizard | 互動式規格建立精靈
+/sdd auth-flow           - Create spec for specific feature | 為特定功能建立規格
+/sdd review              - Review existing specs | 審查現有規格
+/sdd --sync-check        - Check sync status | 檢查同步狀態
+```
 
-## 下一步引導
+## Next Steps Guidance | 下一步引導
 
 `/sdd` 完成後，AI 助手應建議：
 
-> **規格文件已建立。建議下一步：**
-> - 執行 `/derive` 從規格推導測試工件
-> - 執行 `/derive bdd` 僅推導 BDD 場景
-> - 執行 `/derive tdd` 僅推導 TDD 骨架
-> - 審查 AC 完整性，確保所有驗收條件可測試
-> - 檢查 UDS 規範覆蓋率 → 執行 `/audit --patterns`
+> **規格文件已建立。建議下一步 / Specification document created. Suggested next steps:**
+> - 執行 `/derive` 從規格推導測試工件 ⭐ **Recommended / 推薦** — Derive test artifacts from spec
+> - 執行 `/derive bdd` 僅推導 BDD 場景 — Derive BDD scenarios only
+> - 執行 `/derive tdd` 僅推導 TDD 骨架 — Derive TDD skeletons only
+> - 審查 AC 完整性，確保所有驗收條件可測試 — Review AC completeness
+> - 檢查 UDS 規範覆蓋率 → 執行 `/audit --patterns` — Check UDS standard coverage → Run `/audit --patterns`
 
-## 參考
+## Reference | 參考
 
 - 詳細指南：[guide.md](./guide.md)
-- 核心規範：[spec-driven-development.md](../../../../core/spec-driven-development.md)
+- 核心標準：[spec-driven-development.md](../../core/spec-driven-development.md)
+
+
+## AI Agent Behavior | AI 代理行為
+
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/sdd`](../commands/sdd.md#ai-agent-behavior--ai-代理行為)
+>
+> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](../commands/sdd.md#ai-agent-behavior--ai-代理行為)

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

@@ -2,7 +2,8 @@
 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: "[UDS] 測試金字塔與 UT/IT/ST/E2E 測試撰寫標準"
@@ -12,15 +13,38 @@ description: "[UDS] 測試金字塔與 UT/IT/ST/E2E 測試撰寫標準"
 
 > **語言**: [English](../../../../skills/testing-guide/SKILL.md) | 繁體中文
 
-**版本**: 1.1.0
-**最後更新**: 2025-12-29
+**版本**: 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 |
 
 ## 框架選擇
 
@@ -71,7 +95,10 @@ description: "[UDS] 測試金字塔與 UT/IT/ST/E2E 測試撰寫標準"
 ## 詳細指南
 
 完整標準請參考：
-- [測試金字塔](./testing-pyramid.md)
+- [測試標準](../../core/testing-standards.md) - 可執行的規則
+- [測試理論](./testing-theory.md) - 教學知識庫
+- [測試金字塔](./testing-pyramid.md) - 詳細的金字塔比例
+- [測試骨架範本](./test-skeleton-templates.md) - UT/IT/ST/Perf/Contract 的多語言骨架
 
 ### AI 優化格式（Token 高效）
 
@@ -85,6 +112,10 @@ description: "[UDS] 測試金字塔與 UT/IT/ST/E2E 測試撰寫標準"
   - 整合測試：`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)
 
 ## 命名慣例
 
@@ -156,15 +187,104 @@ test('method_scenario_expected', () => {
 
 ---
 
+## 測試理論精要（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 支援專案特定設定。
 
 ### 偵測順序
 
-1. 檢查 `CONTRIBUTING.md` 的「停用 Skills」區段
+1. 檢查 `CONTRIBUTING.md` 的「Disabled Skills」（停用 Skills）區段
    - 如果列出此 Skill，則為該專案停用
-2. 檢查 `CONTRIBUTING.md` 的「測試標準」區段
+2. 檢查 `CONTRIBUTING.md` 的「Testing Standards」（測試標準）區段
 3. 若未找到，**預設使用標準覆蓋率目標**
 
 ### 首次設定
@@ -207,32 +327,9 @@ test('method_scenario_expected', () => {
 
 ---
 
-## 相關標準
-
-- [測試標準](../../core/testing-standards.md)
-- [程式碼審查檢查清單](../../core/code-review-checklist.md)
-
----
+## 下一步引導 | Next Steps Guidance
 
-## 版本歷史
-
-| 版本 | 日期 | 變更內容 |
-|---------|------|---------|
-| 1.1.0 | 2025-12-29 | 新增：框架選擇（ISTQB/業界通行金字塔）、IT/SIT 縮寫說明 |
-| 1.0.0 | 2025-12-24 | 新增：標準區段（目的、相關標準、版本歷史、授權） |
-
----
-
-## 授權
-
-本 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` 完成後，AI 助理應建議：
 
 > **測試標準與最佳實踐已掌握。建議下一步 / Testing standards and best practices understood. Suggested next steps:**
 > - 執行 `/tdd` 開始測試驅動開發（紅-綠-重構循環） ⭐ **Recommended / 推薦** — 將測試知識立即轉化為實踐 / Turn testing knowledge into practice immediately
@@ -241,26 +338,26 @@ After `/testing` completes, the AI assistant should suggest:
 
 ---
 
-## 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)