universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-TW/options/testing/unit-testing.md

@@ -0,0 +1,165 @@
+---
+source: ../../../../options/testing/unit-testing.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 單元測試
+
+> **語言**: [English](../../../../options/testing/unit-testing.md) | 繁體中文
+
+**上層標準**: [測試指南](../../core/testing.md)
+
+---
+
+## 概述
+
+單元測試驗證程式碼的個別單元（函式、方法、類別）在隔離狀態下正確運作。單元測試是測試金字塔的基礎，提供快速回饋並實現安全的重構。
+
+## 特性
+
+| 屬性 | 值 |
+|------|------|
+| 範圍 | 單一函式、方法或類別 |
+| 相依性 | 模擬或替身 |
+| 執行速度 | 毫秒等級 |
+| 隔離性 | 完全隔離於外部系統 |
+| 數量 | 最多的測試 |
+
+## 適用情境
+
+- 測試純函式和業務邏輯
+- 驗證邊界案例和錯誤處理
+- 實現安全重構
+- 記錄程式碼行為
+- 快速的 CI/CD 回饋
+
+## 測試金字塔位置
+
+```
+        /\
+       /  \      E2E 測試（少）
+      /----\
+     /      \    整合測試（中）
+    /--------\
+   /          \  單元測試（多）← 這一層
+  /------------\
+```
+
+## 結構：Arrange-Act-Assert
+
+```javascript
+// JavaScript/TypeScript 範例
+describe('calculateDiscount', () => {
+  it('should apply 10% discount for orders over $100', () => {
+    // Arrange（安排）
+    const orderTotal = 150;
+    const discountThreshold = 100;
+    const discountRate = 0.10;
+
+    // Act（執行）
+    const result = calculateDiscount(orderTotal, discountThreshold, discountRate);
+
+    // Assert（驗證）
+    expect(result).toBe(15);
+  });
+});
+```
+
+## 應該測試什麼
+
+### 應該測試
+
+| 類別 | 範例 |
+|------|------|
+| 純函式 | 數學計算、字串轉換 |
+| 業務邏輯 | 驗證規則、價格計算 |
+| 邊界案例 | 空陣列、null 值、邊界條件 |
+| 錯誤條件 | 無效輸入、例外拋出 |
+| 狀態轉換 | 物件狀態變更 |
+
+### 不應該測試
+
+| 類別 | 原因 |
+|------|------|
+| 私有方法 | 透過公開介面測試 |
+| 框架程式碼 | 已被框架測試 |
+| 簡單 getter/setter | 無邏輯可驗證 |
+| 外部系統 | 使用整合測試 |
+
+## 模擬指南
+
+### 何時使用模擬
+
+```javascript
+// 模擬外部相依性
+const mockDatabase = {
+  findUser: jest.fn().mockResolvedValue({ id: 1, name: 'Test' })
+};
+
+const userService = new UserService(mockDatabase);
+```
+
+### 何時不使用模擬
+
+- 不要模擬被測試的單元
+- 不要模擬簡單的值物件
+- 不要模擬所有東西——某些真實物件是可以的
+
+## 測試命名慣例
+
+```javascript
+// 行為導向
+it('should return null when user is not found')
+// 當找不到使用者時應該回傳 null
+
+// Given-When-Then
+it('given an invalid email, when validating, then throws ValidationError')
+// 給定無效的 email，當驗證時，拋出 ValidationError
+
+// Method_Scenario_Expectation
+it('validateEmail_withInvalidFormat_throwsError')
+```
+
+## 覆蓋率指南
+
+| 指標 | 目標 | 備註 |
+|------|------|------|
+| 行覆蓋率 | 80%+ | 最低門檻 |
+| 分支覆蓋率 | 75%+ | 覆蓋條件路徑 |
+| 函式覆蓋率 | 90%+ | 所有公開函式 |
+| 關鍵路徑 | 100% | 付款、驗證、資料處理 |
+
+### 覆蓋率注意事項
+
+- 高覆蓋率 ≠ 好測試
+- 專注於有意義的測試，而非覆蓋率數字
+- 關鍵程式碼值得 100% 覆蓋
+- 不要只為了覆蓋率測試瑣碎程式碼
+
+## 常見框架
+
+| 語言 | 框架 | 備註 |
+|------|------|------|
+| JavaScript | Jest | 最受歡迎，內建模擬 |
+| JavaScript | Vitest | 快速，Vite 相容 |
+| Python | pytest | 彈性，豐富插件 |
+| Java | JUnit 5 | Java 標準 |
+| C# | xUnit | 現代、可擴展 |
+| Go | testing | 內建套件 |
+
+## 相關選項
+
+- [整合測試](./integration-testing.md) - 測試元件互動
+- [系統測試](./system-testing.md) - 測試完整系統
+- [E2E 測試](./e2e-testing.md) - 測試使用者流程
+
+---
+
+## 授權條款
+
+本文件採用 [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/INTEGRATION-GUIDE.md

@@ -0,0 +1,218 @@
+---
+source: ../../../skills/INTEGRATION-GUIDE.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 技能整合指南
+
+本指南說明如何在開發工作流程中整合使用多個技能。
+
+## 概覽
+
+通用開發標準提供 14 個 Claude Code 技能，共同支援完整的開發生命週期：
+
+```
+規劃 → 編碼 → 測試 → 審查 → 提交 → 發布
+  │      │      │      │      │      │
+  ▼      ▼      ▼      ▼      ▼      ▼
+需求   專案   測試   程式碼  提交   發布
+助手   結構   指南   審查   標準   標準
+```
+
+## 技能互動矩陣
+
+| 來源技能 → | 目標技能 | 互動方式 |
+|------------|----------|----------|
+| 需求助手 | 全部 | 需求影響所有決策 |
+| 專案結構 | 測試指南 | 測試位置遵循結構 |
+| 測試指南 | 程式碼審查 | 審查檢查測試覆蓋 |
+| 程式碼審查 | 提交標準 | 審查通過後才能提交 |
+| 提交標準 | 發布標準 | 提交決定版本號 |
+| Git 工作流程 | 全部 | 分支策略影響所有 |
+
+## 工作流程場景
+
+### 場景 1：新功能開發
+
+```mermaid
+graph LR
+    A[需求] --> B[專案結構]
+    B --> C[撰寫程式碼]
+    C --> D[測試指南]
+    D --> E[程式碼審查]
+    E --> F[提交標準]
+    F --> G[Git 工作流程]
+```
+
+**使用的技能**：
+1. **需求助手** - 釐清功能需求
+2. **專案結構** - 決定檔案位置
+3. **測試指南** - 為新功能撰寫測試
+4. **程式碼審查** - 取得程式碼審查
+5. **提交標準** - 撰寫正確的提交訊息
+6. **Git 工作流程** - 透過正確的分支策略合併
+
+### 場景 2：錯誤修正
+
+```mermaid
+graph LR
+    A[識別錯誤] --> B[撰寫測試]
+    B --> C[修正程式碼]
+    C --> D[審查]
+    D --> E[提交]
+```
+
+**使用的技能**：
+1. **測試指南** - 先撰寫失敗的測試
+2. **程式碼審查** - 快速審查修正
+3. **提交標準** - 使用 `fix:` 類型
+4. **Git 工作流程** - 建立 `fix/` 分支
+
+### 場景 3：發布準備
+
+```mermaid
+graph LR
+    A[彙整變更] --> B[更新版本]
+    B --> C[更新變更日誌]
+    C --> D[建立標籤]
+    D --> E[發布]
+```
+
+**使用的技能**：
+1. **提交標準** - 審查提交歷史
+2. **發布標準** - 決定版本升級
+3. **文件指南** - 更新變更日誌
+4. **Git 工作流程** - 標籤與發布
+
+## 技能優先順序解析
+
+當多個技能適用時，使用此優先順序：
+
+| 優先 | 類別 | 技能 |
+|------|------|------|
+| 1 | 安全 | AI 協作（防幻覺） |
+| 2 | 正確性 | 測試指南、程式碼審查 |
+| 3 | 流程 | Git 工作流程、提交標準 |
+| 4 | 文件 | 文件指南、發布標準 |
+| 5 | 指引 | 需求助手、專案結構 |
+
+## 常見技能組合
+
+### 程式碼品質組合
+
+同時使用以獲得高品質程式碼：
+- **測試指南** + **程式碼審查**
+- 確保測試存在且程式碼已審查
+
+### 發布組合
+
+同時使用以正確發布：
+- **提交標準** + **發布標準** + **Git 工作流程**
+- 確保正確的版本控制和變更日誌
+
+### 新專案組合
+
+啟動專案時同時使用：
+- **專案結構** + **文件指南** + **Git 工作流程**
+- 建立正確的基礎
+
+## 衝突解決
+
+### 測試 vs 速度
+
+**衝突**：需要快速交付但測試指南要求覆蓋率
+
+**解決方式**：
+1. 撰寫關鍵路徑測試（測試指南）
+2. 記錄技術債（文件指南）
+3. 使用適當的提交類型（提交標準）
+
+### 審查 vs 緊急
+
+**衝突**：緊急修正需要立即部署
+
+**解決方式**：
+1. 使用加速審查（程式碼審查 - 緊急流程）
+2. 建立 hotfix 分支（Git 工作流程）
+3. 記錄例外（文件指南）
+
+## 依活動觸發技能
+
+| 活動 | 主要技能 | 支援技能 |
+|------|----------|----------|
+| 啟動新專案 | 專案結構 | Git 工作流程、文件 |
+| 新增功能 | 需求助手 | 測試、程式碼審查 |
+| 修正錯誤 | 測試指南 | 程式碼審查、提交 |
+| 撰寫測試 | 測試指南 | 程式碼審查 |
+| 程式碼審查 | 程式碼審查 | 測試、AI 協作 |
+| 提交程式碼 | 提交標準 | Git 工作流程 |
+| 建立 PR | Git 工作流程 | 程式碼審查、文件 |
+| 發布 | 發布標準 | Git 工作流程、文件 |
+| 撰寫文件 | 文件指南 | - |
+
+## 最佳實踐
+
+### 1. 從需求開始
+
+在使用其他技能之前，始終從明確的需求開始：
+```
+使用者故事 → 驗收標準 → 實作 → 測試 → 審查
+```
+
+### 2. 提早測試
+
+在程式碼審查之前調用測試指南：
+```
+撰寫程式碼 → 撰寫測試 → 自我審查 → 請求審查
+```
+
+### 3. 一致的提交
+
+全程使用提交標準，而非只在最後：
+```
+每個邏輯變更 = 一個具有正確格式的提交
+```
+
+### 4. 記錄決策
+
+使用文件指南記錄重要決策：
+```
+做出決策 → 記錄在 ADR → 在程式碼中引用
+```
+
+## 快速參考
+
+### 日常開發
+
+| 任務 | 技能 |
+|------|------|
+| 開始編碼 | 專案結構 |
+| 撰寫測試 | 測試指南 |
+| 審查程式碼 | 程式碼審查 |
+| 提交變更 | 提交標準 |
+| 推送到遠端 | Git 工作流程 |
+
+### 每週/衝刺任務
+
+| 任務 | 技能 |
+|------|------|
+| 規劃功能 | 需求助手 |
+| 審查進度 | 程式碼審查 |
+| 更新文件 | 文件指南 |
+
+### 發布任務
+
+| 任務 | 技能 |
+|------|------|
+| 決定版本 | 發布標準 |
+| 更新變更日誌 | 發布標準 |
+| 建立發布 | Git 工作流程 |
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2025-12-30 | 初始整合指南 |

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

@@ -0,0 +1,132 @@
+---
+source: ../../../skills/README.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 技能 - AI 編程助手規則
+
+此目錄包含各種 AI 編程助手的技能/規則實作，皆衍生自本倉庫的核心標準。
+
+## 目錄結構
+
+```
+skills/
+├── _shared/           # 共用模板和生成工具
+├── claude-code/       # Claude Code 技能（SKILL.md 格式）
+├── cursor/            # Cursor 規則（.cursorrules、Notepads）
+├── windsurf/          # Windsurf 規則（.windsurfrules）
+├── cline/             # Cline 規則（.clinerules）
+└── copilot/           # GitHub Copilot（copilot-instructions.md）
+```
+
+## 快速開始
+
+### Claude Code
+
+**推薦：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**替代方案：手動複製（macOS / Linux）**
+```bash
+mkdir -p ~/.claude/skills
+cp -r skills/claude-code/commit-standards ~/.claude/skills/
+```
+
+**手動複製特定技能（Windows PowerShell）**
+```powershell
+Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
+```
+
+### Cursor
+
+**macOS / Linux:**
+```bash
+cp skills/cursor/.cursorrules .cursorrules
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item skills\cursor\.cursorrules .cursorrules
+```
+
+### Windsurf
+
+**macOS / Linux:**
+```bash
+cp skills/windsurf/.windsurfrules .windsurfrules
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item skills\windsurf\.windsurfrules .windsurfrules
+```
+
+### Cline
+
+**macOS / Linux:**
+```bash
+cp skills/cline/.clinerules .clinerules
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item skills\cline\.clinerules .clinerules
+```
+
+### GitHub Copilot
+
+**macOS / Linux:**
+```bash
+mkdir -p .github
+cp skills/copilot/copilot-instructions.md .github/copilot-instructions.md
+```
+
+**Windows PowerShell:**
+```powershell
+New-Item -ItemType Directory -Force -Path .github
+Copy-Item skills\copilot\copilot-instructions.md .github\copilot-instructions.md
+```
+
+## 可用技能
+
+| 技能 | 說明 | Claude Code | Cursor | Windsurf | Cline | Copilot |
+|------|------|:-----------:|:------:|:--------:|:-----:|:-------:|
+| AI 協作 | 防止幻覺 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 變更日誌指南 | 變更日誌撰寫 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 程式碼審查 | 審查檢查表 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 提交標準 | Conventional Commits | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 文件 | README 模板 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 錯誤碼指南 | 錯誤碼標準 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| Git 工作流程 | 分支策略 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 日誌指南 | 日誌最佳實踐 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 專案結構 | 目錄規範 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 發布標準 | 語意化版本 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 需求 | 使用者故事指引 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 規格驅動開發 | SDD 方法論 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 測試覆蓋率 | 覆蓋率分析 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 測試指南 | 測試最佳實踐 | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+圖例：✅ 完成 | 🚧 計劃中 | ❌ 不適用
+
+## 與核心標準的關係
+
+這些技能是核心標準的**互動式實作**：
+
+```
+core/anti-hallucination.md
+    ↓ 轉換為
+skills/claude-code/ai-collaboration-standards/SKILL.md
+skills/cursor/.cursorrules（AI 區段）
+```
+
+**重要**：使用技能或複製核心文件——同一標準**不要兩者並用**。
+
+## 貢獻
+
+請參閱 [CONTRIBUTING.md](../CONTRIBUTING.md) 了解新增技能或支援其他 AI 工具的指南。

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

@@ -0,0 +1,68 @@
+---
+source: ../../../../skills/_shared/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 共用資源
+
+用於從核心標準生成 AI 工具專用規則的共用模板和工具。
+
+## 目的
+
+此目錄包含：
+- **模板**：跨不同 AI 工具使用的通用模式
+- **工具**：生成工具專用配置的腳本
+- **對應**：每個 AI 助手的標準對規則對應
+
+## 核心標準對應
+
+| 核心標準 | 技能概念 | 說明 |
+|----------|----------|------|
+| `anti-hallucination.md` | AI 協作 | 證據導向回應、確定性標籤 |
+| `commit-message-guide.md` | 提交標準 | Conventional Commits 格式 |
+| `code-review-checklist.md` | 程式碼審查 | 審查檢查表和模式 |
+| `git-workflow.md` | Git 工作流程 | 分支策略 |
+| `testing-standards.md` | 測試指南 | 測試金字塔、覆蓋率 |
+| `versioning.md` | 發布標準 | 語意化版本 |
+| `documentation-structure.md` | 文件 | README 模板、結構 |
+
+## AI 工具相容性矩陣
+
+| 功能 | Claude Code | Cursor | Windsurf | Cline | Copilot |
+|------|-------------|--------|----------|-------|---------|
+| 技能/規則 | ✅ SKILL.md | ✅ .cursorrules | ✅ .windsurfrules | ✅ .clinerules | ✅ instructions.md |
+| 自動觸發 | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 專案層級 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 全域層級 | ✅ | ✅ | ✅ | ✅ | ❌ |
+| Notepads | ❌ | ✅ | ❌ | ❌ | ❌ |
+
+## 使用方式
+
+**macOS / Linux:**
+```bash
+# 為特定工具生成規則
+./generate.sh cursor
+
+# 為所有工具生成規則
+./generate.sh all
+```
+
+**Windows PowerShell:**
+```powershell
+# 為特定工具生成規則
+.\generate.ps1 cursor
+
+# 為所有工具生成規則
+.\generate.ps1 all
+```
+
+## 貢獻
+
+新增核心標準時：
+1. 在上方對應表新增條目
+2. 在 `templates/` 建立模板
+3. 更新生成腳本
+4. 用每個支援的 AI 工具測試