universal-dev-standards 5.0.0-rc.8 → 5.0.0

package/bundled/locales/zh-TW/skills/commands/config.md

@@ -0,0 +1,211 @@
+---
+source: ../../../../skills/commands/config.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Configure project development standards
+allowed-tools: Read, Bash(uds config:*), Bash(uds configure:*), Bash(uds check:*)
+argument-hint: "[type] [--ai-tool <tool>]"
+---
+
+# 設定標準
+
+> **Language**: [English](../../../../skills/commands/config.md) | 繁體中文
+
+配置當前專案的 Universal Development Standards 設定。
+
+---
+
+## 互動模式（預設）
+
+當不指定類型時，使用 AskUserQuestion 詢問要配置什麼。
+
+### 步驟 0：顯示目前狀態
+
+首先，執行 `uds check --summary` 顯示目前安裝狀態。
+
+```bash
+uds check --summary
+```
+
+這幫助用戶在修改前了解目前的配置。
+
+### 步驟 1：詢問配置類型
+
+使用 AskUserQuestion 提供以下選項：
+
+| 類別 | 選項 |
+|------|------|
+| **基本選項** | Format、Git Workflow、Merge Strategy、Commit Language、Test Levels |
+| **AI 工具** | 新增或移除 AI 工具整合 |
+| **Skills** | 管理 Skills 安裝（安裝/更新/重新安裝已拒絕的）|
+| **Commands** | 管理 Commands 安裝 |
+| **進階** | Adoption Level、Content Mode |
+| **全部** | 配置所有選項 |
+
+### 步驟 2：根據選擇執行
+
+**如果選擇 AI 工具：**
+```bash
+uds configure --type ai_tools
+```
+
+**如果選擇 Skills：**
+```bash
+uds configure --type skills
+```
+
+**如果選擇 Commands：**
+```bash
+uds configure --type commands
+```
+
+**如果選擇 Adoption Level：**
+```bash
+uds configure --type level
+```
+
+**如果選擇 Content Mode：**
+```bash
+uds configure --type content_mode
+```
+
+## 快速模式
+
+指定類型時，跳過互動式問題：
+
+```bash
+/config ai_tools      # 直接配置 AI 工具
+/config skills        # 直接管理 Skills
+/config commands      # 直接管理 Commands
+/config level         # 直接配置採用等級
+/config content_mode  # 直接配置內容模式
+```
+
+### 非互動式安裝
+
+使用 `--ai-tool` 選項為特定工具安裝 Skills/Commands，無需提示：
+
+```bash
+# 為特定工具安裝 Skills（專案層級，預設）
+uds configure --type skills --ai-tool opencode
+
+# 為特定工具安裝 Skills（使用者層級）
+uds configure --type skills --ai-tool opencode --skills-location user
+
+# 為特定工具安裝 Skills（專案層級，明確指定）
+uds configure --type skills --ai-tool claude-code --skills-location project
+
+# 為特定工具安裝 Commands
+uds configure --type commands --ai-tool copilot
+```
+
+**Skills 位置選項：**
+
+| 選項 | 路徑 | 說明 |
+|------|------|------|
+| `project` | `.claude/skills/`, `.opencode/skill/` | 專案特定（預設）|
+| `user` | `~/.claude/skills/`, `~/.opencode/skill/` | 跨專案共享 |
+
+## 設定類型
+
+| 類型 | 說明 |
+|------|------|
+| `ai_tools` | AI 工具整合 |
+| `skills` | Skills 安裝管理 |
+| `commands` | Commands 安裝管理 |
+| `level` | 採用等級（1/2/3）|
+| `content_mode` | 整合檔案內容模式 |
+| `format` | AI/人類文件格式 |
+| `workflow` | Git 工作流程策略 |
+| `merge_strategy` | 合併策略 |
+| `commit_language` | 提交訊息語言 |
+| `test_levels` | 測試層級 |
+| `methodology` | 開發方法論（實驗性，需要 -E）|
+| `all` | 設定所有選項 |
+
+## Skills 配置
+
+選擇 `skills` 類型時，CLI 顯示：
+
+1. **目前狀態** - 顯示每個 AI 工具已安裝的 Skills
+2. **拒絕狀態** - 顯示使用者之前拒絕 Skills 的工具
+3. **動作選單**：
+   - 安裝/更新 Skills
+   - 重新安裝已拒絕的 Skills
+   - 僅檢視狀態
+
+```
+Current Skills status:
+  ✓ Claude Code:
+    - User: v3.5.1
+  ○ OpenCode: Not installed
+  ⊘ Copilot: Previously declined
+
+? What would you like to do?
+❯ Install/Update Skills
+  Reinstall declined Skills
+  View status only
+  Cancel
+```
+
+## Commands 配置
+
+選擇 `commands` 類型時，CLI 顯示：
+
+1. **目前狀態** - 顯示每個支援工具已安裝的 Commands
+2. **拒絕狀態** - 顯示使用者之前拒絕 Commands 的工具
+3. **動作選單**與 Skills 類似
+
+支援 Commands 的工具：
+- OpenCode (`.opencode/commands/`)
+- GitHub Copilot (`.github/commands/`)
+- Gemini CLI (`.gemini/commands/`)
+- Roo Code (`.roo-code/commands/`)
+
+## 內容模式選項
+
+| 模式 | 說明 |
+|------|------|
+| `standard` | 摘要 + 任務映射，AI 知道何時讀取哪個標準（推薦）|
+| `full` | 將所有標準完整內嵌於整合檔案 |
+| `minimal` | 僅內嵌核心規則 |
+
+## 設定變更的影響
+
+| 配置 | 影響 |
+|------|------|
+| AI 工具（新增）| 產生新的整合檔案 |
+| AI 工具（移除）| 刪除整合檔案 |
+| Skills | 安裝/更新 Skills 至已配置的路徑 |
+| Commands | 安裝/更新 Commands 至已配置的路徑 |
+| Level | 更新標準，重新產生整合 |
+| Content Mode | 重新產生所有整合檔案 |
+
+## 拒絕的功能
+
+CLI 在 `manifest.declinedFeatures` 中追蹤拒絕的 Skills/Commands：
+
+- 之前拒絕的工具不會在 `/update` 提示中出現
+- 使用 `/config skills` 或 `/config commands` 重新安裝已拒絕的功能
+- 從選單中選擇「重新安裝已拒絕的 Skills/Commands」
+
+## 選項參考
+
+| 選項 | 說明 |
+|------|------|
+| `--type <type>` | 配置類型 |
+| `--ai-tool <tool>` | 特定 AI 工具（非互動式）|
+| `--skills-location <loc>` | Skills 安裝位置：project、user |
+| `--yes`, `-y` | 跳過確認提示 |
+| `-E`, `--experimental` | 啟用實驗性功能 |
+
+## 參考
+
+- CLI 文件：`uds configure --help`
+- 初始化命令：[/init](./init.md)
+- 檢查命令：[/check](./check.md)
+- 更新命令：[/update](./update.md)

