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

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

@@ -0,0 +1,326 @@
+---
+source: ../../../../skills/commands/update.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-19
+---
+
+---
+description: [UDS] Update development standards to latest version
+allowed-tools: Read, Bash(uds update:*), Bash(uds check:*), Bash(uds configure:*), Bash(npx:*), Bash(cat .standards/*), Bash(ls .claude/*), Bash(ls .opencode/*), Bash(ls .github/*)
+argument-hint: "[--yes] [--offline] [--beta]"
+---
+
+# 更新標準
+
+> **Language**: [English](../../../../skills/commands/update.md) | 繁體中文
+
+將 Universal Development Standards 更新至最新版本。
+
+## 互動模式（預設）
+
+當不帶 `--yes` 執行時，使用 AskUserQuestion 確認更新偏好。
+
+### 步驟 1：檢查目前狀態
+
+首先，執行 `uds check --summary` 顯示精簡安裝狀態。
+
+```bash
+uds check --summary
+```
+
+顯示：版本（含更新指示器）、等級、檔案狀態、Skills 狀態和 Commands 狀態。
+
+### 步驟 2：詢問更新偏好
+
+如果有可用更新，根據版本類型顯示對應選項。
+
+#### Pre-release 版本類型
+
+Pre-release 版本按穩定度排序（由低到高）：
+
+| 類型 | 穩定度 | 說明 |
+|------|--------|------|
+| alpha | 🔴 早期 | 功能可能不完整，供內部測試 |
+| beta | 🟡 測試中 | 功能大致完成，可能有 bug，供早期採用者 |
+| rc | 🟢 接近穩定 | 候選發布版，接近正式版，供 beta 測試者 |
+
+版本比較：`alpha < beta < rc < stable`
+
+詳細版本規範請參見 [core/versioning.md](../../core/versioning.md)。
+
+#### 更新選項
+
+**如果有穩定版本可用（例如 3.5.1）：**
+
+| 選項 | 說明 |
+|------|------|
+| **立即更新** | 更新標準至最新穩定版本 X.Y.Z（建議） |
+| **檢查 Beta** | 檢查 beta 版本更新 |
+| **跳過** | 暫不更新 |
+
+**如果僅有 pre-release 版本可用，顯示特定類型：**
+
+從 `uds check` 輸出偵測版本類型並顯示特定類型名稱：
+
+| 偵測到的類型 | 選項標籤 | 說明 |
+|-------------|---------|------|
+| `X.Y.Z-alpha.N` | **更新至 Alpha** | 更新至 alpha 版本 X.Y.Z-alpha.N（🔴 早期測試） |
+| `X.Y.Z-beta.N` | **更新至 Beta** | 更新至 beta 版本 X.Y.Z-beta.N（🟡 功能大致完成） |
+| `X.Y.Z-rc.N` | **更新至 RC** | 更新至 RC 版本 X.Y.Z-rc.N（🟢 接近穩定） |
+
+一律包含**跳過**選項：暫不更新。
+
+**Beta 版本的 AskUserQuestion 範例：**
+- 問題："有新的 beta 版本可用：3.5.1-beta.3 → 3.5.1-beta.15。您想如何處理？"
+- 選項 1："更新至 Beta (建議)" - "更新標準至 3.5.1-beta.15 版本（🟡 功能大致完成）"
+- 選項 2："暫時跳過" - "目前不進行更新，維持現有版本"
+
+### 步驟 3：執行更新
+
+**如果選擇立即更新：**
+```bash
+uds update --yes
+```
+
+**如果選擇檢查 Beta：**
+```bash
+uds update --beta --yes
+```
+
+### 步驟 4：檢查 Skills/Commands 狀態
+
+更新完成後，使用多階段 AskUserQuestion 檢查缺少或過時的 Skills/Commands。
+
+**重要：** 由於 AskUserQuestion 選項有限（最多 4 個），使用多階段方式處理不同 AI 工具和安裝偏好。
+
+#### 步驟 4a：偵測缺少的 Skills
+
+首先讀取 manifest 來識別已配置的 AI 工具及其 Skills 狀態：
+
+```bash
+# 讀取 manifest 取得已配置的 AI 工具
+cat .standards/manifest.json
+# 檢查現有的 Skills 安裝
+ls .claude/skills/ 2>/dev/null || echo "Not installed"
+ls .opencode/skill/ 2>/dev/null || echo "Not installed"
+```
+
+針對每個支援 Skills 的已配置 AI 工具，檢查 Skills 是否已安裝。
+
+#### 步驟 4b/4c：詢問 Skills 安裝（整合）
+
+如果有已配置的 AI 工具缺少 Skills，使用**智能分組**策略。
+
+**重要：AskUserQuestion 最多只能有 4 個選項。** 使用智能分組來處理。
+
+**步驟 4b-1：檢查 Marketplace 狀態（僅 Claude Code）**
+
+首先檢查 Plugin Marketplace 是否已安裝：
+```bash
+ls ~/.claude/plugins/universal-dev-standards@asia-ostrich 2>/dev/null && echo "Marketplace installed"
+```
+
+- 如果 Marketplace 已安裝 → 顯示 "Claude Code: ✓ 已透過 Marketplace 安裝" 並跳過 Claude Code 選項
+- 如果 Marketplace 未安裝 → 包含 Marketplace 選項
+
+**步驟 4b-2：套用智能分組策略**
+
+#### 策略 A：1-2 個工具 → 合併詢問
+
+**範例（僅 Claude Code，Marketplace 未安裝）：**
+```
+問題："Skills 要安裝到哪裡？"
+選項：
+1. Plugin Marketplace (建議) - 自動更新，易於管理
+2. User Level (~/.claude/skills/) - 所有專案共用
+3. Project Level (.claude/skills/) - 僅此專案
+4. 跳過 - 不安裝 Skills
+```
+
+**範例（OpenCode + Copilot，Claude Code 已透過 Marketplace 安裝）：**
+```
+問題："Skills 要安裝到哪裡？（Claude Code: ✓ 已透過 Marketplace 安裝）"
+選項：
+1. 全部 User Level - 所有專案共用
+2. 全部 Project Level (建議) - 僅此專案
+3. 跳過 - 不安裝額外 Skills
+```
+
+#### 策略 B：3+ 個工具 → 兩階段詢問
+
+**第一階段：詢問統一或個別**
+```
+問題："有多個 AI 工具需要安裝 Skills，安裝層級要如何設定？"
+選項：
+1. 統一層級 (建議) - 所有工具使用相同層級
+2. 個別設定 - 為每個工具分別選擇層級
+3. 跳過 - 不安裝 Skills
+```
+
+**第二階段 a：若統一 → 詢問層級一次**
+```
+問題："所有 Skills 要安裝到哪個層級？"
+選項：
+1. User Level - 所有專案共用
+2. Project Level (建議) - 僅此專案
+```
+
+**第二階段 b：若個別 → 逐工具詢問**
+
+**執行安裝：**
+```bash
+uds configure --type skills --ai-tool opencode --skills-location project
+uds configure --type skills --ai-tool cursor --skills-location user
+```
+
+**注意：** 如果用戶選擇統一層級，使用 `--skills-location` 選項。如果選擇個別設定，不帶此選項執行以觸發互動提示。
+
+#### 步驟 4d：偵測缺少的 Commands
+
+檢查已配置但尚未安裝 Commands 的 AI 工具：
+
+```bash
+# 檢查現有的 Commands 安裝
+ls .opencode/commands/ 2>/dev/null || echo "Not installed"
+ls .github/commands/ 2>/dev/null || echo "Not installed"
+```
+
+**注意：** 並非所有 AI 工具都支援 Commands。支援 Commands 的工具：
+- OpenCode (.opencode/commands/)
+- GitHub Copilot (.github/commands/)
+- Roo Code (.roo/commands/)
+- Gemini CLI (.gemini/commands/)
+
+#### 步驟 4e：詢問 Commands 安裝
+
+如果有已配置的 AI 工具缺少 Commands，使用**智能分組**策略。
+
+**重要：AskUserQuestion 最多只能有 4 個選項。** 使用智能分組來處理。
+
+#### 策略 A：1-2 個工具 → 合併詢問
+
+**範例（僅 OpenCode）：**
+```
+問題："Commands 要安裝到哪裡？"
+選項：
+1. User Level (~/.config/opencode/command/) - 所有專案共用
+2. Project Level (.opencode/command/) - 僅此專案 (建議)
+3. 跳過 - 使用 Skills 即可
+```
+
+**範例（OpenCode + Copilot）：**
+```
+問題："Commands 要安裝到哪裡？"
+選項：
+1. 全部 User Level - 所有專案共用
+2. 全部 Project Level (建議) - 僅此專案
+3. 跳過 - 使用 Skills 即可
+```
+
+#### 策略 B：3+ 個工具 → 兩階段詢問
+
+**第一階段：詢問統一或個別**
+```
+問題："有多個 AI 工具需要安裝 Commands，安裝層級要如何設定？"
+選項：
+1. 統一層級 (建議) - 所有工具使用相同層級
+2. 個別設定 - 為每個工具分別選擇層級
+3. 跳過 - 不安裝 Commands
+```
+
+**第二階段 a：若統一 → 詢問層級一次**
+```
+問題："所有 Commands 要安裝到哪個層級？"
+選項：
+1. User Level - 所有專案共用
+2. Project Level (建議) - 僅此專案
+```
+
+**第二階段 b：若個別 → 逐工具詢問**
+
+**執行安裝：**
+```bash
+# CLI 會互動詢問安裝層級
+uds configure --type commands --ai-tool opencode
+uds configure --type commands --ai-tool copilot
+```
+
+**注意：** 指定 `--ai-tool` 時，CLI 會互動詢問安裝層級（project 或 user）。
+
+#### 拒絕功能處理
+
+**重要：** CLI 會在 `manifest.declinedFeatures` 中追蹤用戶拒絕的選項。
+
+- 用戶之前拒絕的工具不會在後續提示中顯示
+- 可透過 `/config skills` 或 `/config commands` 重新安裝
+- 拒絕是按工具記錄的（例如拒絕 OpenCode 的 Skills 不影響 Claude Code）
+
+### 步驟 5：說明結果
+
+所有操作完成後，說明：
+1. 已更新的內容（標準版本、檔案數量）
+2. Skills/Commands 安裝結果
+3. 遇到的任何錯誤
+4. 後續步驟（若安裝了 Skills 則重新啟動 AI 工具）
+
+## 快速模式
+
+帶 `--yes` 或特定選項執行時，跳過互動問題：
+
+```bash
+/update --yes           # 不確認直接更新
+/update --beta --yes    # 更新至 beta 版本
+/update --offline       # 跳過 npm registry 檢查
+/update --skills        # 僅更新 Skills
+/update --commands      # 僅更新 Commands
+```
+
+**注意：** 在 `--yes` 模式下，CLI 會顯示可用 Skills/Commands 的提示，但不會自動安裝（保守行為）。
+
+## 選項參考
+
+| 選項 | 說明 |
+|------|------|
+| `--yes`, `-y` | 跳過確認提示 |
+| `--offline` | 跳過 npm registry 檢查 |
+| `--beta` | 檢查 beta 版本更新 |
+| `--skills` | 僅更新 Skills |
+| `--commands` | 僅更新 Commands |
+| `--integrations-only` | 僅重新產生整合檔案 |
+| `--sync-refs` | 同步整合檔案參考 |
+| `--standards-only` | 僅更新標準，不更新整合 |
+
+## 更新內容
+
+- `.standards/` 目錄中的標準檔案
+- 擴充檔案（語言、框架、地區）
+- 整合檔案（`.cursorrules`、`CLAUDE.md` 等）
+- `manifest.json` 中的版本資訊
+
+## Skills 更新
+
+Skills 單獨管理：
+
+| 安裝方式 | 更新方法 |
+|---------|---------|
+| Plugin Marketplace | 重啟 Claude Code 自動更新 |
+| User-level | `cd ~/.claude/skills && git pull` |
+| Project-level | `cd .claude/skills && git pull` |
+
+## 疑難排解
+
+**"Standards not initialized"**
+- 先執行 `/init` 初始化標準
+
+**"Already up to date"**
+- 無需操作；標準已是最新
+
+**"Skills previously declined"**
+- 執行 `/config skills` 重新安裝已拒絕的 Skills
+
+## 參考
+
+- CLI 文件：`uds update --help`
+- 檢查指令：[/check](./check.md)
+- 配置指令：[/config](./config.md)

package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md

@@ -4,10 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-02-10
 status: current
-description: |
-  根據 Conventional Commits 規範產生格式正確的 commit message。
-  使用時機：提交程式碼、撰寫 commit message、檢查提交格式。
-  關鍵字：commit, conventional commits, 提交, 訊息, feat, fix, refactor。
+description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
 ---
 
 # Commit Message 助手
@@ -60,9 +57,8 @@ description: |
 `/commit` 完成後，AI 助手應建議：
 
 > **提交完成。建議下一步：**
-> - 執行 `/changelog` 更新變更日誌
 > - 執行 `git push` 推送到遠端
-> - 執行 `/release`（若準備發布）
+> - 準備發布時 → 執行 `/changelog` + `/release`
 > - 發現重複模式或規範摩擦 → 執行 `/audit --report` 回報
 
 ## 參考

package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md

@@ -0,0 +1,94 @@
+---
+source: ../../../../skills/database-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-23
+status: current
+description: "[UDS] 引導資料庫設計、遷移規劃和查詢最佳化"
+---
+
+# 資料庫助手
+
+> **語言**: [English](../../../../skills/database-assistant/SKILL.md) | 繁體中文
+
+引導資料庫設計、遷移規劃和查詢最佳化。
+
+## 核心原則
+
+| 原則 | 說明 |
+|------|------|
+| 正規化 | 消除冗餘（至少 3NF） |
+| 參照完整性 | 強制外鍵約束 |
+| 索引策略 | 依查詢模式建立索引 |
+| 遷移安全 | 可逆、零停機 |
+| 資料保護 | 加密敏感欄位、稽核存取 |
+
+## Schema 設計檢查清單
+
+- [ ] 主鍵已定義（建議 UUID 或 BIGINT）
+- [ ] 外鍵含適當的 ON DELETE/UPDATE 策略
+- [ ] 必填欄位加 NOT NULL 約束
+- [ ] 常查詢欄位建立索引
+- [ ] 所有表加建立/更新時間戳
+- [ ] 敏感資料靜態加密
+- [ ] 命名慣例一致（snake_case）
+
+## 正規化快速參考
+
+| 正規形式 | 規則 |
+|----------|------|
+| **1NF** | 原子值、無重複群組 |
+| **2NF** | 1NF + 無部分相依 |
+| **3NF** | 2NF + 無遞移相依 |
+| **反正規化** | 僅針對已證實的讀取效能需求 |
+
+## 遷移工作流程
+
+```
+PLAN ──► WRITE ──► TEST ──► DEPLOY ──► VERIFY
+```
+
+### 1. Plan — 評估影響
+識別受影響的表、估算資料量、規劃回滾策略。
+
+### 2. Write — 撰寫遷移
+撰寫正向和回滾腳本。使用遞增編號的遷移。
+
+### 3. Test — 驗證遷移
+在 staging 環境使用類生產資料執行。驗證遷移後資料完整性。
+
+### 4. Deploy — 執行遷移
+在維護窗口執行，或使用線上 Schema 變更工具。
+
+### 5. Verify — 確認成功
+檢查列數、約束有效性、應用程式功能。
+
+## 索引策略
+
+| 類型 | 使用場景 |
+|------|----------|
+| B-tree | 等值、範圍查詢（預設） |
+| Hash | 僅精確匹配 |
+| GIN | 全文搜尋、JSONB |
+| Partial | 過濾子集 |
+| Composite | 多欄位查詢 |
+
+## 使用方式
+
+- `/database` - 互動式資料庫設計引導
+- `/database schema` - 審查 Schema 設計
+- `/database --migration` - 遷移規劃助手
+
+## 下一步引導
+
+`/database` 完成後，AI 助手應建議：
+
+> **資料庫設計完成。建議下一步：**
+> - 執行 `/security` 檢查資料保護措施
+> - 執行 `/testing` 規劃資料庫測試策略
+> - 執行 `/checkin` 確認遷移符合提交規範
+> - 產生 API 端點 → 執行 `/api-design`
+
+## 參考
+
+- 核心規範：[database-standards.md](../../../../core/database-standards.md)

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

@@ -0,0 +1,140 @@
+---
+source: ../../../../skills/dev-workflow-guide/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+description: "[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南"
+---
+
+# 開發工作流程指南
+
+> **語言**: [English](../../../../skills/dev-workflow-guide/SKILL.md) | 繁體中文
+
+將你目前的軟體開發階段對應到正確的 UDS 指令與技能。即時了解在開發的每個階段應該使用哪些工具。
+
+> **相關**：如需選擇或切換開發方法論（SDD、BDD、TDD），請改用 `/methodology`。
+
+## 軟體開發階段總覽
+
+```
+I. 規劃設計 ──► II. 測試驅動開發 ──► III. 程式碼開發 ──► IV. 品質保證
+
+V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ──► VIII. 進階分析
+```
+
+### 快速對照表
+
+| 階段 | 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` `/testing` `/guide` `/git` | 參考指南 |
+| **VIII. 進階分析** | `/methodology` | 跨方法論工作流程 |
+
+## 常見場景
+
+### 場景 1：新功能開發
+
+從零開始建立新功能的推薦流程：
+
+```
+/brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
+```
+
+| 步驟 | 指令 | 做什麼 |
+|------|------|--------|
+| 1 | `/brainstorm` | 探索想法與方法 |
+| 2 | `/requirement` | 撰寫使用者故事（INVEST 準則） |
+| 3 | `/sdd` | 建立規格文件 |
+| 4 | `/derive` | 從規格產生測試骨架 |
+| 5 | `/tdd` | 用紅綠重構循環實作 |
+| 6 | `/checkin` | 驗證品質關卡 |
+| 7 | `/commit` | 建立規範化提交 |
+
+### 場景 2：修復錯誤
+
+修復既有程式碼錯誤的推薦流程：
+
+```
+/discover → /reverse → /tdd → /checkin → /commit
+```
+
+| 步驟 | 指令 | 做什麼 |
+|------|------|--------|
+| 1 | `/discover` | 評估受影響區域健康度 |
+| 2 | `/reverse` | 理解現有程式碼結構 |
+| 3 | `/tdd` | 先寫失敗測試，再修復 |
+| 4 | `/checkin` | 驗證品質關卡 |
+| 5 | `/commit` | 建立規範化提交 |
+
+### 場景 3：重構
+
+程式碼重構的推薦流程：
+
+```
+/discover → /reverse → /coverage → /refactor → /checkin → /commit
+```
+
+| 步驟 | 指令 | 做什麼 |
+|------|------|--------|
+| 1 | `/discover` | 評估專案健康度與風險 |
+| 2 | `/reverse` | 記錄目前行為 |
+| 3 | `/coverage` | 確保測試安全網存在 |
+| 4 | `/refactor` | 套用重構策略 |
+| 5 | `/checkin` | 驗證品質關卡 |
+| 6 | `/commit` | 建立規範化提交 |
+
+## 使用方式
+
+```bash
+/dev-workflow                    # 顯示完整階段總覽
+/dev-workflow planning           # 取得第 I 階段指引
+/dev-workflow testing            # 取得第 II 階段指引
+/dev-workflow new-feature        # 取得新功能工作流程
+/dev-workflow bug-fix            # 取得修復錯誤工作流程
+/dev-workflow refactoring        # 取得重構工作流程
+```
+
+### 支援的參數
+
+| 參數 | 說明 |
+|------|------|
+| `planning` | 第 I 階段：規劃與設計 |
+| `testing` | 第 II 階段：測試驅動開發 |
+| `implementation` | 第 III 階段：程式碼開發 |
+| `quality` | 第 IV 階段：品質保證 |
+| `release` | 第 V 階段：版本與提交 |
+| `docs` | 第 VI 階段：文件與架構 |
+| `standards` | 第 VII 階段：工具與標準 |
+| `advanced` | 第 VIII 階段：進階系統分析 |
+| `new-feature` | 場景：新功能開發 |
+| `bug-fix` | 場景：修復錯誤 |
+| `refactoring` | 場景：重構 |
+
+## 工作流程行為
+
+呼叫時：
+
+1. **無參數**：顯示完整的階段總覽表，詢問使用者目前在哪個階段
+2. **階段參數**：顯示該階段的詳細指引，包含所有相關指令與範例
+3. **場景參數**：顯示該場景的推薦逐步工作流程
+
+## 下一步引導
+
+`/dev-workflow` 完成後，AI 助手應根據使用者情況建議：
+
+> **工作流程已顯示。建議下一步：**
+> - 新功能開發 → 執行 `/brainstorm` 探索想法
+> - 修復錯誤 → 執行 `/discover` 評估受影響區域
+> - 重構程式碼 → 執行 `/discover` 評估健康度
+> - 遺留系統 → 執行 `/reverse` 進行系統考古
+
+## 參考
+
+- 詳細階段指引：[workflow-phases.md](../../../../skills/dev-workflow-guide/workflow-phases.md)
+- 每日工作流程指南：[DAILY-WORKFLOW-GUIDE.md](../../../../adoption/DAILY-WORKFLOW-GUIDE.md)

package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md

@@ -4,10 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-02-10
 status: current
-description: |
-  從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）。
-  使用時機：產生文件、建立速查表、產生參考手冊。
-  關鍵字：docgen, documentation, cheatsheet, reference, 文件產生, 速查表, 參考手冊。
+description: "[UDS] 從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）"
 ---
 
 # 文件產生器

package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md

@@ -4,10 +4,7 @@ source_version: 2.1.0
 translation_version: 2.1.0
 last_synced: 2026-03-17
 status: current
-description: |
-  引導文件結構、內容需求和專案文件最佳實踐。
-  使用時機：建立 README、文件、docs 目錄、專案設定、技術文件。
-  關鍵字：README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 說明文件, 技術文件.
+description: "[UDS] 引導文件結構、內容需求和專案文件最佳實踐"
 ---
 
 # 文件指南

package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md

@@ -0,0 +1,81 @@
+---
+source: ../../../../skills/durable-execution-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+description: "[UDS] 引導工作流程故障恢復，包含檢查點、重試與回滾策略"
+---
+
+# 持久執行助手
+
+> **語言**: [English](../../../../skills/durable-execution-assistant/SKILL.md) | 繁體中文
+
+引導容錯工作流程設計，包含自動恢復、檢查點與重試策略。
+
+## 使用方式
+
+| 命令 | 用途 |
+|------|------|
+| `/durable` | 啟動互動式故障恢復引導 |
+| `/durable --checkpoint` | 設計檢查點策略 |
+| `/durable --retry` | 配置重試策略 |
+| `/durable --rollback` | 規劃回滾程序 |
+| `/durable <workflow>` | 分析特定工作流的持久性 |
+
+## 核心概念
+
+| 概念 | 定義 |
+|------|------|
+| **檢查點** | 在已知正確的位置儲存執行狀態 |
+| **重試** | 自動重新嘗試失敗的操作 |
+| **回滾** | 失敗時回復到上一個已知正確狀態 |
+| **冪等性** | 操作重新執行時產生相同結果 |
+| **斷路器** | 失敗率超過閾值時停止重試 |
+
+## 故障恢復決策樹
+
+```
+偵測到故障
+├── 是否為暫時性？（網路、逾時）
+│   ├── 是 → 帶退避的重試
+│   └── 否 → 狀態是否損壞？
+│       ├── 是 → 回滾至檢查點
+│       └── 否 → 是否為邏輯錯誤？
+│           ├── 是 → 停止、回報、修復程式碼
+│           └── 否 → 帶診斷資訊升級處理
+```
+
+## 重試策略指南
+
+| 策略 | 使用時機 | 配置 |
+|------|---------|------|
+| **立即重試** | 罕見故障、快速操作 | 最多 2 次重試 |
+| **指數退避** | 網路/API 呼叫 | 基底 1s、最大 30s |
+| **斷路器** | 下游服務問題 | 閾值 50%、視窗 60s |
+| **死信佇列** | 重試後仍不可恢復 | 最多 5 次重試後排入佇列 |
+
+## 檢查點粒度
+
+| 粒度 | 使用場景 |
+|------|---------|
+| **每步驟** | 長管線（> 5 步驟） |
+| **每批次** | 批量資料處理 |
+| **每階段** | 多階段工作流程 |
+| **起始/結束** | 短暫的原子操作 |
+
+## 工作流程
+
+1. **偵測** - 識別故障類型與範圍
+2. **診斷** - 判定根本原因類別
+3. **恢復** - 套用適當的恢復策略
+4. **驗證** - 確認系統狀態一致
+5. **繼續** - 從上一個檢查點繼續
+
+## 下一步引導
+
+`/durable` 完成後，AI 助手應建議：
+
+> **持久性分析完成。建議下一步：**
+> - 執行 `/methodology` 選擇適合的開發方法論
+> - 執行 `/commit` 提交持久化設計變更

package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: errors
-description: |
-  設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式。
-  使用時機：定義錯誤碼、建立錯誤處理、設計 API。
-  關鍵字：error code, error handling, error format, API errors, 錯誤碼, 錯誤處理。
+description: "[UDS] 設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式"
 source: ../../../../skills/error-code-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0