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

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

@@ -0,0 +1,54 @@
+---
+source: ../../../../skills/commands/reverse-bdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Transform SDD acceptance criteria to BDD scenarios
+allowed-tools: Read, Grep, Glob, Write
+argument-hint: "[spec file or source directory | 規格檔案或原始碼目錄]"
+---
+
+# /reverse-bdd — 擷取 BDD 場景
+
+> **Language**: [English](../../../../skills/commands/reverse-bdd.md) | 繁體中文
+
+將現有程式碼或 SDD 驗收條件轉換為 BDD Gherkin 場景。
+
+## 工作流程
+
+```
+Source/Spec ──► Analyze Behaviors ──► Generate .feature ──► Review
+```
+
+1. **分析**原始碼或規格中的行為模式
+2. **擷取**隱含的 Given-When-Then 流程
+3. **產生** Gherkin `.feature` 檔案
+4. **標記**確定性標籤：`[Confirmed]`、`[Inferred]`
+
+## 輸出格式
+
+```gherkin
+# [Source: src/auth/login.js:45]
+Feature: User Login [Inferred]
+
+  # [Confirmed] from test/auth.test.js:12
+  Scenario: Successful login
+    Given a registered user exists
+    When they submit valid credentials
+    Then they receive an auth token
+```
+
+## 使用方式
+
+| 指令 | 用途 |
+|------|------|
+| `/reverse-bdd src/auth/` | 從 auth 模組擷取 BDD |
+| `/reverse-bdd specs/SPEC-001.md` | 將規格 AC 轉為 BDD |
+
+## 參考
+
+- 上層指令：[/reverse](../reverse-engineer/SKILL.md)
+- 核心規範：[reverse-engineering-standards.md](../../core/reverse-engineering-standards.md)

package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md