package/bundled/locales/zh-TW/skills/commands/coverage.md

@@ -0,0 +1,78 @@
+---
+source: ../../../../skills/commands/coverage.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Analyze test coverage and provide recommendations
+allowed-tools: Read, Grep, Glob, Bash(npm run test:coverage:*), Bash(npx:*)
+argument-hint: "[file or module to analyze | 要分析的檔案或模組]"
+---
+
+# 測試覆蓋率助手
+
+> **Language**: [English](../../../../skills/commands/coverage.md) | 繁體中文
+
+多維度分析測試覆蓋率並提供可執行的建議。
+
+---
+
+## 覆蓋率維度
+
+| 維度 | 測量內容 |
+|------|----------|
+| **Line** | 執行的行數 |
+| **Branch** | 決策路徑 |
+| **Function** | 呼叫的函數 |
+| **Statement** | 執行的陳述式 |
+
+## 八維度框架
+
+1. **程式碼覆蓋率** - 行數、分支、函數
+2. **需求覆蓋率** - 所有需求已測試
+3. **風險覆蓋率** - 高風險區域已測試
+4. **整合覆蓋率** - 元件互動
+5. **邊界情況覆蓋率** - 邊界條件
+6. **錯誤覆蓋率** - 錯誤處理路徑
+7. **權限覆蓋率** - 存取控制場景
+8. **AI 生成品質** - AI 產生測試的有效性
+
+## 工作流程
+
+1. **執行覆蓋率工具** - 產生覆蓋率報告
+2. **分析缺口** - 找出未測試的區域
+3. **排序優先級** - 依風險和重要性排序
+4. **建議測試** - 建議應新增的具體測試
+5. **追蹤進度** - 隨時間監控覆蓋率
+
+## 覆蓋率目標
+
+| 等級 | 覆蓋率 | 適用場景 |
+|------|--------|----------|
+| 最低 | 60% | 舊有程式碼 |
+| 標準 | 80% | 大多數專案 |
+| 高 | 90% | 關鍵系統 |
+| 關鍵 | 95%+ | 安全關鍵系統 |
+
+## 使用方式
+
+- `/coverage` - 執行完整覆蓋率分析
+- `/coverage src/auth` - 分析特定模組
+- `/coverage --recommend` - 取得測試建議
+
+## AC 覆蓋率（需求層級）
+
+本命令（`/coverage`）分析**程式碼層級**覆蓋率（line/branch/function）。若需**需求層級**覆蓋率 — 追蹤哪些驗收條件（AC）有對應測試 — 請使用 [`/ac-coverage`](./ac-coverage.md)。
+
+| | `/coverage` | `/ac-coverage` |
+|-|-------------|----------------|
+| **層級** | 程式碼（line/branch/function）| 需求（AC 對測試）|
+| **問題** | 「多少程式碼被測試了？」| 「哪些 AC 有測試？」|
+
+## 參考
+
+- 完整標準：[test-coverage-assistant](../test-coverage-assistant/SKILL.md)
+- 核心指南：[testing-standards](../../core/testing-standards.md)
+- AC 覆蓋率：[/ac-coverage](./ac-coverage.md) — 需求層級追溯

