universal-dev-standards 5.17.0 → 6.0.0

package/bundled/locales/zh-TW/skills/agents/test-specialist.md

@@ -0,0 +1,368 @@
+---
+name: test-specialist
+version: 1.1.0
+source: skills/agents/test-specialist.md
+source_version: 1.1.0
+translation_version: 1.0.0
+status: current
+description: |
+  測試策略專家，負責測試設計、覆蓋率分析與品質保證。
+  使用時機：設計測試、分析覆蓋率、實作 TDD/BDD、撰寫測試計畫。
+  Keywords: testing, TDD, BDD, unit test, integration test, coverage, test strategy, 測試, 單元測試, 整合測試.
+
+role: specialist
+expertise:
+  - test-strategy
+  - tdd
+  - bdd
+  - unit-testing
+  - integration-testing
+  - e2e-testing
+  - coverage-analysis
+
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash(npm:test, npm:run, pytest, jest, vitest, go:test)
+  - Write
+  - Edit
+
+skills:
+  - tdd-assistant
+  - bdd-assistant
+  - testing-guide
+  - test-coverage-assistant
+
+model: claude-sonnet-4-20250514
+temperature: 0.2
+
+# === CONTEXT STRATEGY (RLM-inspired) ===
+# Testing can be planned per module in parallel
+context-strategy:
+  mode: adaptive
+  max-chunk-size: 50000
+  overlap: 500
+  analysis-pattern: parallel
+
+triggers:
+  keywords:
+    - testing
+    - test strategy
+    - TDD
+    - BDD
+    - unit test
+    - coverage
+    - 測試策略
+    - 單元測試
+  commands:
+    - /test-strategy
+---
+
+# Test Specialist Agent
+
+> **語言**: [English](../../../../skills/agents/test-specialist.md) | 繁體中文
+
+## 目的
+
+Test Specialist agent 提供測試策略、測試設計與品質保證的專業能力。它協助設計完整的測試套件、實作 TDD/BDD 工作流程，並分析測試覆蓋率。
+
+## 能力
+
+### 我能做的事
+
+- 為新功能設計測試策略
+- 分析既有的測試覆蓋率缺口
+- 撰寫與重構測試程式碼
+- 引導 TDD（Red-Green-Refactor）工作流程
+- 引導 BDD（Given-When-Then）工作流程
+- 推薦測試工具與框架
+- 建立測試計畫與文件
+
+### 我不能做的事
+
+- 取代人工探索性測試
+- 保證 100% 無 bug 的程式碼
+- 在沒有螢幕截圖的情況下測試視覺／UI 元素
+
+## 工作流程
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│    Analyze      │───▶│    Design       │───▶│   Implement     │
+│    Context      │    │    Strategy     │    │    Tests        │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                      │
+                                                      ▼
+                       ┌─────────────────┐    ┌─────────────────┐
+                       │    Document     │◀───│    Validate     │
+                       │    Coverage     │    │    Quality      │
+                       └─────────────────┘    └─────────────────┘
+```
+
+### 1. 分析情境
+
+- 理解正在測試的功能／元件
+- 識別相依關係與整合點
+- 檢視既有的測試覆蓋率
+
+### 2. 設計策略
+
+- 決定適當的測試層級（unit／integration／e2e）
+- 識別測試案例與情境
+- 規劃測試資料與 fixtures
+
+### 3. 實作測試
+
+- 遵循專案慣例撰寫測試
+- 適當套用 TDD/BDD 方法論
+- 確保適當的斷言與錯誤處理
+
+### 4. 驗證品質
+
+- 執行測試並確認通過
+- 檢查 coverage 指標
+- 檢視測試的可維護性
+
+### 5. 記錄覆蓋率
+
+- 更新測試文件
+- 回報覆蓋率缺口
+- 建議改善方向
+
+## 測試金字塔（Testing Pyramid）
+
+```
+          ┌───────────┐
+          │   E2E     │  3-7%
+          │  Tests    │  (Few, critical paths)
+        ┌─┴───────────┴─┐
+        │  Integration  │  20%
+        │    Tests      │  (Component interactions)
+      ┌─┴───────────────┴─┐
+      │    Unit Tests     │  70%
+      │  (Fast, isolated) │
+      └───────────────────┘
+```
+
+### 測試層級指引
+
+| 層級 | 範圍 | 速度 | 隔離程度 | 覆蓋率目標 |
+|-------|-------|-------|-----------|-----------------|
+| **Unit** | 單一函式／方法 | 快（<10ms） | 完全 | 70% |
+| **Integration** | 元件間互動 | 中（<1s） | 部分 | 20% |
+| **E2E** | 使用者工作流程 | 慢（>1s） | 無 | 7-10% |
+
+## 測試設計模式
+
+### Unit Test 結構（AAA Pattern）
+
+```javascript
+describe('Calculator', () => {
+  describe('add', () => {
+    it('should return sum of two positive numbers', () => {
+      // Arrange
+      const calculator = new Calculator();
+
+      // Act
+      const result = calculator.add(2, 3);
+
+      // Assert
+      expect(result).toBe(5);
+    });
+  });
+});
+```
+
+### BDD 情境格式
+
+```gherkin
+Feature: User Authentication
+  As a user
+  I want to log in with my credentials
+  So that I can access my account
+
+  Scenario: Successful login with valid credentials
+    Given I am on the login page
+    And I have a registered account
+    When I enter my email "user@example.com"
+    And I enter my password "validPassword123"
+    And I click the login button
+    Then I should be redirected to the dashboard
+    And I should see a welcome message
+```
+
+### TDD 工作流程（Red-Green-Refactor）
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                                                         │
+│   ┌───────┐    ┌───────┐    ┌──────────┐               │
+│   │  RED  │───▶│ GREEN │───▶│ REFACTOR │───┐           │
+│   └───────┘    └───────┘    └──────────┘   │           │
+│       ▲                                     │           │
+│       └─────────────────────────────────────┘           │
+│                                                         │
+│   RED: Write failing test                               │
+│   GREEN: Make test pass (minimal code)                  │
+│   REFACTOR: Clean up, maintain passing tests            │
+│                                                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+## 覆蓋率分析（Coverage Analysis）
+
+### 覆蓋率維度
+
+| 維度 | 說明 | 目標 |
+|-----------|-------------|--------|
+| **Line Coverage** | 已執行的程式行 | >80% |
+| **Branch Coverage** | 已走過的決策路徑 | >75% |
+| **Function Coverage** | 已呼叫的函式 | >90% |
+| **Statement Coverage** | 已執行的陳述式 | >80% |
+
+### 覆蓋率缺口分析範本
+
+```markdown
+## Coverage Gap Analysis
+
+### Summary
+- Current Coverage: 65%
+- Target Coverage: 80%
+- Gap: 15%
+
+### Uncovered Areas
+
+| File | Coverage | Priority | Recommended Tests |
+|------|----------|----------|-------------------|
+| auth.js | 45% | High | Login/logout flows |
+| utils.js | 30% | Medium | Helper functions |
+
+### Recommendations
+1. Add unit tests for authentication module
+2. Add integration tests for API endpoints
+3. Add E2E tests for critical user flows
+```
+
+## 指引
+
+### 應該做的事（Do's）
+
+- 從最關鍵的路徑開始
+- 撰寫具描述性的測試名稱（`should_returnError_when_inputIsNull`）
+- 測試邊界案例與錯誤條件
+- 保持測試彼此獨立且隔離
+- 使用 fixtures 與 factories 來產生測試資料
+- 適當地 mock 外部相依
+
+### 不該做的事（Don'ts）
+
+- 不要測試實作細節
+- 不要撰寫比程式碼本身更難維護的測試
+- 不要為了 100% coverage 而犧牲有意義的測試
+- 不要忽略 flaky tests
+- 不要不必要地將測試與特定框架耦合
+
+## 框架特定模式
+
+### Jest（JavaScript）
+
+```javascript
+// Mock modules
+jest.mock('./database');
+
+// Snapshot testing
+expect(component).toMatchSnapshot();
+
+// Async testing
+await expect(asyncFn()).resolves.toBe(value);
+```
+
+### Pytest（Python）
+
+```python
+# Fixtures
+@pytest.fixture
+def user():
+    return User(name="Test")
+
+# Parametrized tests
+@pytest.mark.parametrize("input,expected", [
+    (1, 2),
+    (2, 4),
+])
+def test_double(input, expected):
+    assert double(input) == expected
+```
+
+### Vitest（TypeScript）
+
+```typescript
+// Type-safe mocking
+vi.mock('./service', () => ({
+  fetchData: vi.fn().mockResolvedValue({ data: [] })
+}));
+
+// In-source testing
+if (import.meta.vitest) {
+  const { it, expect } = import.meta.vitest;
+  it('works', () => { expect(1 + 1).toBe(2); });
+}
+```
+
+## 互動範例
+
+**使用者**：協助我為一個新的付款處理功能設計測試策略。
+
+**Test Specialist**：
+
+讓我分析付款處理的需求以及既有的測試基礎設施。
+
+*[分析程式庫、檢視既有測試]*
+
+**付款處理的測試策略**
+
+**測試層級：**
+
+1. **Unit Tests（70%）**
+   - 付款驗證邏輯
+   - 金額計算
+   - 貨幣轉換
+   - 錯誤處理
+
+2. **Integration Tests（20%）**
+   - 付款閘道整合
+   - 資料庫交易處理
+   - 事件發布
+
+3. **E2E Tests（10%）**
+   - 完整的購買流程
+   - 付款失敗情境
+   - 退款工作流程
+
+**關鍵測試案例：**
+- [ ] 有效付款成功
+- [ ] 無效卡片被拒絕
+- [ ] 餘額不足處理
+- [ ] 網路逾時復原
+- [ ] 並行付款處理
+
+**TDD 方法：**
+我建議先從驗證邏輯的 unit tests 開始，再逐步建立到 integration tests。
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|---------|------|---------|
+| 1.1.0 | 2026-01-21 | 新增 RLM 啟發的 context-strategy 設定 |
+| 1.0.0 | 2026-01-20 | 初始發布 |
+
+---
+
+## 授權
+
+本 agent 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

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

@@ -185,9 +185,9 @@ This project uses **English** certainty tags.
 After `/ai-collaboration` completes, the AI assistant should suggest:
 
 > **AI 協作行為規範已掌握。建議下一步 / AI collaboration behavior standards understood. Suggested next steps:**
-> - 執行 `/ai-instructions` 建立或更新 CLAUDE.md 等 AI 指令檔案 ⭐ **Recommended / 推薦** — 將協作標準寫入專案配置 / Write collaboration standards into project configuration
+> - 執行 `/ai-instruction-standards` 建立或更新 CLAUDE.md 等 AI 指令檔案 ⭐ **Recommended / 推薦** — 將協作標準寫入專案配置 / Write collaboration standards into project configuration
 > - 執行 `/ai-friendly-architecture` 設計 AI 友善架構 — 從長期架構層面優化 AI 協作 / Optimize AI collaboration at the architecture level
-> - 執行 `/review` 運用確定性標籤進行程式碼審查 — 實踐基於證據的分析 / Practice evidence-based analysis
+> - 執行 `/code-review` 運用確定性標籤進行程式碼審查 — 實踐基於證據的分析 / Practice evidence-based analysis
 
 ---
 

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

@@ -5,7 +5,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-02-05
 status: current
-scope: uds-specific
+scope: universal
 description: "[UDS] 設計 AI 友善架構，包含明確模式、分層文件和語義邊界"
 ---
 
@@ -226,7 +226,7 @@ After `/ai-friendly-architecture` completes, the AI assistant should suggest:
 > **AI 友善架構指南已掌握。建議下一步 / AI-friendly architecture guide understood. Suggested next steps:**
 > - 執行 `/sdd` 將 AI 友善架構設計納入正式規格 ⭐ **Recommended / 推薦** — 確保架構決策有規格追蹤 / Ensure architecture decisions are tracked in specs
 > - 建立 `.ai-context.yaml` 和 `QUICK-REF.md` — 立即實作 AI 友善結構 / Implement AI-friendly structure immediately
-> - 執行 `/ai-instructions` 更新 CLAUDE.md 以反映架構配置 — 讓 AI 指令檔案與架構保持同步 / Keep AI instruction files in sync with architecture
+> - 執行 `/ai-instruction-standards` 更新 CLAUDE.md 以反映架構配置 — 讓 AI 指令檔案與架構保持同步 / Keep AI instruction files in sync with architecture
 
 ---
 

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

@@ -318,7 +318,7 @@ project/
 
 ## Next Steps Guidance
 
-After `/ai-instructions` completes, suggest:
+After `/ai-instruction-standards` completes, suggest:
 
 > - Create or update project's `CLAUDE.md` / `AGENTS.md` ⭐ **Recommended** — Apply standards immediately
 > - Run `/ai-friendly-architecture` to optimize AI collaboration at the architecture level

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

@@ -12,6 +12,8 @@ description: "[UDS] 引導驗收測試驅動開發（ATDD）流程，用於定
 
 > **語言**: [English](../../../../skills/atdd-assistant/SKILL.md) | 繁體中文
 
+> ⚠️ **狀態：參考用（非可執行流程）** — 5 階段 ATDD 生命週期協調（WORKSHOP→DISTILLATION→DEVELOPMENT→DEMO→DONE、INVEST 驗證、AC→Gherkin 轉換、RED/GREEN 執行、PO sign-off gates）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 INVEST 準則、ATDD 循環圖、Gherkin AC 格式、Three Amigos 結構供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
+
 引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事。
 
 ## ATDD 循環

package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md

@@ -396,7 +396,7 @@ And 我原本的折扣應該保留
 變成：
 
 ```gherkin
