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

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

@@ -0,0 +1,67 @@
+---
+source: ../../../../skills/commands/changelog.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: changelog
+description: "[UDS] Generate and maintain CHANGELOG.md entries"
+---
+
+# 變更日誌助手
+
+> **Language**: [English](../../../../skills/commands/changelog.md) | 繁體中文
+
+根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。
+
+---
+
+## 用法
+
+```bash
+/changelog
+```
+
+## 工作流程
+
+1. **分析 git log** - 使用 `git log` 讀取自上次發布以來的提交歷史
+2. **分類變更** - 將提交映射到變更日誌分類
+3. **產生條目** - 為每個變更撰寫面向使用者的描述
+4. **更新 CHANGELOG.md** - 將條目插入 [Unreleased] 或版本化區段
+
+## 變更分類
+
+| 分類 | 使用時機 | 對應 Commit 類型 |
+|------|---------|-----------------|
+| **Added** | 新功能 | `feat` |
+| **Changed** | 修改既有功能 | `perf`, `BREAKING CHANGE` |
+| **Deprecated** | 即將移除的功能 | -- |
+| **Removed** | 已移除的功能 | `BREAKING CHANGE` |
+| **Fixed** | 錯誤修復 | `fix` |
+| **Security** | 安全性修補 | `security` |
+
+## 條目格式
+
+```markdown
+## [Unreleased]
+
+### Added
+- Add user dashboard with customizable widgets (#123)
+
+### Fixed
+- Fix memory leak when processing large files (#456)
+```
+
+### 撰寫指南
+
+- 為**使用者**而非開發者撰寫
+- 聚焦**影響**而非實作
+- 附上 issue/PR 編號
+- 用 **BREAKING** 標記破壞性變更
+
+## 參考
+
+*   [Changelog Guide Skill](../changelog-guide/SKILL.md)
+*   [Core Standard](../../core/changelog-standards.md)

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