package/bundled/locales/zh-TW/skills/commands/database.md

@@ -0,0 +1,76 @@
+---
+source: ../../../../skills/commands/database.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide database design, migration planning and query optimization"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[schema or migration to review | 要審查的 schema 或遷移]"
+---
+
+# 資料庫助手
+
+引導資料庫設計、遷移規劃和查詢最佳化。
+
+## 工作流程
+
+```
+PLAN ──► WRITE ──► TEST ──► DEPLOY ──► VERIFY
+```
+
+## 使用方式
+
+- `/database` - 開始互動式資料庫設計
+- `/database schema` - 審查或設計 schema
+- `/database --migration` - 規劃遷移
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/database` | 詢問任務類型（schema 設計 / 遷移規劃 / 查詢優化） |
+| `/database schema` | 進入 schema 設計/審查模式 |
+| `/database --migration` | 進入遷移規劃模式 |
+
+### Interaction Script | 互動腳本
+
+1. 確認任務類型和目標
+2. 分析現有 schema 或遷移檔案
+
+**決策：任務類型**
+- IF schema 設計 → 引導正規化、索引設計、關聯定義
+- IF 遷移規劃 → 評估風險、產生遷移腳本、規劃回滾
+- IF 查詢優化 → 分析慢查詢、建議索引
+
+3. 展示設計/計畫結果
+
+🛑 **STOP**: 結果展示後等待使用者確認
+
+🛑 **STOP**: 遷移腳本寫入前等待使用者確認
+
+### Stop Points | 停止點
+
+| 停止點 | 等待內容 |
+|--------|---------|
+| 設計/計畫展示後 | 確認方案 |
+| 遷移腳本生成後 | 確認寫入 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 無法偵測資料庫類型 | 詢問使用者（PostgreSQL/MySQL/MongoDB 等） |
+| 遷移存在資料遺失風險 | 明確警告，要求使用者確認 |
+
+## 參考
+
+- 完整標準：[database-assistant](../database-assistant/SKILL.md)
+- 核心指南：[database-standards](../../core/database-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive-all.md

@@ -0,0 +1,62 @@
+---
+source: ../../../../skills/commands/derive-all.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Derive all test structures (BDD, TDD, ATDD) from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[spec file path | 規格檔案路徑]"
+---
+
+# /derive-all — 完整正向推演
+
+> **Language**: [English](../../../../skills/commands/derive-all.md) | 繁體中文
+
+從已核准的 SDD 規格推演所有測試結構（BDD + TDD + 可選 ATDD）。
+
+---
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► /derive-bdd ──► /derive-tdd ──► [/derive-atdd] ──► Report
+```
+
+1. **解析** SDD 規格並驗證已核准
+2. **執行** `/derive-bdd` 產生 Gherkin 場景
+3. **執行** `/derive-tdd` 產生測試骨架
+4. **可選** 執行 `/derive-atdd` 產生驗收測試表格
+5. **產生** `DERIVATION-REPORT.md` 彙總所有輸出
+
+## 輸出檔案
+
+| 檔案 | 內容 |
+|------|------|
+| `features/SPEC-XXX.feature` | BDD Gherkin 場景 |
+| `tests/SPEC-XXX.test.ts` | TDD 測試骨架 |
+| `DERIVATION-REPORT.md` | 摘要與統計 |
+
+## 使用方式
+
+| 命令 | 用途 |
+|------|------|
+| `/derive-all specs/SPEC-001.md` | 從規格完整推演 |
+| `/derive-all` | 互動式 — 詢問規格檔案 |
+
+## 典型 SDD 工作流程
+
+```bash
+/sdd user-authentication          # 步驟 1：建立規格
+/sdd review specs/SPEC-001.md     # 步驟 2：審查
+/derive-all specs/SPEC-001.md     # 步驟 3：推演測試
+# 步驟 4：實作 — 填入 [TODO] 標記
+```
+
+## 參考
+
+- 父命令：[/derive](../forward-derivation/SKILL.md)
+- 核心標準：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)
+- 子命令：[/derive-bdd](./derive-bdd.md)、[/derive-tdd](./derive-tdd.md)、[/derive-atdd](./derive-atdd.md)

