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

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

@@ -0,0 +1,273 @@
+---
+source: ../../../../skills/commands/init.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Initialize development standards in current project
+allowed-tools: Read, Bash(uds init:*), Bash(npx:*)
+argument-hint: "[--level N | --yes]"
+---
+
+# 初始化標準
+
+> **Language**: [English](../../../../skills/commands/init.md) | 繁體中文
+
+在當前專案初始化 Universal Development Standards。
+
+## 互動模式（預設）
+
+當不帶 `--yes` 執行時，使用 AskUserQuestion 詢問用戶偏好後再執行。
+
+### 步驟 1：偵測專案
+
+首先，CLI 會自動偵測專案特性：
+- 程式語言（JavaScript、TypeScript、Python、Go 等）
+- 框架（React、Vue、Express 等）
+- AI 工具（Claude Code、Cursor、Copilot 等）
+
+### 步驟 2：詢問 AI 工具選擇
+
+使用 AskUserQuestion（多選）詢問要配置哪些 AI 工具：
+
+| AI 工具 | 整合檔案 | Skills 支援 | Commands 支援 |
+|---------|----------|-------------|---------------|
+| **Claude Code** | `CLAUDE.md` | ✅ | ❌ |
+| **Cursor** | `.cursorrules` | ✅ | ❌ |
+| **Windsurf** | `.windsurfrules` | ✅ | ❌ |
+| **Cline** | `.clinerules` | ✅ | ❌ |
+| **GitHub Copilot** | `.github/copilot-instructions.md` | ✅ | ✅ |
+| **OpenCode** | `AGENTS.md` | ✅ | ✅ |
+| **Gemini CLI** | `GEMINI.md` | ✅ | ✅ |
+| **Codex** | `AGENTS.md` | ✅ | ❌ |
+| **Antigravity** | `INSTRUCTIONS.md` | ✅ | ❌ |
+
+預選環境中偵測到的工具。注意：Codex 和 OpenCode 共用 `AGENTS.md`。
+
+### 步驟 3：詢問 Skills 安裝
+
+對於支援 Skills 的工具，根據工具數量使用**智能分組**策略。
+
+**重要：AskUserQuestion 最多只能有 4 個選項。** 使用智能分組來處理。
+
+#### 策略 A：1-2 個工具 → 合併詢問
+
+**範例（僅 Claude Code）：**
+```
+Question: "Skills 要安裝到哪裡？"
+Options:
+1. Plugin Marketplace (建議) - 自動更新，易於管理
+2. User Level (~/.claude/skills/) - 所有專案共用
+3. Project Level (.claude/skills/) - 僅此專案
+4. 跳過 - 不安裝 Skills
+```
+
+**範例（Claude Code + OpenCode）：**
+```
+Question: "Skills 要安裝到哪裡？"
+Options:
+1. Plugin Marketplace + OpenCode Project Level (建議)
+2. 全部 User Level - 所有專案共用
+3. 全部 Project Level - 僅此專案
+4. 跳過 - 不安裝 Skills
+```
+
+#### 策略 B：3+ 個工具 → 兩階段詢問
+
+**第一階段：詢問統一或個別**
+```
+Question: "您選擇了 3 個以上的 AI 工具，Skills 安裝層級要如何設定？"
+Options:
+1. 統一層級 (建議) - 所有工具使用相同層級
+2. 個別設定 - 為每個工具分別選擇層級
+3. 跳過 - 不安裝 Skills
+```
+
+**第二階段 a：如果統一 → 詢問一次層級**
+```
+Question: "所有 Skills 要安裝到哪個層級？"
+Options:
+1. User Level - 所有專案共用
+2. Project Level (建議) - 僅此專案
+```
+注意：Claude Code 預設使用 Plugin Marketplace；只有其他工具使用所選層級。
+
+**第二階段 b：如果個別 → 逐工具詢問**
+為每個工具分別詢問（參見策略 A 範例）。
+
+### 步驟 4：詢問 Commands 安裝
+
+對於支援 Commands 的工具（OpenCode、Copilot、Gemini CLI），使用**智能分組**策略。
+
+**重要：AskUserQuestion 最多只能有 4 個選項。** 使用智能分組來處理。
+
+#### 策略 A：1-2 個工具 → 合併詢問
+
+**範例（僅 OpenCode）：**
+```
+Question: "Commands 要安裝到哪裡？"
+Options:
+1. User Level (~/.config/opencode/command/) - 所有專案共用
+2. Project Level (.opencode/command/) - 僅此專案 (建議)
+3. 跳過 - 使用 Skills 即可
+```
+
+**範例（OpenCode + Copilot）：**
+```
+Question: "Commands 要安裝到哪裡？"
+Options:
+1. 全部 User Level - 所有專案共用
+2. 全部 Project Level (建議) - 僅此專案
+3. 跳過 - 使用 Skills 即可
+```
+
+#### 策略 B：3+ 個工具 → 兩階段詢問
+
+**第一階段：詢問統一或個別**
+```
+Question: "您選擇了多個支援 Commands 的 AI 工具，安裝層級要如何設定？"
+Options:
+1. 統一層級 (建議) - 所有工具使用相同層級
+2. 個別設定 - 為每個工具分別選擇層級
+3. 跳過 - 不安裝 Commands
+```
+
+**第二階段 a：如果統一 → 詢問一次層級**
+```
+Question: "所有 Commands 要安裝到哪個層級？"
+Options:
+1. User Level - 所有專案共用
+2. Project Level (建議) - 僅此專案
+```
+
+**第二階段 b：如果個別 → 逐工具詢問**
+為每個工具分別詢問（參見策略 A 範例）。
+
+### 步驟 5：詢問標準範圍
+
+使用 AskUserQuestion（僅在安裝 Skills 時顯示）：
+
+| 選項 | 說明 |
+|------|------|
+| **Lean（建議）** | 僅參考文件，Skills 提供即時任務指導 |
+| **Complete** | 安裝所有標準檔案，不依賴 Skills |
+
+### 步驟 6：詢問採用層級
+
+使用 AskUserQuestion：
+
+| 選項 | 說明 |
+|------|------|
+| **Level 1：Starter** | 6 項核心標準：commit、anti-hallucination、checkin 等 |
+| **Level 2：Professional（建議）** | 新增測試、Git 工作流程、錯誤處理 — 共 12 項 |
+| **Level 3：Complete** | 包含版本控制、日誌、SDD — 全部 16 項標準 |
+
+### 步驟 7：詢問標準格式
+
+使用 AskUserQuestion：
+
+| 選項 | 說明 |
+|------|------|
+| **AI（精簡）** | 針對 AI 消費最佳化（建議） |
+| **Human（詳細）** | 人類可讀的格式 |
+| **Both** | 產生兩種格式 |
+
+### 步驟 8：詢問標準選項
+
+根據採用層級，詢問：
+- **Git 工作流程**：github-flow、gitflow、trunk-based
+- **合併策略**：squash、merge、rebase
+- **Commit 語言**：english、traditional-chinese、bilingual
+- **測試層級**：unit-testing、integration-testing、e2e-testing
+
+### 步驟 9：詢問語言擴展
+
+如果偵測到程式語言，詢問是否納入語言特定標準：
+- C# Style Guide
+- PHP Style Guide
+- 等
+
+### 步驟 10：詢問框架擴展
+
+如果偵測到框架，詢問是否納入框架特定模式：
+- Fat-Free Patterns
+- 等
+
+### 步驟 11：詢問地區設定
+
+使用 AskUserQuestion：
+
+| 選項 | 說明 |
+|------|------|
+| **English（預設）** | 英文文件 |
+| **Traditional Chinese** | 繁體中文文件 |
+
+### 步驟 12：詢問內容模式
+
+使用 AskUserQuestion 設定整合檔案內容：
+
+| 選項 | 說明 |
+|------|------|
+| **Standard（建議）** | 摘要 + 任務對應，AI 知道何時讀取哪項標準 |
+| **Full Embed** | 嵌入所有規則，AI 可立即使用但檔案較大 |
+| **Minimal** | 僅檔案參考，適合搭配 Skills 使用 |
+
+### 步驟 13：確認並執行
+
+顯示設定摘要並在執行前確認。
+
+確認後，CLI 會一次執行所有安裝：
+- 將標準複製到 `.standards/`
+- 產生整合檔案
+- 安裝 Skills（如果已選擇）
+- 安裝 Commands（如果已選擇）
+- 建立 `manifest.json`
+
+## 快速模式
+
+使用 `--yes` 或特定選項時，跳過互動式問題：
+
+```bash
+/init --yes                    # 使用所有預設值
+/init --level 2 --yes          # 指定層級並使用預設值
+/init --skills-location none   # 不安裝 Skills
+/init --content-mode standard  # 指定內容模式
+```
+
+## 選項參考
+
+| 選項 | 說明 |
+|------|------|
+| `--yes`, `-y` | 非互動模式 |
+| `--level N` | 採用層級（1、2 或 3） |
+| `--skills-location` | marketplace、user、project 或 none |
+| `--content-mode` | standard、full 或 minimal |
+| `--format` | ai、human 或 both |
+| `-E`, `--experimental` | 啟用實驗性功能（methodology） |
+
+詳見 `uds init --help` 取得所有選項。
+
+## 採用層級
+
+| 層級 | 名稱 | 標準數量 | 說明 |
+|------|------|----------|------|
+| 1 | Starter | 6 | 核心標準（小型專案） |
+| 2 | Professional | 12 | 團隊專業品質標準 |
+| 3 | Complete | 16 | 完整的 16 項標準 |
+
+## 安裝內容
+
+- `.standards/` 目錄包含核心標準
+- 整合檔案（`CLAUDE.md`、`.cursorrules` 等）
+- Skills（透過 Plugin Marketplace 或本地安裝）
+- Commands（針對支援的 AI 工具）
+- `manifest.json` 用於追蹤安裝狀態
+
+## 參考
+
+- CLI 文件：`uds init --help`
+- 採用指南：[ADOPTION-GUIDE.md](../../adoption/ADOPTION-GUIDE.md)
+- 檢查指令：[/check](./check.md)
+- 更新指令：[/update](./update.md)

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