@@ -0,0 +1,223 @@
+---
+source: ../../../../skills/commands/check.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Verify standards adoption status
+allowed-tools: Read, Bash(uds check:*), Bash(npx:*), Bash(ls:*)
+argument-hint: "[--offline | --restore | --summary]"
+---
+
+# 檢查標準
+
+> **Language**: [English](../../../../skills/commands/check.md) | 繁體中文
+
+驗證當前專案的 Universal Development Standards 採用狀態。
+
+---
+
+## 快速開始
+
+```bash
+# 基本檢查（問題時進入互動模式）
+uds check
+
+# 精簡摘要以快速瀏覽狀態
+uds check --summary
+
+# 不使用網路進行檢查
+uds check --offline
+
+# 還原遺失或被修改的檔案
+uds check --restore
+```
+
+## 輸出模式
+
+### 摘要模式 (--summary)
+
+顯示精簡狀態供快速瀏覽：
+
+```
+UDS Status Summary
+──────────────────────────────────────────────────
+  Version: 3.5.1-beta.16 → 3.5.1-beta.18 ⚠
+  Level: 2 - Professional (專業)
+  Files: 12 ✓
+  Skills: Claude Code ✓ | OpenCode ○
+  Commands: OpenCode ✓
+──────────────────────────────────────────────────
+```
+
+### 完整模式（預設）
+
+顯示詳細資訊，包括：
+- 採用狀態（等級、版本、安裝日期）
+- 檔案完整性（未變更/已修改/遺失數量）
+- Skills 完整性（如果 manifest 中有追蹤）
+- Commands 完整性（如果 manifest 中有追蹤）
+- 整合區塊完整性
+- 參考同步狀態
+- AI 工具整合檔案覆蓋率
+- 覆蓋率報告
+
+## 互動模式
+
+當偵測到問題（修改/遺失檔案）時，CLI 自動進入互動模式：
+
+```
+──────────────────────────────────────────────────
+⚠ Modified: .standards/commit-message.ai.yaml
+
+? What would you like to do?
+❯ View diff
+  Restore original
+  Keep current (update hash)
+  Skip
+```
+
+**可用動作：**
+
+| 動作 | 說明 |
+|------|------|
+| **View diff** | 顯示當前與原始版本之間的差異 |
+| **Restore original** | 以上游版本取代 |
+| **Keep current** | 接受修改並更新 hash |
+| **Skip** | 對此檔案不做任何操作 |
+
+遺失檔案的動作：
+
+| 動作 | 說明 |
+|------|------|
+| **Restore** | 從上游下載並還原 |
+| **Remove from tracking** | 從 manifest 中移除 |
+| **Skip** | 對此檔案不做任何操作 |
+
+## 選項
+
+| 選項 | 說明 |
+|------|------|
+| `--summary` | 顯示精簡狀態摘要 |
+| `--offline` | 跳過 npm registry 檢查 |
+| `--diff` | 顯示修改檔案的差異 |
+| `--restore` | 還原所有修改和遺失的檔案 |
+| `--restore-missing` | 僅還原遺失的檔案 |
+| `--migrate` | 遷移舊版 manifest 至 hash 追蹤 |
+
+## 輸出區段
+
+### 採用狀態
+
+- 採用等級（1-3）
+- 安裝日期
+- 已安裝版本
+- 更新可用性
+
+### 檔案完整性
+
+顯示每個追蹤檔案的狀態：
+
+| 符號 | 意義 |
+|------|------|
+| ✓（綠色）| 未變更 |
+| ⚠（黃色）| 已修改 |
+| ✗（紅色）| 遺失 |
+| ?（灰色）| 存在但無 hash |
+
+摘要格式：`{unchanged} 未變更、{modified} 已修改、{missing} 遺失`
+
+### Skills 完整性（v3.3.0+）
+
+如果 manifest 中存在 `skillHashes`，則檢查：
+- 檔案是否存在於預期路徑
+- hash 比對以檢測修改
+
+### Commands 完整性（v3.3.0+）
+
+如果 manifest 中存在 `commandHashes`，則檢查：
+- 檔案是否存在於預期路徑
+- hash 比對以檢測修改
+
+### 整合區塊完整性（v3.3.0+）
+
+如果 manifest 中存在 `integrationBlockHashes`，則檢查：
+- UDS 標記區塊是否存在
+- 區塊內容 hash（使用者在區塊外的自訂修改會被保留）
+
+### Skills 狀態
+
+顯示每個已配置 AI 工具的安裝狀態：
+
+```
+Skills Status
+  Claude Code:
+    ✓ Skills installed:
+      - User level: ~/.claude/skills/
+        Version: 3.5.1
+    ✓ Commands: 7 installed
+      Path: .opencode/commands/
+```
+
+狀態指示器：
+- ✓ installed（綠色）- Skills/Commands 已安裝
+- ○ not installed（灰色）- 未安裝
+
+### 覆蓋率摘要
+
+顯示標準覆蓋率：
+- 當前等級所需的標準
+- 由 Skills 涵蓋的標準
+- 由參考文件涵蓋的標準
+
+## 狀態指示
+
+| 符號 | 意義 |
+|------|------|
+| ✓（綠色）| 一切正常 |
+| ⚠（黃色）| 警告，建議採取行動 |
+| ✗（紅色）| 錯誤，需要採取行動 |
+| ○（灰色）| 未安裝/配置 |
+
+## 常見問題
+
+**「Standards not initialized」**
+- 執行 `/init` 初始化標準
+
+**「Update available」**
+- 執行 `/update` 取得最新版本
+
+**「Missing files」**
+- 執行 `/check --restore` 或 `/update` 還原
+
+**「Modified files detected」**
+- 執行 `/check --diff` 查看變更
+- 執行 `/check --restore` 重置為原始版本
+- 或使用互動模式逐一處理
+
+**「Skills not installed」**
+- 執行 `/update` 安裝缺少的 Skills
+- 或執行 `/config skills` 管理 Skills
+
+**「Legacy manifest detected」**
+- 執行 `uds check --migrate` 升級至 hash 追蹤
+
+## 使用方式
+
+```bash
+/check                  # 完整檢查並啟用互動模式
+/check --summary        # 快速狀態概覽
+/check --offline        # 不使用網路進行檢查
+/check --restore        # 還原修改/遺失的檔案
+/check --diff           # 顯示檔案差異
+/check --migrate        # 升級 manifest 格式
+```
+
+## 參考
+
+- CLI 文件：`uds check --help`
+- 初始化命令：[/init](./init.md)
+- 更新命令：[/update](./update.md)
+- 配置命令：[/config](./config.md)

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