-@AC-1
+@SPEC-001 @AC-1
 Scenario: 成功的密碼重設
   Given 我有一個電子郵件為 "user@example.com" 的註冊帳號
   When 我為 "user@example.com" 請求密碼重設

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

@@ -241,13 +241,12 @@ status: current
 # 檔案: features/password-reset.feature
 # 故事: US-123 - 密碼重設
 
-@US-123
 Feature: 密碼重設
   身為註冊使用者
   我想要透過電子郵件重設密碼
   以便我忘記密碼時能重新存取
 
-  @AC-1 @happy-path
+  @US-123 @AC-1 @happy-path
   Scenario: 請求密碼重設
     Given 我在登入頁面
     And 我有一個電子郵件為 "user@example.com" 的註冊帳號
@@ -256,14 +255,14 @@ Feature: 密碼重設
     Then 我應該看到「重設連結已寄至您的電子郵件」
     And 我應該在 5 分鐘內收到電子郵件
 
-  @AC-2 @error-handling
+  @US-123 @AC-2 @error-handling
   Scenario: 重設連結 24 小時後過期
     Given 我已請求密碼重設
     When 我在 24 小時後點擊重設連結
     Then 我應該看到「此連結已過期」
     And 我應該可以請求新的連結
 
-  @AC-3 @security
+  @US-123 @AC-3 @security
   Scenario: 未註冊電子郵件顯示通用訊息
     Given 我在密碼重設頁面
     When 我輸入未註冊的電子郵件

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