@@ -7,7 +7,7 @@ status: experimental
 ---
 
 ---
-description: 管理開發方法論工作流 | Manage development methodology workflow
+description: [UDS] Manage development methodology workflow
 allowed-tools: Read, Write, Glob, Grep, Bash(git:*)
 argument-hint: "[action] [argument]"
 status: experimental

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

@@ -0,0 +1,71 @@
+---
+source: ../../../../skills/commands/metrics.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Track development metrics, code quality indicators and project health"
+allowed-tools: Read, Grep, Glob, Bash(npm:*, git log:*)
+argument-hint: "[metric type or module | 指標類型或模組]"
+---
+
+# 指標儀表板助手
+
+追蹤開發指標、程式碼品質指示器與專案健康狀態。
+
+## 工作流程
+
+```
+COLLECT ──► ANALYZE ──► REPORT ──► TREND
+```
+
+## 使用方式
+
+- `/metrics` - 執行全面指標分析
+- `/metrics --quality` - 僅分析程式碼品質指標
+- `/metrics --debt` - 技術債分析
+- `/metrics --test` - 僅分析測試指標
+- `/metrics src/` - 分析指定模組
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/metrics` | 執行全面指標分析 |
+| `/metrics --quality` | 僅分析程式碼品質指標 |
+| `/metrics --debt` | 僅分析技術債 |
+| `/metrics --test` | 僅分析測試指標 |
+| `/metrics <path>` | 分析指定模組 |
+
+### Interaction Script | 互動腳本
+
+1. 偵測專案結構和可用工具
+2. 收集指標資料（git log、測試覆蓋率、程式碼複雜度）
+3. 分析趨勢和異常
+4. 生成報告
+
+🛑 **STOP**: 報告展示後等待使用者決定是否採取行動
+
+### Stop Points | 停止點
+
+| 停止點 | 等待內容 |
+|--------|---------|
+| 報告展示後 | 使用者決定後續行動 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 無法執行覆蓋率工具 | 跳過該指標，報告可用的其他指標 |
+| git 歷史不足以分析趨勢 | 僅報告當前快照，標記趨勢為 N/A |
+
+## 參考
+
+- 完整標準：[metrics-dashboard-assistant](../metrics-dashboard-assistant/SKILL.md)

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

@@ -0,0 +1,90 @@
+---
+source: ../../../../skills/commands/migrate.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide code migration, framework upgrades and technology modernization"
+allowed-tools: Read, Grep, Glob, Bash(npm:*, git:*)
+argument-hint: "[migration target or framework | 遷移目標或框架]"
+---
+
+# 遷移助手
+
+引導程式碼遷移、框架升級與技術現代化。
+
+## 工作流程
+
+```
+ASSESS ──► PLAN ──► PREPARE ──► MIGRATE ──► VERIFY ──► CLEANUP
+```
+
+## 使用方式
+
+- `/migrate` - 開始互動式遷移指南
+- `/migrate --assess` - 評估遷移範圍和風險
+- `/migrate "Vue 2 to 3"` - 遷移指定框架
+- `/migrate --deps` - 相依套件升級分析
+- `/migrate --rollback` - 回滾策略規劃
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/migrate` | 詢問遷移目標，進入 ASSESS |
+| `/migrate --assess` | 直接執行範圍和風險評估 |
+| `/migrate "target"` | 以指定目標進入 ASSESS |
+| `/migrate --deps` | 僅分析相依套件升級 |
+| `/migrate --rollback` | 規劃回滾策略 |
+
+### Interaction Script | 互動腳本
+
+#### ASSESS 階段
+1. 分析現有程式碼和相依性
+2. 評估風險矩陣（breaking changes、資料遷移、API 變更）
+3. 展示評估報告
+
+🛑 **STOP**: 評估報告後等待使用者決定是否繼續
+
+#### PLAN 階段
+1. 制定遷移計畫（分階段步驟）
+2. 定義回滾策略
+
+🛑 **STOP**: 計畫確認後等待使用者確認
+
+#### MIGRATE 階段
+1. 逐步執行遷移
+2. 每個步驟後驗證
+
+🛑 **STOP**: 每個主要步驟完成後等待確認
+
+#### VERIFY 階段
+1. 執行測試確認遷移成功
+2. 生成驗證報告
+
+### Stop Points | 停止點
+
+| 階段 | 停止點 | 等待內容 |
+|------|--------|---------|
+| ASSESS | 評估報告後 | 決定是否繼續 |
+| PLAN | 計畫制定後 | 確認計畫 |
+| MIGRATE | 每個主要步驟後 | 確認繼續 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 遷移步驟失敗 | 建議回滾到上一個檢查點 |
+| 相依性衝突 | 列出衝突，建議解決方案 |
+| 測試失敗 | 報告失敗，建議修復後重試 |
+
+## 參考
+
+- 完整標準：[migration-assistant](../migration-assistant/SKILL.md)

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