package/bundled/locales/zh-TW/skills/commands/derive-atdd.md

@@ -0,0 +1,58 @@
+---
+source: ../../../../skills/commands/derive-atdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Derive ATDD acceptance tests from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[spec file path | 規格檔案路徑]"
+---
+
+# /derive-atdd — 推演 ATDD 驗收測試
+
+> **Language**: [English](../../../../skills/commands/derive-atdd.md) | 繁體中文
+
+從已核准的 SDD 規格文件推演 ATDD 驗收測試表格。
+
+---
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► Parse AC ──► Generate acceptance.md ──► Review
+```
+
+1. **讀取** SDD 規格並提取驗收條件
+2. **映射** 每個 AC 為驗收測試表格（Given-When-Then 欄位）
+3. **產生** `acceptance.md`，包含測試資料和預期結果
+4. **輸出** 推演摘要
+
+## 輸出格式
+
+```markdown
+# Acceptance Tests: SPEC-001
+
+## AC-1: [Description]
+
+| # | Given | When | Then | Status |
+|---|-------|------|------|--------|
+| 1 | [precondition] | [action] | [expected] | ⬜ |
+| 2 | [precondition] | [action] | [expected] | ⬜ |
+```
+
+## 使用方式
+
+| 命令 | 用途 |
+|------|------|
+| `/derive-atdd specs/SPEC-001.md` | 從特定規格推演 ATDD |
+| `/derive-atdd` | 互動式 — 詢問規格檔案 |
+
+> **注意**：BDD 場景已可作為可執行的驗收測試。`/derive-atdd` 適用於專門的手動測試工作流程。
+
+## 參考
+
+- 父命令：[/derive](../forward-derivation/SKILL.md)
+- 核心標準：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive-bdd.md

@@ -0,0 +1,54 @@
+---
+source: ../../../../skills/commands/derive-bdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Derive BDD Gherkin scenarios from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[spec file path | 規格檔案路徑]"
+---
+
+# 推演 BDD 場景
+
+> **Language**: [English](../../../../skills/commands/derive-bdd.md) | 繁體中文
+
+從已核准的 SDD 規格文件推演 Gherkin `.feature` 檔案。
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► Parse AC ──► Generate .feature ──► Review
+```
+
+1. **讀取** SDD 規格並萃取驗收條件
+2. **對應** 每個 AC 到一個 Gherkin Scenario（1:1）
+3. **產生** `.feature` 檔案，包含 `@SPEC-XXX` 和 `@AC-N` 標籤
+4. **輸出** 推演摘要
+
+## 輸出格式
+
+```gherkin
+@SPEC-001
+Feature: [Feature Name]
+
+  @AC-1
+  Scenario: [AC-1 description]
+    Given [context]
+    When [action]
+    Then [expected result]
+```
+
+## 使用方式
+
+| 指令 | 用途 |
+|------|------|
+| `/derive-bdd specs/SPEC-001.md` | 從特定規格推演 BDD |
+| `/derive-bdd` | 互動式 — 詢問規格檔案 |
+
+## 參考
+
+- 父指令：[/derive](../forward-derivation/SKILL.md)
+- 核心規範：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive-tdd.md