@@ -0,0 +1,58 @@
+---
+source: ../../../../skills/commands/reverse-sdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Reverse engineer code into SDD specification document
+allowed-tools: Read, Grep, Glob, Write
+argument-hint: "[source file or directory | 原始檔案或目錄]"
+---
+
+# /reverse-sdd — 反向工程為 SDD 規格
+
+> **Language**: [English](../../../../skills/commands/reverse-sdd.md) | 繁體中文
+
+將現有程式碼反向工程為結構化的 SDD 規格文件。
+
+## 工作流程
+
+```
+Source Code ──► Analyze ──► Extract Requirements ──► Generate SPEC-XXX.md
+```
+
+1. **掃描**原始碼結構和相依性
+2. **擷取**隱含的需求、API 合約、商業邏輯
+3. **分類**每項發現的確定性：`[Confirmed]`、`[Inferred]`、`[Assumption]`
+4. **產生**符合 SDD 規範的規格文件
+5. **審查**產生的規格以確認準確性
+
+## 輸出格式
+
+```markdown
+# [SPEC-XXX] Feature: [Reverse-Engineered Name]
+
+## Overview
+[Inferred] Based on analysis of src/auth/...
+
+## Requirements
+- REQ-001: [Confirmed] User authentication via OAuth2
+- REQ-002: [Inferred] Session timeout after 30 minutes
+
+## Acceptance Criteria
+- AC-1: [Confirmed] Given valid credentials, when login, then session created
+```
+
+## 使用方式
+
+| 指令 | 用途 |
+|------|------|
+| `/reverse-sdd src/auth/` | 反向工程 auth 模組 |
+| `/reverse-sdd` | 互動式 — 詢問目標 |
+
+## 參考
+
+- 上層指令：[/reverse](../reverse-engineer/SKILL.md)
+- 核心規範：[reverse-engineering-standards.md](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,58 @@
+---
+source: ../../../../skills/commands/reverse-tdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Analyze BDD-TDD coverage gaps
+allowed-tools: Read, Grep, Glob, Write
+argument-hint: "[feature file or test directory | Feature 檔案或測試目錄]"
+---
+
+# /reverse-tdd — 分析 BDD-TDD 覆蓋差距
+
+> **Language**: [English](../../../../skills/commands/reverse-tdd.md) | 繁體中文
+
+分析 BDD 場景與 TDD 測試覆蓋之間的差距。
+
+## 工作流程
+
+```
+.feature + tests/ ──► Map Scenarios ──► Find Gaps ──► Report
+```
+
+1. **解析**現有 `.feature` 檔案中的場景
+2. **掃描**測試檔案中對應的單元測試
+3. **對應** BDD 場景與 TDD 測試覆蓋
+4. **識別**覆蓋差距（沒有單元測試的場景）
+5. **產生**差距報告並附帶建議
+
+## 輸出格式
+
+```markdown
+# BDD-TDD Coverage Gap Analysis
+
+## Coverage Summary
+- Total BDD Scenarios: 12
+- Covered by TDD: 9 (75%)
+- Gaps Found: 3
+
+## Gaps
+| Scenario | Feature File | Missing TDD |
+|----------|-------------|-------------|
+| Password reset | auth.feature:15 | No unit test for token validation |
+```
+
+## 使用方式
+
+| 指令 | 用途 |
+|------|------|
+| `/reverse-tdd features/` | 分析所有 feature 檔案 |
+| `/reverse-tdd features/auth.feature` | 分析特定 feature |
+
+## 參考
+
+- 上層指令：[/reverse](../reverse-engineer/SKILL.md)
+- 核心規範：[reverse-engineering-standards.md](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,70 @@
+---
+source: ../../../../skills/commands/reverse.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: reverse
+description: [UDS] Reverse engineer code to Specs, BDD, or TDD coverage.
+argument-hint: "[spec|bdd|tdd] <input> [--output <file>]"
+---
+
+# 反向工程
+
+> **Language**: [English](../../../../skills/commands/reverse.md) | 繁體中文
+
+將現有程式碼或測試反向工程為規格和場景。
+
+## 用法
+
+```bash
+/reverse [subcommand] <input> [options]
+```
+
+### 子命令
+
+| 子命令 | 輸入 | 輸出 | 說明 |
+|--------|------|------|------|
+| `spec` | 程式碼檔案/目錄 | `SPEC-XXX.md` | 從程式碼建立 SDD 規格 |
+| `bdd` | `SPEC-XXX.md` | `.feature` | 將規格 AC 轉為 Gherkin |
+| `tdd` | `.feature` | 覆蓋報告 | 分析 feature 的 TDD 覆蓋率 |
+
+### 選項
+
+| 選項 | 說明 |
+|------|------|
+| `--output` | 輸出檔案路徑 |
+| `--include-tests` | 在分析中包含測試檔案（用於 `spec`）|
+| `--review` | 產生後觸發審查 |
+
+## 工作流程
+
+### 1. Code to Spec（舊版程式碼復原）
+```bash
+/reverse spec src/auth/ --output specs/SPEC-AUTH.md
+```
+分析程式碼邏輯以建立功能規格。
+
+### 2. Spec to BDD（場景產生）
+```bash
+/reverse bdd specs/SPEC-AUTH.md --output features/auth.feature
+```
+將規格中的驗收標準轉換為 Gherkin 場景。
+
+### 3. BDD to TDD（覆蓋分析）
+```bash
+/reverse tdd features/auth.feature
+```
+檢查 feature 檔案中的場景是否有對應的單元測試。
+
+## 防幻覺
+
+*   **確定性標記**：在輸出中使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 標記。
+*   **來源標註**：為所有反向推導的邏輯標註 `file:line`。
+
+## 參考
+
+*   [反向工程技能](../reverse-engineer/SKILL.md)
+*   [核心規範](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,57 @@
+---
+source: ../../../../skills/commands/review.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Perform systematic code review with checklist
+allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*)
+argument-hint: "[file path or branch | 檔案路徑或分支名稱]"
+---
+
+# 程式碼審查助手
+
+> **Language**: [English](../../../../skills/commands/review.md) | 繁體中文
+
+執行系統性的程式碼審查，使用標準化的檢查清單和評論前綴。
+
+## 工作流程
+
+1. **識別變更** - 取得要審查的檔案 diff
+2. **套用檢查清單** - 系統性地檢查每個類別
+3. **產生報告** - 使用標準前綴輸出發現
+4. **總結** - 提供整體評估
+
+## 審查類別
+
+1. **功能性** - 是否正確運作？
+2. **設計** - 架構是否適當？
+3. **品質** - 程式碼是否乾淨且可維護？
+4. **可讀性** - 是否容易理解？
+5. **測試** - 測試覆蓋率是否足夠？
+6. **安全性** - 是否有弱點？
+7. **效能** - 是否有效率？
+8. **錯誤處理** - 錯誤是否有正確處理？
+
+## 評論前綴
+
+| 前綴 | 意義 | 動作 |
+|------|------|------|
+| **BLOCKING** | 合併前必須修復 | 必要 |
+| **IMPORTANT** | 應該修復 | 建議 |
+| **SUGGESTION** | 錦上添花 | 可選 |
+| **QUESTION** | 需要釐清 | 討論 |
+| **NOTE** | 資訊性質 | 供參考 |
+
+## 使用方式
+
+- `/review` - 審查目前分支的所有變更
+- `/review src/auth.js` - 審查特定檔案
+- `/review feature/login` - 審查特定分支
+
+## 參考
+
+- 完整標準：[code-review-assistant](../code-review-assistant/SKILL.md)
+- 核心指南：[code-review-checklist](../../core/code-review-checklist.md)

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

@@ -0,0 +1,74 @@
+---
+source: ../../../../skills/commands/scan.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide automated security scanning, dependency auditing and secret detection"
+allowed-tools: Read, Grep, Glob, Bash(npm:audit, npx:*)
+argument-hint: "[scan type or target | 掃描類型或目標]"
+---
+
+# 安全掃描助手
+
+引導自動化安全掃描、相依套件審計和機密偵測。
+
+## 工作流程
+
+```
+SCAN ──► TRIAGE ──► PRIORITIZE ──► FIX ──► VERIFY
+```
+
+## 使用方式
+
+- `/scan` - 執行所有安全掃描
+- `/scan --deps` - 相依套件漏洞掃描
+- `/scan --secrets` - 機密偵測掃描
+- `/scan --license` - 授權合規檢查
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/scan` | 執行所有掃描類型 |
+| `/scan --deps` | 僅執行相依套件漏洞掃描 |
+| `/scan --secrets` | 僅執行機密偵測 |
+| `/scan --license` | 僅執行授權合規檢查 |
+
+### Interaction Script | 互動腳本
+
+1. 執行指定類型的掃描
+2. 收集結果，依嚴重程度分類
+3. 展示分類報告
+
+**決策：掃描結果**
+- IF 發現 Critical/High → 列出 SLA 修復時限，建議立即處理
+- IF 僅 Medium/Low → 列入報告，建議排程處理
+- IF 發現機密洩漏 → 立即警告，建議輪換金鑰
+
+🛑 **STOP**: 報告展示後等待使用者決定修復優先順序
+
+### Stop Points | 停止點
+
+| 停止點 | 等待內容 |
+|--------|---------|
+| 掃描報告展示後 | 使用者決定修復項目 |
+| 修復建議展示後 | 確認套用修復 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 掃描工具未安裝 | 建議安裝（npm audit 通常內建） |
+| 無 package.json 或 lock 檔 | 告知無法執行相依掃描 |
+
+## 參考
+
+- 完整標準：[security-scan-assistant](../security-scan-assistant/SKILL.md)

package/bundled/locales/zh-TW/skills/commands/sdd-retro.md

@@ -0,0 +1,47 @@
+---
+source: ../../../../skills/commands/sdd-retro.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Create retroactive specs for untracked feat/fix commits
+allowed-tools: Read, Write, Grep, Glob, Bash(git log:*), Bash(git show:*), Bash(git diff:*), Bash(mkdir:*)
+argument-hint: "[--since=<date> | --last=<N> | 自動掃描]"
+---
+
+# 追溯 Spec 產生器
+
+> **Language**: [English](../../../../skills/commands/sdd-retro.md) | 繁體中文
+
+為過去未追蹤 spec 的已提交變更，建立輕量規格文件。
+
+## 工作流程
+
+1. **掃描** — 搜尋 `git log` 中訊息不含 `Refs:` 的 `feat`/`fix` commits
+2. **分組** — 依 scope 將相關 commits 聚類
+3. **產生** — 使用標準 SDD 格式建立追溯規格，`Status: Draft`
+4. **確認** — 在寫入 `docs/specs/` 前呈現給使用者審查
+
+## 選項
+
+| 選項 | 說明 |
+|------|------|
+| `--since=2026-01-01` | 僅掃描指定日期後的 commits |
+| `--last=20` | 僅掃描最近 N 筆 commits |
+| （無引數） | 掃描所有 feat/fix commits |
+
+## 使用方式
+
+```
+/sdd-retro              # 掃描所有未追蹤的 commits
+/sdd-retro --since=2026-01-01
+/sdd-retro --last=10
+```
+
+## 參考
+
+- SDD 工作流程：[sdd 指令](sdd.md)
+- Commit 規範：[commit 指令](commit.md)
+- 規格：[SPEC-011](../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md)