universal-dev-standards 4.2.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/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.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-24
+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` 檔案實現。
 
 ---
 
@@ -40,6 +40,13 @@ Claude Code 提供 18 個 skills 和 16 個斜線命令。GitHub Copilot 不支
 | **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,12 +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） |
@@ -178,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
 
 ---
 
@@ -186,6 +197,7 @@ 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 |

package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md

@@ -0,0 +1,338 @@
+---
+source: ../../core/spec-driven-development.md
+source_version: 2.1.0
+translation_version: 2.1.0
+last_synced: 2026-01-26
+status: current
+---
+
+# 規格驅動開發 (SDD) 標準
+
+**版本**: 2.1.0
+**最後更新**: 2026-01-26
+**適用範圍**: 所有採用規格驅動開發的專案
+**範圍**: universal
+
+> **語言**: [English](../../../../core/spec-driven-development.md) | [繁體中文](../../core/spec-driven-development.md)
+
+---
+
+## 目的
+
+本標準定義規格驅動開發 (SDD) 的原則與工作流程，確保變更在實作前已經過規劃、記錄並透過規格核准。
+
+**主要效益**:
+- 減少利害關係人與開發者之間的溝通誤解
+- 為所有變更提供清晰的審計軌跡
+- 新成員更容易上手
+
+---
+
+## SDD 工作流程
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│     提案     │───▶│     審查     │───▶│     實作     │
+└──────────────┘    └──────────────┘    └──────────────┘
+                                               │
+                                               ▼
+                    ┌──────────────┐    ┌──────────────┐
+                    │     歸檔     │◀───│     驗證     │
+                    └──────────────┘    └──────────────┘
+```
+
+### 工作流程階段
+
+| 階段 | 說明 | 產出物 |
+|------|------|--------|
+| **提案** | 定義變更內容與原因 | `proposal.md` |
+| **審查** | 利害關係人核准 | 審查意見、核准紀錄 |
+| **實作** | 執行已核准的規格 | 程式碼、測試、文件 |
+| **驗證** | 確認實作符合規格 | 測試結果、審查 |
+| **歸檔** | 關閉並歸檔規格 | 已歸檔的規格與 commits/PRs 連結 |
+
+---
+
+## 核心原則
+
+### 1. SDD 工具命令優先
+
+**規則**: 當專案整合了 SDD 工具（如 OpenSpec, Spec Kit 等）且該工具提供特定命令（例如 `/openspec` 或 `/spec` 等斜線命令）時，AI 助手**必須優先使用這些命令**，而非直接手動編輯檔案。
+
+**理由**:
+- **一致性**: 工具確保規格結構遵循嚴格的架構。
+- **可追溯性**: 命令通常會自動處理日誌、ID 和連結。
+- **安全性**: 工具可能有內建驗證以防止無效狀態。
+
+**範例**:
+- ✅ 使用 `/openspec proposal "新增登入"` 取代手動建立 `changes/add-login/proposal.md`。
+
+---
+
+### 2. 方法論優於工具
+
+**規則**: SDD 是一種方法論，不綁定於單一工具。雖然 OpenSpec 是常見的實作，但本標準適用於任何 SDD 工具（例如 Spec Kit）。
+
+**指引**:
+- **通用流程**: 提案 -> 審查 -> 實作 -> 驗證 -> 歸檔。
+- **工具適應**: 適應工作區中啟用之 SDD 工具的特定命令與模式。
+
+---
+
+### 3. 先規格，後程式碼
+
+**規則**: 在沒有經核准的規格或變更提案的情況下，不得進行功能性的程式碼變更。
+
+**例外情況**:
+- 關鍵熱修復（立即恢復服務，隨後補文件）。
+- 瑣碎變更（錯字、註解、格式調整）。
+
+---
+
+## 規格文件範本
+
+### 提案範本
+
+```markdown
+# [SPEC-ID] 功能標題
+
+## 摘要
+簡述提議的變更。
+
+## 動機
+為何需要此變更？解決什麼問題？
+
+## 詳細設計
+技術方法、影響的元件、資料流程。
+
+## 驗收條件
+- [ ] 條件 1
+- [ ] 條件 2
+
+## 相依性
+列出對其他規格或外部系統的相依性。
+
+## 風險
+潛在風險及緩解策略。
+```
+
+---
+
+## 與其他標準整合
+
+### 與 Commit 訊息指南整合
+
+實作已核准的規格時，在 commit 訊息中引用規格 ID：
+
+```
+feat(auth): implement login feature
+
+Implements SPEC-001 login functionality with OAuth2 support.
+
+Refs: SPEC-001
+```
+
+### 與簽入標準整合
+
+在為規格簽入程式碼前：
+
+1. ✅ 規格已核准
+2. ✅ 實作符合規格
+3. ✅ 測試涵蓋驗收條件
+4. ✅ PR 中引用規格 ID
+
+### 與程式碼審查清單整合
+
+審查者應驗證：
+
+- [ ] 變更符合已核准的規格
+- [ ] 無超出規格範圍的變更
+- [ ] 規格驗收條件已達成
+
+---
+
+## 常見 SDD 工具
+
+| 工具 | 說明 | 命令範例 |
+|------|------|----------|
+| **OpenSpec** | 規格管理 | `/openspec proposal`, `/openspec approve` |
+| **Spec Kit** | 輕量級規格追蹤 | `/spec create`, `/spec close` |
+| **手動** | 無工具，基於檔案 | 手動建立 `specs/SPEC-XXX.md` |
+
+---
+
+## 最佳實踐
+
+### 應該做的
+
+- ✅ 保持規格專注且原子化（每個規格一個變更）
+- ✅ 包含明確的驗收條件
+- ✅ 將規格連結到實作 PR
+- ✅ 完成後歸檔規格
+
+### 不應該做的
+
+- ❌ 在規格核准前開始編碼
+- ❌ 實作期間修改範圍而不更新規格
+- ❌ 讓規格處於懸而未決狀態（始終關閉或歸檔）
+- ❌ 跳過驗證步驟
+
+---
+
+## 與反向工程整合
+
+### 概述
+
+對於沒有規格的現有程式碼庫，使用[反向工程標準](../../core/reverse-engineering-standards.md)來生成與 SDD 相容的提案草稿。
+
+### 反向工程 → SDD 流水線
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    反向工程 → SDD 流水線                                  │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│   現有程式碼                                                             │
+│        │                                                                │
+│        ▼                                                                │
+│   ┌────────────────────────────────────────────────────────────┐       │
+│   │ /reverse-spec                                               │       │
+│   │   • 程式碼掃描 → 技術清單 [已確認]                            │       │
+│   │   • 測試分析 → 驗收條件 [已確認/推論]                         │       │
+│   │   • 缺口識別 → [未知] 項目                                   │       │
+│   └────────────────────────────────────────────────────────────┘       │
+│        │                                                                │
+│        ▼                                                                │
+│   草擬規格（反向工程）                                                   │
+│        │                                                                │
+│        ▼                                                                │
+│   ┌────────────────────────────────────────────────────────────┐       │
+│   │ SDD 審查流程                                                 │       │
+│   │   • 人類填寫 [未知] 區塊（動機、風險）                         │       │
+│   │   • 利害關係人驗證 [推論] 項目                                │       │
+│   │   • 正式核准                                                 │       │
+│   └────────────────────────────────────────────────────────────┘       │
+│        │                                                                │
+│        ▼                                                                │
+│   已核准規格 → 繼續正常 SDD 工作流程                                     │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### 反向工程規格的要求
+
+當規格透過反向工程生成時：
+
+1. **標記狀態**：在元資料中包含 `狀態: 草稿（反向工程）`
+2. **填寫未知**：所有 `[未知]` 區塊必須由人類在核准前填寫
+3. **驗證推論**：所有 `[推論]` 項目必須經過審查和確認
+4. **標準審查**：在實作前遵循正常 SDD 審查流程
+5. **來源引用**：維護 file:line 參考以確保可追溯性
+
+### 何時使用反向工程
+
+| 情境 | 做法 |
+|------|------|
+| 舊系統現代化 | 從反向工程開始 |
+| 記錄未文件化的程式碼 | 從程式碼生成規格 |
+| 新成員入職 | 提取規格進行知識轉移 |
+| 重構前的文件化 | 在重大變更前建立規格 |
+
+### 相關命令
+
+| 命令 | 用途 |
+|------|------|
+| `/reverse-spec` | 從現有程式碼生成 SDD 規格 |
+| `/reverse-bdd` | 將驗收條件轉換為 Gherkin 情境 |
+| `/reverse-tdd` | 分析 BDD 情境的測試覆蓋 |
+
+---
+
+## 與正向/反向工程的整合
+
+本標準與兩個互補標準共同組成完整的規格生態系統：
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    SDD 生態系統整合                                       │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│   既有程式碼                      新功能                                  │
+│       │                              │                                  │
+│       ▼                              ▼                                  │
+│   ┌─────────────────┐        ┌─────────────────┐                        │
+│   │ 反向工程         │        │ SDD             │                        │
+│   │ 標準            │        │ （本標準）        │                        │
+│   └────────┬────────┘        └────────┬────────┘                        │
+│            │                          │                                  │
+│            │  程式碼 → 規格            │  規格優先                         │
+│            │                          │                                  │
+│            ▼                          ▼                                  │
+│       ┌─────────────────────────────────────┐                           │
+│       │          SPEC-XXX.md                │                           │
+│       │        （已核准的規格）               │                           │
+│       └──────────────────┬──────────────────┘                           │
+│                          │                                               │
+│                          ▼                                               │
+│   ┌─────────────────────────────────────────────────────┐               │
+│   │          正向推演標準                                 │               │
+│   │                                                      │               │
+│   │   規格 → BDD (.feature)                              │               │
+│   │   規格 → TDD (.test.ts)                              │               │
+│   │   規格 → ATDD (acceptance.md)                        │               │
+│   └─────────────────────────────────────────────────────┘               │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**何時使用哪個標準**：
+
+| 情境 | 起點 | 使用的標準 |
+|------|------|-----------|
+| 新功能開發 | 什麼都沒有 | SDD → 正向推演 |
+| 記錄既有程式碼 | 程式碼存在，無規格 | 反向工程 → SDD |
+| 為既有程式碼加測試 | 規格存在 | 正向推演 |
+| 大型重構 | 程式碼存在，行為不明確 | 反向工程 → SDD → 正向推演 |
+
+---
+
+## 相關標準
+
+- [正向推演標準](../../core/forward-derivation-standards.md) - 規格轉測試轉換（規格 → BDD/TDD/ATDD）
+- [反向工程標準](../../core/reverse-engineering-standards.md) - 程式碼轉規格轉換
+- [測試驅動開發](../../core/test-driven-development.md) - TDD 工作流程與 SDD 整合
+- [行為驅動開發](../../../../core/behavior-driven-development.md) - BDD 工作流程與 Given-When-Then 情境
+- [驗收測試驅動開發](../../../../core/acceptance-test-driven-development.md) - ATDD 工作流程與商業驗收
+- [測試標準](../../core/testing-standards.md) - 測試框架與最佳實踐（或使用 `/testing-guide` 技能）
+- [測試完整性維度](../../core/test-completeness-dimensions.md) - 7 維度測試覆蓋
+- [Commit 訊息指南](../../core/commit-message-guide.md) - Commit 訊息規範
+- [程式碼簽入標準](../../core/checkin-standards.md) - 程式碼簽入標準
+- [程式碼審查清單](../../core/code-review-checklist.md) - 程式碼審查清單
+- [文件結構標準](../../core/documentation-structure.md) - 文件結構標準
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更內容 |
+|------|------|----------|
+| 1.3.0 | 2026-01-19 | 新增：與反向工程整合章節、相關命令 |
+| 1.2.0 | 2026-01-05 | 新增：IEEE 830-1998 和 SWEBOK v4.0 第 1 章（軟體需求）至參考資料 |
+| 1.1.0 | 2025-12-24 | 新增：工作流程圖、規格範本、整合指南、最佳實踐、相關標準、授權 |
+| 1.0.0 | 2025-12-23 | 初始 SDD 標準定義 |
+
+---
+
+## 參考資料
+
+- [OpenSpec Documentation](https://github.com/openspec)
+- [Design Documents Best Practices](https://www.industrialempathy.com/posts/design-docs-at-google/)
+- [ADR (Architecture Decision Records)](https://adr.github.io/)
+- [IEEE 830-1998 - 軟體需求規格](https://standards.ieee.org/ieee/830/1222/) - 需求文件標準
+- [SWEBOK v4.0 - 第 1 章：軟體需求](https://www.computer.org/education/bodies-of-knowledge/software-engineering) - IEEE Computer Society
+
+---
+
+## 授權
+
+本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。