@@ -0,0 +1,55 @@
+---
+source: ../../../../skills/commands/derive-tdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Derive TDD test skeletons from SDD specification
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[spec file path | 規格檔案路徑]"
+---
+
+# 推演 TDD 測試骨架
+
+> **Language**: [English](../../../../skills/commands/derive-tdd.md) | 繁體中文
+
+從已核准的 SDD 規格文件推演測試骨架檔案。
+
+## 工作流程
+
+```
+SPEC-XXX.md ──► Parse AC ──► Generate .test.ts ──► Review
+```
+
+1. **讀取** SDD 規格並萃取驗收條件
+2. **對應** 每個 AC 到一個 `describe`/`it` 區塊，使用 AAA 模式
+3. **產生** 測試檔案，包含 `[TODO]` 標記供實作填入
+4. **輸出** 推演摘要
+
+## 輸出格式
+
+```typescript
+describe('SPEC-001: [Feature Name]', () => {
+  describe('AC-1: [AC description]', () => {
+    it('should [expected behavior]', () => {
+      // Arrange — [TODO]
+      // Act — [TODO]
+      // Assert — [TODO]
+    });
+  });
+});
+```
+
+## 使用方式
+
+| 指令 | 用途 |
+|------|------|
+| `/derive-tdd specs/SPEC-001.md` | 從特定規格推演 TDD |
+| `/derive-tdd` | 互動式 — 詢問規格檔案 |
+
+## 參考
+
+- 父指令：[/derive](../forward-derivation/SKILL.md)
+- 核心規範：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive.md

@@ -0,0 +1,79 @@
+---
+source: ../../../../skills/commands/derive.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: derive
+description: [UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications.
+argument-hint: "[all|bdd|tdd|atdd] <spec-file> [--lang <lang>] [--framework <fw>] [--output-dir <dir>]"
+---
+
+# 推演測試結構
+
+> **Language**: [English](../../../../skills/commands/derive.md) | 繁體中文
+
+從已批准的 SDD 規格生成衍生工件（BDD 場景、TDD 骨架、ATDD 表格）。
+
+## 用法
+
+```bash
+/derive [subcommand] <spec-file> [options]
+```
+
+### 子命令
+
+| 子命令 | 說明 | 輸出 |
+|--------|------|------|
+| `all` | 產生 BDD + TDD（預設） | `.feature` + `.test.*` |
+| `bdd` | 僅產生 BDD 場景 | `.feature` |
+| `tdd` | 僅產生 TDD 骨架 | `.test.*` |
+| `atdd` | 產生 ATDD 測試表格 | `.md`（Markdown 表格） |
+
+### 選項
+
+| 選項 | 說明 | 預設值 |
+|------|------|--------|
+| `--lang` | 目標語言（ts、python 等） | 自動偵測或 `ts` |
+| `--framework` | 測試框架（vitest、pytest 等） | 自動偵測或 `vitest` |
+| `--output-dir` | 輸出目錄 | `./generated` |
+| `--dry-run` | 預覽輸出但不寫入 | `false` |
+
+## 工作流程
+
+1.  **讀取規格**：分析輸入的 `SPEC-XXX.md` 檔案。
+2.  **萃取 AC**：解析所有驗收條件。
+3.  **產生工件**：
+    *   **BDD**：將 AC 轉換為 Gherkin `Scenario` 格式。
+    *   **TDD**：建立測試檔案骨架，以 `describe`/`it` 區塊對應 AC。
+    *   **ATDD**：建立 Markdown 表格，包含輸入/輸出/通過-失敗欄位。
+4.  **驗證**：確保 AC 與生成項目之間為 1:1 對應。
+
+## 防幻覺
+
+*   **1:1 對應**：每個 AC 必須恰好對應一個測試/場景。
+*   **可追溯性**：所有生成的工件必須引用來源規格 ID 和 AC ID。
+*   **禁止捏造**：不得新增規格中不存在的場景。
+
+## 範例
+
+```bash
+# 推演全部（BDD + TDD）
+/derive all specs/SPEC-001.md
+
+# 僅推演 BDD 場景
+/derive bdd specs/SPEC-001.md
+
+# 推演 Python 的 TDD
+/derive tdd specs/SPEC-001.md --lang python --framework pytest
+
+# 推演 ATDD 表格供手動測試
+/derive atdd specs/SPEC-001.md
+```
+
+## 參考
+
+*   [正向推演標準](../forward-derivation/SKILL.md)
+*   [核心規範](../../core/forward-derivation-standards.md)