@@ -0,0 +1,78 @@
+---
+source: ../../../../skills/commands/pr.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide Pull Request creation, review automation and merge strategies"
+allowed-tools: Read, Grep, Glob, Bash(git:*, gh:*)
+argument-hint: "[branch name or PR number | 分支名稱或 PR 編號]"
+---
+
+# PR 自動化助手
+
+引導 Pull Request 建立、審查自動化和合併策略。
+
+## 工作流程
+
+```
+CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
+```
+
+## 使用方式
+
+- `/pr` - 開始互動式 PR 建立
+- `/pr create` - 從目前分支建立 PR
+- `/pr --template` - 使用 PR 模板
+- `/pr review 123` - 審查指定 PR
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/pr` | 檢查當前分支狀態，詢問建立或審查 PR |
+| `/pr create` | 分析當前分支差異，建立 PR |
+| `/pr --template` | 使用 PR 模板建立 |
+| `/pr review <number>` | 審查指定 PR |
+
+### Interaction Script | 互動腳本
+
+#### CREATE 階段
+1. 確認當前分支和目標分支
+2. 分析 commits，生成 PR title 和 description
+3. 展示 PR 內容預覽
+
+🛑 **STOP**: PR 內容確認後等待使用者確認建立
+
+#### REVIEW 階段
+1. 取得 PR 差異
+2. 執行程式碼審查（套用 `/review` 標準）
+3. 展示審查結果
+
+🛑 **STOP**: 審查結果展示後等待使用者決定
+
+### Stop Points | 停止點
+
+| 階段 | 停止點 | 等待內容 |
+|------|--------|---------|
+| CREATE | PR 內容預覽後 | 確認建立 |
+| REVIEW | 審查結果後 | 決定後續行動 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 無遠端分支 | 建議先 push |
+| PR 已存在 | 展示現有 PR，詢問是否更新 |
+| CI 檢查失敗 | 列出失敗項目，建議修復 |
+
+## 參考
+
+- 完整標準：[pr-automation-assistant](../pr-automation-assistant/SKILL.md)

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

@@ -4,7 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-21
 status: current
-description: 引導重構決策與策略選擇
+description: [UDS] Guide refactoring decisions and strategy selection
 allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
 argument-hint: "[scope: tactical | strategic | legacy | decide | debt]"
 status: stable

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

@@ -0,0 +1,63 @@
+---
+source: ../../../../skills/commands/release.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: release
+description: [UDS] Manage release process and changelogs.
+argument-hint: "[start|finish|changelog] <version>"
+---
+
+# /release 命令
+
+> **Language**: [English](../../../../skills/commands/release.md) | 繁體中文
+
+根據語義化版本管理發布流程和變更日誌。
+
+## 用法
+
+```bash
+/release [subcommand] [version]
+```
+
+### 子命令
+
+| 子命令 | 說明 |
+|--------|------|
+| `start` | 開始一個發布分支/流程 |
+| `finish` | 完成發布（標籤、合併） |
+| `changelog` | 產生或更新 CHANGELOG.md |
+| `check` | 執行預發布檢查 |
+
+## 變更日誌管理
+
+```bash
+/release changelog [version]
+```
+
+更新 `CHANGELOG.md`，流程如下：
+1.  將「Unreleased」中的變更移到新的 `[version]` 區段。
+2.  建立新的「Unreleased」區段。
+3.  更新底部的比較連結。
+
+## 範例
+
+```bash
+# 開始發布 v1.2.0
+/release start 1.2.0
+
+# 更新 v1.2.0 的變更日誌
+/release changelog 1.2.0
+
+# 完成發布
+/release finish 1.2.0
+```
+
+## 參考
+
+*   [發布標準技能](../release-standards/SKILL.md)
+*   [變更日誌指南](../changelog-guide/SKILL.md)
+*   [核心規範](../../core/versioning.md)

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

@@ -0,0 +1,61 @@
+---
+source: ../../../../skills/commands/requirement.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Write user stories and requirements following INVEST criteria
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[feature name or description | 功能名稱或描述]"
+---
+
+# 需求助手
+
+> **Language**: [English](../../../../skills/commands/requirement.md) | 繁體中文
+
+撰寫結構良好的用戶故事和需求文件，遵循 INVEST 標準。
+
+## 工作流程
+
+1. **了解背景** - 收集功能相關資訊
+2. **識別利害關係人** - 誰會從這個功能受益？
+3. **撰寫用戶故事** - 遵循標準格式
+4. **定義驗收標準** - 具體、可測試的條件
+5. **INVEST 驗證** - 檢查品質標準
+
+## 用戶故事格式
+
+```markdown
+As a [role],
+I want [feature],
+So that [benefit].
+
+### Acceptance Criteria
+
+- [ ] Given [context], when [action], then [result]
+- [ ] Given [context], when [action], then [result]
+```
+
+## INVEST 標準
+
+| 標準 | 說明 |
+|------|------|
+| **I**ndependent | 可獨立開發 |
+| **N**egotiable | 可協商細節 |
+| **V**aluable | 提供用戶價值 |
+| **E**stimable | 可估算工作量 |
+| **S**mall | 適合單一迭代 |
+| **T**estable | 有明確測試標準 |
+
+## 使用方式
+
+- `/requirement` - 互動式需求撰寫精靈
+- `/requirement user login` - 為特定功能撰寫需求
+- `/requirement "users can export data"` - 根據描述撰寫
+
+## 參考
+
+- 完整標準：[requirement-assistant](../requirement-assistant/SKILL.md)
+- 核心指南：[requirements-standards](../../core/requirement-engineering.md)