@@ -0,0 +1,65 @@
+---
+source: ../../../../skills/commands/checkin.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: checkin
+description: "[UDS] Pre-commit quality gates verification"
+---
+
+# 簽入助手
+
+> **Language**: [English](../../../../skills/commands/checkin.md) | 繁體中文
+
+在提交程式碼前驗證品質關卡，確保程式碼庫的穩定性。
+
+---
+
+## 用法
+
+```bash
+/checkin
+```
+
+## 工作流程
+
+1. **檢查 git 狀態** - 執行 `git status` 和 `git diff` 了解待處理的變更
+2. **執行測試** - 執行 `npm test`（或專案測試指令）驗證所有測試通過
+3. **執行程式碼檢查** - 執行 `npm run lint` 檢查程式碼風格合規
+4. **驗證品質關卡** - 對照以下檢查清單逐項確認
+5. **報告結果** - 呈現通過/失敗摘要並建議後續步驟
+
+## 品質關卡
+
+| 關卡 | 檢查項目 |
+|------|---------|
+| **Build** | 編譯零錯誤 |
+| **Tests** | 所有測試通過（100%）|
+| **Coverage** | 覆蓋率未下降 |
+| **AC Coverage** | AC 覆蓋率 ≥ 80%（[`/ac-coverage`](./ac-coverage.md)）|
+| **Code Quality** | 符合編碼規範，無 code smell |
+| **Security** | 無硬編碼密鑰或漏洞 |
+| **Documentation** | 如有需要，API 文件和 CHANGELOG 已更新 |
+| **Workflow** | 分支命名和 commit message 格式正確 |
+
+## 禁止提交的情況
+
+- 建置有錯誤
+- 測試失敗
+- 功能不完整會破壞現有功能
+- 包含除錯程式碼（console.log、print）
+- 包含被註解的程式碼區塊
+
+## 後續步驟
+
+驗證通過後，使用 `/commit` 建立 commit message。
+
+## 參考
+
+*   [Check-in Assistant Skill](../checkin-assistant/SKILL.md)
+*   [Core Standard](../../core/checkin-standards.md)
+*   [AC Coverage 命令](./ac-coverage.md) — AC 對測試的追溯分析
+*   [AC 追溯標準](../../core/acceptance-criteria-traceability.md)

package/bundled/locales/zh-TW/skills/commands/ci-cd.md

