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

package/bundled/locales/zh-TW/skills/commands/dev-workflow.md

@@ -0,0 +1,120 @@
+---
+source: ../../../../skills/commands/dev-workflow.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: dev-workflow
+description: "[UDS] Guide for mapping software development phases to UDS commands and features"
+argument-hint: "[phase name | scenario | 階段名稱 | 場景]"
+---
+
+# 開發工作流程指南
+
+> **Language**: [English](../../../../skills/commands/dev-workflow.md) | 繁體中文
+
+將你目前的開發階段對應到 UDS 指令。了解在每個階段應該使用哪些工具。
+
+## 情境感知啟動
+
+當調用 `/dev-workflow` 時，AI 助手必須先檢查專案的工作流程狀態：
+
+### 步驟 1：檢查進行中的工作流程
+
+```bash
+ls .workflow-state/*.yaml .workflow-state/*.json 2>/dev/null
+```
+
+**如果有進行中的工作流程：**
+
+1. 顯示進行中的工作流程摘要（名稱、階段、進度）
+2. 建議繼續：「你有一個進行中的 **{workflow}**，目前在 **{phase}** 階段。要用 `/{command}` 繼續嗎？」
+3. 根據目前階段顯示適當的下一步指令
+
+**階段 → 下一步指令對應：**
+
+| 工作流程 | 目前階段 | 建議的下一步指令 |
+|----------|----------|------------------|
+| SDD | discuss | `/sdd create` |
+| SDD | create | `/sdd review` |
+| SDD | review | `/sdd approve` |
+| SDD | approve | `/sdd implement` |
+| SDD | implement | `/sdd verify` |
+| TDD | red | 撰寫失敗測試，然後執行測試 |
+| TDD | green | 撰寫最少程式碼使測試通過 |
+| TDD | refactor | 清理程式碼，然後 `/tdd` 進入下一輪 |
+| BDD | discovery | `/bdd` 制定場景 |
+| BDD | formulation | 撰寫 `.feature` 檔案 |
+| BDD | automation | 實作步驟定義 |
+
+**如果沒有進行中的工作流程：**
+
+繼續顯示下方的標準階段總覽。
+
+### 步驟 2：檢查活躍規格
+
+```bash
+ls docs/specs/SPEC-*.md 2>/dev/null
+```
+
+如果有活躍規格存在，標示出來並建議適當的工作流程階段。
+
+---
+
+## 用法
+
+```bash
+/dev-workflow                    # 顯示完整階段總覽
+/dev-workflow planning           # Phase I：規劃與設計
+/dev-workflow testing            # Phase II：測試驅動開發
+/dev-workflow implementation     # Phase III：實作
+/dev-workflow quality            # Phase IV：品質關卡
+/dev-workflow release            # Phase V：發布與提交
+/dev-workflow docs               # Phase VI：文件
+/dev-workflow standards          # Phase VII：工具與規範
+/dev-workflow advanced           # Phase VIII：進階分析
+/dev-workflow new-feature        # 場景：新功能工作流程
+/dev-workflow bug-fix            # 場景：修復錯誤工作流程
+/dev-workflow refactoring        # 場景：重構工作流程
+```
+
+## 快速對照表
+
+| 階段 | UDS 指令 | 用途 |
+|------|----------|------|
+| **I. 規劃** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、規格、逆向工程 |
+| **II. 測試** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先寫測試再寫程式 |
+| **III. 實作** | `/refactor` `/reverse` | 撰寫與改善程式碼 |
+| **IV. 品質** | `/checkin` `/review` | 提交前檢查與審查 |
+| **V. 發布** | `/commit` `/changelog` `/release` | 版本、提交、發布 |
+| **VI. 文件** | `/docs` `/docgen` `/struct` | 文件與專案結構 |
+| **VII. 規範** | `/discover` `/guide` | 參考指南 |
+| **VIII. 進階** | `/methodology` | 跨方法論工作流程 |
+
+## 常見場景
+
+### 新功能
+
+```
+/brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
+```
+
+### 修復錯誤
+
+```
+/discover → /reverse → /tdd → /checkin → /commit
+```
+
+### 重構
+
+```
+/discover → /reverse → /coverage → /refactor → /checkin → /commit
+```
+
+## 參考
+
+- [開發工作流程技能](../dev-workflow-guide/SKILL.md)
+- [詳細階段指南](../dev-workflow-guide/workflow-phases.md)
+- [每日工作流程指南](../../adoption/DAILY-WORKFLOW-GUIDE.md)

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