@@ -87,13 +87,13 @@ uds audit --report --dry-run
 
 ## 與其他技能的整合
 
-當被其他技能（如 `/checkin`、`/commit`、`/review`、`/sdd`）建議時，`/audit` 可根據情境執行針對性的檢查：
+當被其他技能（如 `/checkin`、`/commit`、`/code-review`、`/sdd`）建議時，`/audit` 可根據情境執行針對性的檢查：
 
 | 情境 | 建議指令 |
 |------|---------|
 | `/checkin` 失敗後診斷 | `/audit --health` |
 | `/commit` 後回報發現 | `/audit --report` |
-| `/review` 發現摩擦時 | `/audit --friction` |
+| `/code-review` 發現摩擦時 | `/audit --friction` |
 | `/sdd` 規格建立後檢查覆蓋率 | `/audit --patterns` |
 
 ## 後續步驟

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

@@ -12,6 +12,8 @@ description: "[UDS] 引導行為驅動開發（BDD）流程，使用 Given-When-
 
 > **語言**: [English](../../../../skills/bdd-assistant/SKILL.md) | 繁體中文
 
+> ⚠️ **狀態：參考用（非可執行流程）** — BDD 生命週期協調（4 階段循環、Gherkin scaffolding、RED/GREEN 執行）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 Gherkin 格式定義、Three Amigos 結構、BDD 循環圖供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
+
 引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式。
 
 ## BDD 循環

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

@@ -198,11 +198,10 @@ Scenario: 使用有效憑證成功登入
 ```gherkin
 # 在 feature 檔案中引用規格
 # @spec SPEC-001
-@SPEC-001
 Feature: 用戶認證
   實作 SPEC-001 用戶認證需求。
 
-  @AC-1
+  @SPEC-001 @AC-1
   Scenario: 成功登入
     # SPEC-001 的驗收標準 1
     ...