@@ -0,0 +1,75 @@
+---
+source: ../../../../skills/commands/ci-cd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide CI/CD pipeline design, configuration and optimization"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[pipeline config or stage | Pipeline 配置或階段]"
+---
+
+# CI/CD 助手
+
+引導 CI/CD 管線設計、配置和優化。
+
+## 工作流程
+
+```
+BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
+```
+
+## 使用方式
+
+- `/ci-cd` - 開始互動式管線設計
+- `/ci-cd github-actions` - 為指定平台設計
+- `/ci-cd --optimize` - 優化現有管線
+- `/ci-cd build` - 聚焦建置階段
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/ci-cd` | 偵測現有 CI 配置（`.github/workflows/`、`.gitlab-ci.yml` 等），展示狀態或開始設計 |
+| `/ci-cd <platform>` | 為指定平台設計管線 |
+| `/ci-cd --optimize` | 分析現有管線，提出優化建議 |
+| `/ci-cd <stage>` | 聚焦特定階段（build/test/deploy） |
+
+### Interaction Script | 互動腳本
+
+1. 偵測專案技術棧和現有 CI 配置
+2. 依據需求設計或優化管線
+
+**決策：現有配置**
+- IF 已有 CI 配置 → 分析現狀，建議優化
+- IF 無 CI 配置 → 引導從頭設計
+- IF `--optimize` → 直接進入優化分析
+
+3. 逐階段設計（BUILD→TEST→ANALYZE→DEPLOY→VERIFY）
+4. 展示完整管線配置
+
+🛑 **STOP**: 配置展示後等待使用者確認寫入
+
+### Stop Points | 停止點
+
+| 停止點 | 等待內容 |
+|--------|---------|
+| 管線設計完成後 | 確認配置正確並寫入 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 無法偵測 CI 平台 | 列出支援的平台供選擇 |
+| 現有配置語法錯誤 | 報告錯誤位置，建議修正 |
+
+## 參考
+
+- 完整標準：[ci-cd-assistant](../ci-cd-assistant/SKILL.md)

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

@@ -0,0 +1,85 @@
+---
+source: ../../../../skills/commands/commit.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Generate commit messages following Conventional Commits standard
+allowed-tools: Read, Grep, Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git add:*), Bash(git commit:*)
+argument-hint: "[description of changes | 變更描述]"
+---
+
+# Commit Message 助手
+
+> **Language**: [English](../../../../skills/commands/commit.md) | 繁體中文
+
+根據 staged 的變更，產生符合 Conventional Commits 格式的 commit message。
+
+---
+
+## 前置檢查
+
+在產生 commit 前，AI 助手必須執行以下檢查：
+
+| 檢查 | 指令 | 失敗時 |
+|------|------|--------|
+| 有 staged 變更 | `git diff --cached --stat` | → 引導使用者 `git add` |
+| 無合併衝突 | `grep -r "<<<<<<< " --include="*.{js,ts,md,yaml}" .` | → 先解決衝突 |
+| 測試通過（feat/fix）| `cd cli && npm run test:unit`（或專案測試指令）| → 先修復測試 |
+| Spec 引用（feat/fix）| 檢查 `docs/specs/SPEC-*.md` 是否有活躍規格 | → 建議在 footer 加 `Refs: SPEC-XXX` |
+
+### Spec 追蹤閘門
+
+對於 `feat` 和 `fix` 類型的提交：
+1. **檢查**：`ls docs/specs/SPEC-*.md 2>/dev/null` — 是否有活躍的規格？
+2. **如果有規格**：建議在 commit footer 加入 `Refs: SPEC-XXX`
+3. **如果沒有規格且變更顯著**（>3 個檔案或新 API）：建議透過 `/sdd` 建立規格
+4. **模式**：這是建議性的（非阻斷）— 使用者可以不引用規格
+
+---
+
+## 工作流程
+
+1. **檢查狀態** - 執行 `git status` 和 `git diff --staged` 了解變更
+2. **分析變更** - 判斷類型（feat、fix、refactor 等）和範圍
+3. **Spec 追蹤評估** - 評估此變更是否需要規格（見下方）
+4. **產生訊息** - 按照以下格式建立 commit message：
+   ```
+   <type>(<scope>): <subject>
+
+   <body>
+
+   <footer>
+   ```
+5. **確認並提交** - 在執行 `git commit` 前請使用者確認
+
+## Spec 追蹤評估
+
+對於 `feat`/`fix` 類型的提交，評估是否應建立或連結規格。當以下情況時建議建立規格：變更檔案多（>3）、修改公開 API 簽名、或有顯著的新功能。`docs`/`style`/`chore`/`test` 類型可跳過。
+
+如果有連結規格，在 commit footer 加入 `Refs: SPEC-XXX`。這是建議性的 — 使用者可以忽略。
+
+## 提交類型
+
+| 類型 | 使用時機 |
+|------|---------|
+| `feat` | 新功能 |
+| `fix` | 修復錯誤 |
+| `refactor` | 重構 |
+| `docs` | 文件更新 |
+| `style` | 格式調整 |
+| `test` | 測試相關 |
+| `perf` | 效能優化 |
+| `chore` | 維護任務 |
+
+## 使用方式
+
+- `/commit` - 自動分析變更並建議 commit message
+- `/commit fix login bug` - 根據提供的描述產生訊息
+
+## 參考
+
+- 完整標準：[commit-standards](../commit-standards/SKILL.md)
+- 核心指南：[commit-message-guide](../../core/commit-message-guide.md)