@@ -0,0 +1,87 @@
+---
+source: ../../../../skills/commands/discover.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: discover
+description: "[UDS] Assess project health, architecture, and risks before adding features"
+argument-hint: "[feature area | 功能範圍]"
+---
+
+# 專案現況評估
+
+> **Language**: [English](../../../../skills/commands/discover.md) | 繁體中文
+
+在既有程式碼庫新增功能前的 Phase 0 評估。評估專案健康度、架構與風險。
+
+## 用法
+
+```bash
+/discover [feature area]
+```
+
+## 評估維度
+
+| 維度 | 檢查項目 |
+|------|----------|
+| **架構** | 模組結構、相依圖、進入點 |
+| **相依性** | 過時套件、已知漏洞、授權風險 |
+| **測試覆蓋率** | 現有測試、覆蓋率缺口、測試品質 |
+| **安全性** | `npm audit` 結果、硬編碼密鑰、暴露端點 |
+| **技術債** | TODO 標記、程式碼重複、複雜度熱點 |
+
+## 工作流程
+
+1. **掃描專案** - 讀取 package.json、目錄結構、設定檔
+2. **分析架構** - 繪製模組、相依性和資料流
+3. **檢查相依性** - 執行 `npm outdated`、`npm audit` 取得健康信號
+4. **評估風險** - 識別複雜度熱點、缺失測試、安全問題
+5. **產生報告** - 輸出健康分數與可執行的建議
+6. **決定下一步** - 根據發現結果判定 GO / NO-GO / CONDITIONAL
+
+## 範例
+
+```bash
+/discover                # 完整專案健康評估
+/discover auth           # 聚焦評估 auth 相關模組
+/discover payments       # 在新增支付功能前評估風險
+```
+
+## 輸出格式
+
+```
+Project Health Report
+=====================
+Overall Score: 7.2 / 10
+
+| Dimension       | Score | Status  | Key Finding            |
+|-----------------|-------|---------|------------------------|
+| Architecture    | 8/10  | Good    | Clean module boundaries |
+| Dependencies    | 6/10  | Warning | 5 outdated, 1 critical |
+| Test Coverage   | 7/10  | Fair    | 72% line coverage      |
+| Security        | 8/10  | Good    | No critical vulns      |
+| Technical Debt  | 6/10  | Warning | 23 TODOs, 3 hotspots   |
+
+Verdict: CONDITIONAL
+Recommendations:
+1. [HIGH] Update lodash to fix CVE-2024-XXXX
+2. [MED]  Add tests for src/payments/ (0% coverage)
+3. [LOW]  Resolve TODO backlog in src/utils/
+```
+
+## 後續步驟
+
+完成評估後，典型的 brownfield 工作流程為：
+
+1. `/discover` - 評估專案健康度（本指令）
+2. `/reverse spec` - 逆向工程現有程式碼為規格
+3. `/sdd` - 為新功能撰寫規格
+4. `/tdd` 或 `/bdd` - 在測試保護下實作
+
+## 參考
+
+*   [專案探索技能](../project-discovery/SKILL.md)
+*   [逆向工程標準](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,68 @@
+---
+source: ../../../../skills/commands/docgen.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: docgen
+description: "[UDS] Generate usage documentation from project sources"
+argument-hint: "[config file | 設定檔]"
+---
+
+# 文件產生器
+
+> **Language**: [English](../../../../skills/commands/docgen.md) | 繁體中文
+
+從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）。
+
+## 用法
+
+```bash
+/docgen [config file]
+```
+
+## 工作流程
+
+1. **讀取設定** - 載入 `.usage-docs.yaml`（或指定的設定檔）
+2. **掃描來源** - 讀取原始檔案、指令和技能定義
+3. **萃取內容** - 從來源解析說明、選項、範例
+4. **產生文件** - 以設定的格式輸出
+5. **寫入輸出** - 將產生的檔案儲存到設定的輸出目錄
+
+## 輸出類型
+
+| 類型 | 說明 |
+|------|------|
+| **cheatsheet** | 速查表，列出命令與快捷方式 |
+| **reference** | 完整功能參考手冊含所有選項 |
+| **usage-guide** | 新手入門的逐步使用指南 |
+
+## 範例
+
+```bash
+/docgen                          # 使用預設 .usage-docs.yaml 產生文件
+/docgen .usage-docs.yaml         # 從指定設定檔產生文件
+/docgen --format cheatsheet      # 僅產生速查表
+```
+
+## 設定檔格式
+
+```yaml
+# .usage-docs.yaml
+output_dir: docs/generated/
+formats:
+  - cheatsheet
+  - reference
+sources:
+  - path: skills/commands/
+    type: commands
+  - path: cli/src/commands/
+    type: cli
+language: [en, zh-TW]
+```
+
+## 參考
+
+*   [文件產生器技能](../docs-generator/SKILL.md)

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

@@ -0,0 +1,66 @@
+---
+source: ../../../../skills/commands/docs.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: docs
+description: [UDS] Manage, guide, and generate documentation.
+argument-hint: "[generate|readme|api] [options]"
+---
+
+# /docs 命令
+
+> **Language**: [English](../../../../skills/commands/docs.md) | 繁體中文
+
+管理、撰寫和生成專案文件。
+
+## 用法
+
+```bash
+/docs [subcommand] [options]
+```
+
+### 子命令
+
+| 子命令 | 說明 |
+|--------|------|
+| `generate` | 產生文件工件（速查表、參考手冊） |
+| `readme` | 稽核並更新 README.md |
+| `api` | 從程式碼產生 API 文件 |
+| `structure` | 檢查文件目錄結構 |
+| `（無）` | 顯示文件指南/狀態 |
+
+### Generate 選項
+
+搭配 `/docs generate` 使用：
+
+| 選項 | 說明 |
+|------|------|
+| `--lang <lang>` | 語言（`en`、`zh-TW`、`zh-CN`） |
+| `--cheatsheet` | 僅產生速查表 |
+| `--reference` | 僅產生功能參考手冊 |
+| `--check` | 檢查文件是否不同步 |
+
+## 範例
+
+```bash
+# 產生所有文件
+/docs generate
+
+# 產生繁體中文文件
+/docs generate --lang zh-TW
+
+# 更新 README
+/docs readme
+
+# 檢查文件結構
+/docs structure
+```
+
+## 參考
+
+*   [文件指南技能](../documentation-guide/SKILL.md)
+*   [核心規範](../../core/documentation-writing-standards.md)

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

@@ -0,0 +1,85 @@
+---
+source: ../../../../skills/commands/durable.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide workflow failure recovery with checkpoints, retries and rollback strategies"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[workflow name or failure context | 工作流名稱或失敗情境]"
+---
+
+# 持久執行助手
+
+引導工作流程故障恢復，包含檢查點、重試與回滾策略。
+
+## 工作流程
+
+```
+DETECT ──► DIAGNOSE ──► RECOVER ──► VERIFY ──► CONTINUE
+```
+
+## 使用方式
+
+- `/durable` - 開始互動式故障恢復
+- `/durable --checkpoint` - 設計檢查點策略
+- `/durable --retry` - 設計重試策略
+- `/durable --rollback` - 規劃回滾策略
+- `/durable <workflow>` - 分析指定工作流程
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/durable` | 詢問工作流程或失敗情境，進入 DETECT |
+| `/durable --checkpoint` | 直接進入檢查點策略設計 |
+| `/durable --retry` | 直接進入重試策略設計 |
+| `/durable --rollback` | 直接進入回滾策略規劃 |
+| `/durable <workflow>` | 分析指定工作流程 |
+
+### Interaction Script | 互動腳本
+
+#### DETECT / DIAGNOSE 階段
+1. 分析工作流程結構和失敗點
+2. 識別需要持久化的狀態
+
+**決策：故障類型**
+- IF 暫時性故障（網路、超時） → 建議重試策略（exponential backoff）
+- IF 資料不一致 → 建議檢查點 + 補償交易
+- IF 不可逆失敗 → 建議回滾策略
+
+🛑 **STOP**: 診斷結果展示後等待使用者確認策略方向
+
+#### RECOVER 階段
+1. 設計選定的恢復策略
+2. 展示策略細節和程式碼建議
+
+🛑 **STOP**: 策略設計後等待使用者確認
+
+#### VERIFY 階段
+1. 建議驗證步驟確認恢復成功
+
+### Stop Points | 停止點
+
+| 階段 | 停止點 | 等待內容 |
+|------|--------|---------|
+| DIAGNOSE | 診斷結果後 | 確認策略方向 |
+| RECOVER | 策略設計後 | 確認實施 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 無法識別工作流程模式 | 詢問使用者描述工作流程步驟 |
+| 多種故障類型並存 | 逐一分析，建議組合策略 |
+
+## 參考
+
+- 完整標準：[durable-execution-assistant](../durable-execution-assistant/SKILL.md)

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

@@ -0,0 +1,51 @@
+---
+source: ../../../../skills/commands/guide.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+name: guide
+description: [UDS] Access Universal Development Standards guides and references.
+---
+
+# /guide 命令
+
+> **Language**: [English](../../../../skills/commands/guide.md) | 繁體中文
+
+`/guide` 命令是存取所有 Universal Development Standards 參考資料和指南的中央入口。
+
+## 用法
+
+```bash
+/guide [topic]
+```
+
+## 可用主題
+
+| 主題 | 說明 | 來源 |
+|------|------|------|
+| `git` | Git 工作流程與分支策略 | `skills/git-workflow-guide/` |
+| `testing` | 測試金字塔與策略 | `skills/testing-guide/` |
+| `errors` | 錯誤碼設計標準 | `skills/error-code-guide/` |
+| `logging` | 結構化日誌標準 | `skills/logging-guide/` |
+| `structure` | 專案結構慣例 | `skills/project-structure-guide/` |
+| `ai-arch` | AI 友善架構 | `skills/ai-friendly-architecture/` |
+| `ai-collab` | AI 協作與反幻覺 | `skills/ai-collaboration-standards/` |
+| `ai-instruct` | AI 指令檔案標準 | `skills/ai-instruction-standards/` |
+
+## 範例
+
+- `/guide git` - 顯示 Git 分支與命名慣例
+- `/guide testing` - 顯示測試金字塔與最佳實踐
+- `/guide structure` - 顯示建議的專案目錄結構
+- `/guide` - 列出所有可用指南
+
+## AI 實作注意事項
+
+當使用者調用 `/guide [topic]` 時：
+1.  識別請求的主題。
+2.  讀取對應的標準/技能檔案（例如 `skills/git-workflow-guide/SKILL.md`）。
+3.  向使用者摘要或呈現該檔案的關鍵資訊。
+4.  如果主題缺失或無效，列出可用的主題清單。

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

@@ -0,0 +1,90 @@
+---
+source: ../../../../skills/commands/incident.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide incident response, root cause analysis and post-mortem documentation"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[incident description or severity | 事故描述或嚴重程度]"
+---
+
+# 事故回應助手
+
+引導事故回應、根因分析和事後檢討文件撰寫。
+
+## 工作流程
+
+```
+DETECT ──► TRIAGE ──► MITIGATE ──► RESOLVE ──► POST-MORTEM
+```
+
+## 使用方式
+
+- `/incident` - 開始互動式事故回應
+- `/incident "API 500 errors"` - 回應特定事故
+- `/incident --post-mortem` - 撰寫已解決事故的事後檢討
+- `/incident --sev1` - 啟動 SEV1 回應協議
+
+## AI Agent Behavior | AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/incident` | 詢問事故描述和嚴重程度，進入 DETECT |
+| `/incident "description"` | 以描述為起點，進入 TRIAGE |
+| `/incident --post-mortem` | 直接進入 POST-MORTEM 階段 |
+| `/incident --sev1` | 啟動 SEV1 緊急回應協議 |
+
+### Interaction Script | 互動腳本
+
+#### DETECT / TRIAGE 階段
+1. 收集事故症狀和影響範圍
+2. 評估嚴重程度（SEV1-4）
+
+**決策：嚴重程度**
+- IF SEV1/SEV2 → 立即列出緊急行動清單，建議通知相關人員
+- IF SEV3/SEV4 → 按標準流程排查
+
+🛑 **STOP**: 嚴重程度評估後等待使用者確認
+
+#### MITIGATE 階段
+1. 建議即時緩解措施
+2. 追蹤緩解狀態
+
+#### RESOLVE 階段
+1. 引導根因分析（5 Whys）
+2. 建議修復方案
+
+🛑 **STOP**: 修復方案確認後等待使用者確認實施
+
+#### POST-MORTEM 階段
+1. 收集時間線、根因、影響
+2. 生成事後檢討文件
+
+🛑 **STOP**: 文件生成後等待使用者確認寫入
+
+### Stop Points | 停止點
+
+| 階段 | 停止點 | 等待內容 |
+|------|--------|---------|
+| TRIAGE | 嚴重程度評估後 | 確認分級 |
+| RESOLVE | 修復方案提出後 | 確認實施 |
+| POST-MORTEM | 文件生成後 | 確認寫入 |
+
+### Error Handling | 錯誤處理
+
+| 錯誤條件 | AI 動作 |
+|----------|---------|
+| 無法判斷嚴重程度 | 列出分級標準，請使用者選擇 |
+| 缺乏足夠症狀資訊 | 引導收集更多資訊（日誌、監控、錯誤訊息） |
+
+## 參考
+
+- 完整標準：[incident-response-assistant](../incident-response-assistant/SKILL.md)