universal-dev-standards 4.1.0 → 5.0.0-beta.10

package/bundled/locales/zh-TW/integrations/claude-code/README.md

@@ -0,0 +1,44 @@
+# Claude Code 整合
+
+> **語言**: English | [繁體中文](README.md)
+
+**版本**: 1.0.0
+**最後更新**: 2026-01-29
+
+本目錄包含將通用開發標準 (Universal Development Standards) 與 [Claude Code](https://docs.anthropic.com/claude-code) 整合的資源。
+
+## 概覽
+
+Claude Code 是一個先進的 AI 編碼代理，可以直接與您的程式碼庫互動。此整合提供：
+
+1.  **專案上下文 (`CLAUDE.md`)**：定義專案特定的規則、風格指南和指令。
+2.  **技能 (`skills/`)**：針對 TDD、SDD、程式碼審查等的專業能力。
+
+## 設定
+
+最簡單的設定方式是使用 UDS CLI：
+
+```bash
+npx universal-dev-standards init
+# 從清單中選擇 "Claude Code"
+```
+
+### 手動設定
+
+1. 將 `CLAUDE.md` 複製到您的專案根目錄。
+2. 確保專案中存在 `core/` 目錄。
+3. 如有需要，安裝技能（請參閱 `skills/README.md`）。
+
+## 驗證
+
+要驗證整合是否運作正常：
+
+1. 啟動 Claude Code：`claude`
+2. 詢問：「這個專案的核心標準是什麼？」
+3. 它應該讀取 `CLAUDE.md` 並引用 `core/` 中的檔案。
+
+## Token 優化
+
+此整合已針對 Token 使用量進行優化：
+- **核心規則**：`core/*.md`（輕量級規則）
+- **詳細指南**：`core/guides/*.md`（僅在需要時載入）

package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/gemini-cli/GEMINI.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-13
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-24
 status: current
 ---
 
@@ -89,10 +89,42 @@ status: current
 
 ---
 
+## 重構指南
+
+參考：`core/refactoring-standards.md`
+
+### 三層策略
+
+| 層級 | 策略 | 時間尺度 |
+|------|------|----------|
+| **戰術** | 童子軍法則、準備性重構、紅綠重構 | 分鐘 |
+| **戰略** | 絞殺者無花果、防腐層、分支抽象 | 週至月 |
+| **安全** | 特徵測試、草稿重構、尋找接縫 | 前置作業 |
+
+### 決策樹
+
+1. 在生產環境？否 → 考慮重寫
+2. 理解程式碼？否 → 先寫特徵測試
+3. 覆蓋率 >60%？否 → 先加測試
+4. 架構可挽救？否 → 絞殺者無花果；是 → 漸進重構
+
+### 快速參考
+
+| 情況 | 策略 |
+|------|------|
+| 功能被雜亂程式碼阻擋 | **準備性重構** |
+| 修 bug 的機會 | **童子軍法則** |
+| 替換遺留系統 | **絞殺者無花果** |
+| 與遺留系統共存 | **防腐層** |
+| 未測試的遺留程式碼 | **先寫特徵測試** |
+
+---
+
 ## 版本歷史
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.1.0 | 2026-01-21 | 新增重構指南章節 |
 | 1.0.0 | 2026-01-09 | 初始 Gemini CLI 指令檔案 |
 
 ---

package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/github-copilot/COPILOT-CHAT-REFERENCE.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-13
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-24
 status: current
 ---
 
@@ -204,6 +204,88 @@ INVEST 檢查清單：
 
 ---
 
+### 9. 重構指導
+
+**Claude Code**：`/refactor`
+
+**Copilot Chat 提示（決策樹）**：
+```
+幫我決定是否應該重構或重寫此程式碼。回答這些問題：
+
+1. 程式碼目前在生產環境運行？[Y/N]
+   → N：考慮重寫（風險較低）
+2. 我理解程式碼做什麼？[Y/N]
+   → N：先寫特徵測試
+3. 測試覆蓋率 > 60%？[Y/N]
+   → N：先加測試
+4. 核心架構可挽救？[Y/N]
+   → N：使用絞殺者無花果模式（漸進替換）
+   → Y：使用漸進式重構
+
+根據我的回答，推薦適當的策略。
+```
+
+**Copilot Chat 提示（戰術重構）**：
+```
+為此程式碼建議戰術重構改進：
+
+**童子軍法則**（小規模、機會性清理）：
+- 重新命名混淆的變數
+- 提取方法
+- 移除死碼
+- 分鐘級，非小時級
+
+**準備性重構**（新增功能前）：
+- 「先讓變更變容易，再做容易的變更」- Kent Beck
+- 重組以適應新需求
+- 與功能工作分開提交
+
+哪種方式適合我的情況？
+```
+
+**Copilot Chat 提示（遺留程式碼安全）**：
+```
+幫我安全地重構此遺留程式碼：
+
+1. **特徵測試**（先做這個）：
+   - 呼叫程式碼，寫預期失敗的斷言
+   - 更新斷言以符合實際行為
+   - 重複直到行為被捕捉
+
+2. **尋找接縫**：
+   - 物件接縫（多型）
+   - 連結接縫（依賴注入）
+
+3. **萌芽/包裝技術**：
+   - 萌芽方法：新邏輯在新的可測試方法中
+   - 包裝方法：在現有程式碼前/後加行為
+
+先幫我寫特徵測試。
+```
+
+**Copilot Chat 提示（戰略重構）**：
+```
+我需要做大規模重構。幫我在以下之間選擇：
+
+1. **絞殺者無花果**：逐步替換遺留系統
+   - 使用時機：替換整個系統，需持續運作
+   - 方法：攔截 → 遷移 → 完成
+
+2. **防腐層 (ACL)**：在新舊之間轉譯
+   - 使用時機：必須與遺留系統共存
+   - 方法：建立 Facade + Adapter + Translator 層
+
+3. **分支抽象**：在主幹上重構共享程式碼
+   - 使用時機：長期重構，無功能分支
+   - 方法：引入抽象 → 加新實作 → 切換 → 移除舊的
+
+哪種模式適合我的情況？我的限制是：[描述情況]
+```
+
+參考：`core/refactoring-standards.md`
+
+---
+
 ## 快速參考卡
 
 | 任務 | Copilot Chat 提示開頭 |
@@ -216,6 +298,9 @@ INVEST 檢查清單：
 | 簽入前 | "在提交前驗證這些品質關卡..." |
 | 發布 | "依照語義化版本準備發布..." |
 | 文件 | "為此撰寫文件..." |
+| 重構 | "幫我決定是否應該重構或重寫..." |
+| 戰術 | "建議戰術重構改進..." |
+| 遺留 | "幫我安全地重構此遺留程式碼..." |
 
 ---
 
@@ -260,6 +345,7 @@ INVEST 檢查清單：
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.1.0 | 2026-01-21 | 新增重構指導提示（決策樹、戰術、遺留、戰略） |
 | 1.0.0 | 2026-01-13 | 初始發布 |
 
 ---

package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/github-copilot/copilot-instructions.md
-source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-01-13
+source_version: 2.1.0
+translation_version: 2.1.0
+last_synced: 2026-01-25
 status: current
 ---
 

package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/github-copilot/skills-mapping.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-13
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-02-05
 status: current
 ---
 
@@ -14,7 +14,7 @@ status: current
 
 ## 概述
 
-Claude Code 提供 18 個 skills 和 16 個斜線命令。GitHub Copilot 不支援斜線命令，但大部分功能可透過 Chat 提示和 `copilot-instructions.md` 檔案實現。
+Claude Code 提供 25 個 skills 和 17 個斜線命令。GitHub Copilot 不支援斜線命令，但大部分功能可透過 Chat 提示和 `copilot-instructions.md` 檔案實現。
 
 ---
 
@@ -36,10 +36,17 @@ Claude Code 提供 18 個 skills 和 16 個斜線命令。GitHub Copilot 不支
 | **git-workflow-guide** | 僅 Chat 提示 | ⚠️ 部分 |
 | **documentation-guide** | 僅 Chat 提示 | ⚠️ 部分 |
 | **methodology-system** | 不可用 | ❌ 無 |
-| **refactoring-assistant** | 僅 Chat 提示 | ⚠️ 部分 |
+| **refactoring-assistant** | COPILOT-CHAT-REFERENCE.md §9 | ✅ 完整 |
 | **error-code-guide** | 僅 Chat 提示 | ⚠️ 部分 |
 | **project-structure-guide** | 僅 Chat 提示 | ⚠️ 部分 |
 | **logging-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+| **bdd-assistant** | 僅 Chat 提示 | ⚠️ 部分 |
+| **atdd-assistant** | 僅 Chat 提示 | ⚠️ 部分 |
+| **docs-generator** | 僅 Chat 提示 | ⚠️ 部分 |
+| **forward-derivation** | 僅 Chat 提示 | ⚠️ 部分 |
+| **reverse-engineer** | 僅 Chat 提示 | ⚠️ 部分 |
+| **ai-friendly-architecture** | 僅 Chat 提示 | ⚠️ 部分 |
+| **ai-instruction-standards** | 僅 Chat 提示 | ⚠️ 部分 |
 
 ### 狀態說明
 
@@ -64,9 +71,16 @@ Claude Code 提供 18 個 skills 和 16 個斜線命令。GitHub Copilot 不支
 | `/release` | "依照語義化版本準備發布" |
 | `/changelog` | "以 Keep a Changelog 格式產生 CHANGELOG 條目" |
 | `/docs` | "為此函式/模組撰寫文件" |
-| `/spec` | "為此功能建立規格文件" |
+| `/sdd` | "為此功能建立規格文件" |
+| `/refactor` | "幫我決定是否應該重構或重寫..." |
+| `/refactor tactical` | "建議戰術重構改進..." |
+| `/refactor legacy` | "幫我安全地重構此遺留程式碼..." |
 | `/methodology` | ❌ 不可用 |
 | `/bdd` | "幫我用 Gherkin 格式撰寫 BDD 情境" |
+| `/atdd` | "幫我實作 ATDD 工作流程與驗收測試" |
+| `/docgen` | "為此模組產生文件" |
+| `/derive` | "從此規格推導實作" |
+| `/reverse` | "從此程式碼逆向工程產生文件" |
 | `/config` | "為此類型應用程式建議專案結構" |
 | `/update` | ❌ 不可用（需手動更新檔案） |
 | `/init` | ❌ 不可用（請改用 UDS CLI） |
@@ -175,7 +189,7 @@ gh repo create my-project --template my-org/project-template
 
 - [copilot-instructions.md](./copilot-instructions.md) - 完整規範
 - [COPILOT-CHAT-REFERENCE.md](./COPILOT-CHAT-REFERENCE.md) - Chat 提示
-- [Claude Code Skills](../../skills/claude-code/) - 原始 skills
+- [Claude Code Skills](../../skills/) - 原始 skills
 
 ---
 
@@ -183,6 +197,8 @@ gh repo create my-project --template my-org/project-template
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.2.0 | 2026-02-05 | 更新 skills 數量（18→25），新增 7 個 skills 和 5 個斜線命令 |
+| 1.1.0 | 2026-01-21 | 更新 refactoring-assistant 為完整狀態，新增 /refactor 命令對照 |
 | 1.0.0 | 2026-01-13 | 初始發布 |
 
 ---

package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/opencode/skills-mapping.md
-source_version: 1.4.0
-translation_version: 1.4.0
-last_synced: 2026-01-13
+source_version: 1.5.0
+translation_version: 1.5.0
+last_synced: 2026-02-05
 status: current
 ---
 
@@ -14,7 +14,7 @@ status: current
 
 ## 概述
 
-Claude Code 提供 18 個技能和 16 個斜線指令。OpenCode 原生支援技能，且**完全相容** Claude Code 技能格式。
+Claude Code 提供 25 個技能和 17 個斜線指令。OpenCode 原生支援技能，且**完全相容** Claude Code 技能格式。
 
 ### 關鍵優勢：原生相容
 
@@ -49,6 +49,13 @@ OpenCode 按以下順序搜索技能：
 | **error-code-guide** | 技能（自動載入） | ✅ 完整 |
 | **project-structure-guide** | 技能（自動載入） | ✅ 完整 |
 | **logging-guide** | 技能（自動載入） | ✅ 完整 |
+| **bdd-assistant** | 技能（自動載入） | ✅ 完整 |
+| **atdd-assistant** | 技能（自動載入） | ✅ 完整 |
+| **docs-generator** | 技能（自動載入） | ✅ 完整 |
+| **forward-derivation** | 技能（自動載入） | ✅ 完整 |
+| **reverse-engineer** | 技能（自動載入） | ✅ 完整 |
+| **ai-friendly-architecture** | 技能（自動載入） | ✅ 完整 |
+| **ai-instruction-standards** | 技能（自動載入） | ✅ 完整 |
 
 ### 狀態說明
 
@@ -75,9 +82,13 @@ OpenCode 支援與 Claude Code 相同的技能調用語法：
 | `/release` | `/release` 或 `skill("release-standards")` | 相同 |
 | `/changelog` | `/changelog` 或 `skill("changelog-guide")` | 相同 |
 | `/docs` | `/docs` 或 `skill("documentation-guide")` | 相同 |
-| `/spec` | `/spec` 或 `skill("spec-driven-dev")` | 相同 |
+| `/sdd` | `/sdd` 或 `skill("spec-driven-dev")` | 相同 |
 | `/methodology` | `/methodology` 或 `skill("methodology-system")` | 相同 |
-| `/bdd` | 透過 `/methodology` 或 `/tdd` | 相同功能 |
+| `/bdd` | `/bdd` 或 `skill("bdd-assistant")` | 相同 |
+| `/atdd` | `/atdd` 或 `skill("atdd-assistant")` | 相同 |
+| `/docgen` | `/docgen` 或 `skill("docs-generator")` | 相同 |
+| `/derive` | `/derive` 或 `skill("forward-derivation")` | 相同 |
+| `/reverse` | `/reverse` 或 `skill("reverse-engineer")` | 相同 |
 | `/config` | `/config` 或 `skill("project-structure-guide")` | 相同 |
 | `/init` | `/init`（內建） | OpenCode 原生 |
 | `/update` | 手動或透過 CLI | 使用 `uds update` |
@@ -116,10 +127,10 @@ uds check
 git clone https://github.com/AsiaOstrich/universal-dev-standards.git /tmp/uds
 
 # 複製技能到 OpenCode 目錄
-cp -r /tmp/uds/skills/claude-code/* ~/.config/opencode/skill/
+cp -r /tmp/uds/skills/* ~/.config/opencode/skill/
 
 # 或複製到專案層級
-cp -r /tmp/uds/skills/claude-code/* .opencode/skill/
+cp -r /tmp/uds/skills/* .opencode/skill/
 
 # 清理
 rm -rf /tmp/uds
@@ -146,7 +157,7 @@ cp -r .claude/skills/commit-standards ~/.config/opencode/skill/
 # 直接下載特定技能
 mkdir -p .opencode/skill/commit-standards
 curl -o .opencode/skill/commit-standards/SKILL.md \
-  https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code/commit-standards/SKILL.md
+  https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/commit-standards/SKILL.md
 ```
 
 ### 方法五：使用 Claude 路徑（零配置）
@@ -374,7 +385,7 @@ temperature: 0.5
 
 - [AGENTS.md](../../../../integrations/opencode/AGENTS.md) - 核心規則檔
 - [opencode.json](../../../../integrations/opencode/opencode.json) - 配置範例
-- [Claude Code Skills](../../../../skills/claude-code/) - 原始技能
+- [Claude Code Skills](../../../../skills/) - 原始技能
 - [GitHub Copilot 技能對照](../github-copilot/skills-mapping.md) - Copilot 等效版本
 
 ---
@@ -383,6 +394,7 @@ temperature: 0.5
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.5.0 | 2026-02-05 | 更新技能數量（18→25），新增 7 個技能和 5 個斜線指令 |
 | 1.4.0 | 2026-01-13 | 新增跨工具相容性章節與路徑對照表 |
 | 1.3.0 | 2026-01-13 | 新增社群 marketplace 章節（n-skills、claude-plugins.dev、agentskills.io） |
 | 1.2.0 | 2026-01-13 | 更新 CLI 方法；OpenCode 現在在 UDS CLI 中支援 skills |