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

package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md

@@ -0,0 +1,62 @@
+---
+source: ../../../../skills/forward-derivation/SKILL.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  從已批准的 SDD 規格生成衍生工件（BDD 場景、TDD 骨架、ATDD 表格）。
+  使用時機：從規格推導測試、產生 BDD/TDD/ATDD 工件。
+  關鍵字：derive, forward, BDD, TDD, ATDD, spec, 推演, 衍生, 規格, 場景。
+---
+
+# 正向推演
+
+> **語言**: [English](../../../../skills/forward-derivation/SKILL.md) | 繁體中文
+
+從已批准的 SDD 規格生成衍生工件（BDD 場景、TDD 骨架、ATDD 表格）。
+
+## 子命令
+
+| 子命令 | 說明 | 輸出 | Output |
+|--------|------|------|--------|
+| `all` | 生成 BDD + TDD（預設） | `.feature` + `.test.*` | `.feature` + `.test.*` |
+| `bdd` | 僅生成 BDD 場景 | `.feature` | `.feature` |
+| `tdd` | 僅生成 TDD 骨架 | `.test.*` | `.test.*` |
+| `atdd` | 生成 ATDD 測試表格 | `.md`（Markdown 表格） | `.md` (Markdown tables) |
+
+## 工作流程
+
+1. **讀取規格** - 分析輸入的 `SPEC-XXX.md` 檔案
+2. **擷取 AC** - 解析所有驗收條件
+3. **生成工件** - 建立 BDD/TDD/ATDD 輸出
+4. **驗證** - 確保 AC 與生成項目之間的 1:1 對應
+
+## 防幻覺規則
+
+| 規則 | 說明 | Rule | Description |
+|------|------|------|-------------|
+| **1:1 對應** | 每個 AC 對應一個測試/場景 | 1:1 Mapping | Every AC has exactly one test/scenario |
+| **可追溯性** | 所有工件引用規格與 AC 編號 | Traceability | All artifacts reference Spec ID and AC ID |
+| **禁止捏造** | 不新增規格外的場景 | No Invention | Do not add scenarios not in the spec |
+
+## 產生工件標籤
+
+| 標籤 | 含義 | Tag | Meaning |
+|------|------|-----|---------|
+| `[Source]` | 直接來自規格 | Source | Direct content from spec |
+| `[Derived]` | 從來源轉換 | Derived | Transformed from source |
+| `[Generated]` | AI 產生的結構 | Generated | AI-generated structure |
+| `[TODO]` | 需人工實作 | TODO | Requires human implementation |
+
+## 使用方式
+
+- `/derive all specs/SPEC-001.md` - 推演 BDD + TDD
+- `/derive bdd specs/SPEC-001.md` - 僅推演 BDD 場景
+- `/derive tdd specs/SPEC-001.md` - 僅推演 TDD 骨架
+- `/derive atdd specs/SPEC-001.md` - 推演 ATDD 表格
+
+## 參考
+
+- 詳細指南：[guide.md](./guide.md)
+- 核心規範：[forward-derivation-standards.md](../../../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md}

@@ -1,31 +1,34 @@
 ---
-name: forward-derivation
+scope: partial
 description: |
-  從已批准的 SDD 規格推演 BDD 場景、TDD 測試骨架和 ATDD 驗收測試。
+  從已批准的 SDD 規格推演 BDD 場景和 TDD 測試骨架。
+  ATDD 驗收測試表為可選輸出，用於特殊需求。
   使用時機：規格已批准、開始 BDD/TDD 實作、生成測試結構。
   關鍵字：forward derivation, spec to test, BDD generation, TDD skeleton, test derivation, 正向推演, 規格轉測試, 測試生成。
-source: ../../../../../skills/claude-code/forward-derivation/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-19
+source: ../../../../skills/forward-derivation/SKILL.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # 正向推演指南
 
-> **語言**: [English](../../../../../skills/claude-code/forward-derivation/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/forward-derivation/SKILL.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2026-01-19
+**版本**: 2.0.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
-> **核心規範**：此技能實作[正向推演標準](../../../core/forward-derivation-standards.md)。任何 AI 工具皆可參考核心規範取得完整方法論文件。
+> **核心規範**：此技能實作[正向推演標準](../../core/forward-derivation-standards.md)。任何 AI 工具皆可參考核心規範取得完整方法論文件。
 
 ---
 
 ## 目的
 
-此技能引導您從已批准的 SDD 規格推演 BDD 場景、TDD 測試骨架和 ATDD 驗收測試，並嚴格遵循反幻覺標準。
+此技能引導您從已批准的 SDD 規格推演 BDD 場景和 TDD 測試骨架，並嚴格遵循反幻覺標準。
+
+> **注意**: ATDD 測試表為可選項，可透過 `/derive-atdd` 取得。BDD 場景本身已作為可執行驗收測試，使 ATDD 表對大多數用例變得多餘。
 
 正向推演是[反向工程](../reverse-engineer/SKILL.md)的對稱對應：
 - **反向工程**：程式碼 → 規格
@@ -245,9 +248,9 @@ describe('SPEC-001: 使用者認證', () => {
 
 ## 與其他技能的整合
 
-### 與 /spec（規格驅動開發）
+### 與 /sdd（規格驅動開發）
 
-1. 使用 `/spec` 工作流程完成 SPEC
+1. 使用 `/sdd` 工作流程完成 SPEC
 2. 透過審查獲得 SPEC 批准
 3. 執行 `/derive-all` 生成測試結構
 4. 在 BDD/TDD 工作流程中使用生成的輸出
@@ -386,12 +389,12 @@ spec-review (已批准) → forward-derivation → discovery (BDD)
 
 ## 相關規範
 
-- [正向推演標準](../../../core/forward-derivation-standards.md) - **核心方法論規範（主要參考）**
-- [反向工程標準](../../../core/reverse-engineering-standards.md) - 對稱對應
-- [規格驅動開發](../../../core/spec-driven-development.md) - 輸入規格格式
-- [行為驅動開發](../../../core/behavior-driven-development.md) - BDD 輸出格式
-- [測試驅動開發](../../../core/test-driven-development.md) - TDD 輸出用法
-- [反幻覺指南](../../../core/anti-hallucination.md) - 生成合規
+- [正向推演標準](../../core/forward-derivation-standards.md) - **核心方法論規範（主要參考）**
+- [反向工程標準](../../core/reverse-engineering-standards.md) - 對稱對應
+- [規格驅動開發](../../core/spec-driven-development.md) - 輸入規格格式
+- [行為驅動開發](../../../../core/behavior-driven-development.md) - BDD 輸出格式
+- [測試驅動開發](../../core/test-driven-development.md) - TDD 輸出用法
+- [反幻覺指南](../../core/anti-hallucination.md) - 生成合規
 
 ---
 
@@ -399,6 +402,8 @@ spec-review (已批准) → forward-derivation → discovery (BDD)
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 2.0.0 | 2026-01-25 | ATDD 從必需改為可選輸出；/derive-all 現在只輸出 BDD + TDD |
+| 1.1.0 | 2026-01-25 | 新增：統一標籤系統參考 |
 | 1.0.0 | 2026-01-19 | 初始發布 |
 
 ---

package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md

@@ -1,10 +1,10 @@
 ---
-source: /skills/claude-code/git-workflow-guide/SKILL.md
+source: ../../../../skills/git-workflow-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
 status: current
-name: git-workflow-guide
+name: git-flow
 description: |
   指導 Git 分支策略、分支命名與合併操作。
   使用時機：建立分支、合併、Pull Request、Git 工作流程問題。
@@ -13,7 +13,7 @@ description: |
 
 # Git 工作流程指南
 
-> **語言**: [English](../../../../../skills/claude-code/git-workflow-guide/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/git-workflow-guide/SKILL.md) | 繁體中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-24

package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md

@@ -1,5 +1,5 @@
 ---
-source: skills/claude-code/git-workflow-guide/branch-naming.md
+source: ../../../../skills/git-workflow-guide/branch-naming.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 
 # 分支命名參考
 
-> **語言**: [English](../../../../../skills/claude-code/git-workflow-guide/branch-naming.md) | 繁體中文
+> **語言**: [English](../../../../skills/git-workflow-guide/branch-naming.md) | 繁體中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -201,7 +201,7 @@ git branch --show-current
 ## 相關標準
 
 - [Git 工作流程策略](./git-workflow.md)
-- [Git 工作流程](../../../../../core/git-workflow.md)
+- [Git 工作流程](../../../../core/git-workflow.md)
 
 ---
 

package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/git-workflow-guide/git-workflow.md
+source: ../../../../skills/git-workflow-guide/git-workflow.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 
 # Git 工作流程策略
 
-> **語言**: [English](../../../../../skills/claude-code/git-workflow-guide/git-workflow.md) | 繁體中文
+> **語言**: [English](../../../../skills/git-workflow-guide/git-workflow.md) | 繁體中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -300,9 +300,9 @@ git merge --ff-only feature/user-auth
 
 ## 相關標準
 
-- [Git Workflow](../../../../../core/git-workflow.md)
+- [Git Workflow](../../../../core/git-workflow.md)
 - [分支命名參考](./branch-naming.md)
-- [Commit 訊息指南](../../../../../core/commit-message-guide.md)
+- [Commit 訊息指南](../../../../core/commit-message-guide.md)
 
 ---
 

package/bundled/locales/zh-TW/skills/{claude-code/logging-guide → logging-guide}/SKILL.md

@@ -1,10 +1,10 @@
 ---
-name: logging-guide
+name: logging
 description: |
   實作結構化日誌，包含正確的日誌層級和敏感資料處理。
   使用時機：新增日誌、除錯、設定可觀測性。
   關鍵字：logging, log level, structured logging, observability, 日誌, 記錄, 結構化日誌。
-source: ../../../../../skills/claude-code/logging-guide/SKILL.md
+source: ../../../../skills/logging-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-08
@@ -13,7 +13,7 @@ status: current
 
 # 日誌指南
 
-> **語言**: [English](../../../../../skills/claude-code/logging-guide/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/logging-guide/SKILL.md) | 繁體中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-30
@@ -108,7 +108,7 @@ status: current
 ## 詳細指南
 
 完整標準請參考：
-- [日誌標準](../../../core/logging-standards.md)
+- [日誌標準](../../core/logging-standards.md)
 
 ### AI 優化格式（節省 Token）
 
@@ -265,8 +265,8 @@ logger.error('處理訂單失敗', {
 
 ## 相關標準
 
-- [日誌標準](../../../core/logging-standards.md)
-- [錯誤碼標準](../../../core/error-code-standards.md)
+- [日誌標準](../../core/logging-standards.md)
+- [錯誤碼標準](../../core/error-code-standards.md)
 
 ---
 

package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md

@@ -0,0 +1,78 @@
+---
+source: ../../../../skills/methodology-system/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  管理當前專案的開發方法論，支援 SDD 和雙迴圈 TDD 兩個獨立系統。
+  使用時機：切換方法論、檢視當前階段、管理開發流程。
+  關鍵字：methodology, SDD, TDD, BDD, ATDD, 方法論, 開發流程。
+---
+
+# 方法論系統
+
+> **語言**: [English](../../../../skills/methodology-system/SKILL.md) | 繁體中文
+
+> [!WARNING]
+> **實驗性功能**
+>
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+管理當前專案的開發方法論，支援兩個獨立系統。
+
+**兩個獨立系統：**
+- **系統 A：SDD** - 規格驅動開發（AI 時代、規格優先）
+- **系統 B：雙迴圈 TDD** - BDD（外部迴圈）+ TDD（內部迴圈）（傳統）
+
+**可選輸入：** ATDD - 驗收測試驅動開發（可作為任一系統的輸入）
+
+## 動作
+
+| 動作 | 說明 |
+|------|------|
+| *(無)* / `status` | 顯示當前階段和檢查清單 |
+| `switch <id>` | 切換到不同方法論 |
+| `phase [name]` | 顯示或變更當前階段 |
+| `checklist` | 顯示當前階段檢查清單 |
+| `skip` | 跳過當前階段（會有警告） |
+| `list` | 列出可用方法論 |
+| `create` | 建立自訂方法論 |
+
+## 可用方法論
+
+| 系統 | ID | 工作流程 |
+|------|-----|---------|
+| A：SDD | `sdd` | /sdd -> 審查 -> /derive-all -> 實作 |
+| B：BDD | `bdd` | 探索 -> 制定 -> 自動化 |
+| B：TDD | `tdd` | 紅 -> 綠 -> 重構 |
+| 輸入 | `atdd` | 工作坊 -> 範例 -> 測試 |
+
+## 使用範例
+
+```
+/methodology                    # 顯示當前狀態
+/methodology switch sdd         # 切換到規格驅動開發
+/methodology phase green        # 移至 GREEN 階段（TDD）
+/methodology checklist          # 顯示當前階段檢查清單
+/methodology list               # 列出所有可用方法論
+/methodology skip               # 跳過當前階段（會有警告）
+/methodology create             # 啟動自訂方法論精靈
+```
+
+## 配置
+
+方法論設定儲存在 `.standards/manifest.json`：
+
+```json
+{
+  "methodology": {
+    "active": "sdd",
+    "available": ["tdd", "bdd", "sdd", "atdd"]
+  }
+}
+```
+
+## 參考
+
+- 詳細指南：[guide.md](./guide.md)

package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/methodology-system/create-methodology.md
+source: ../../../../skills/methodology-system/create-methodology.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -8,7 +8,7 @@ status: experimental
 
 # 建立自訂方法論指南
 
-> **Language**: [English](../../../../../skills/claude-code/methodology-system/create-methodology.md) | 繁體中文
+> **Language**: [English](../../../../skills/methodology-system/create-methodology.md) | 繁體中文
 
 > [!WARNING]
 > **實驗性功能 / Experimental Feature**

package/bundled/locales/zh-TW/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md}

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/methodology-system/SKILL.md
+source: ../../../../skills/methodology-system/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -8,7 +8,7 @@ status: experimental
 
 # 方法論系統 Skill
 
-> **Language**: [English](../../../../../skills/claude-code/methodology-system/SKILL.md) | 繁體中文
+> **Language**: [English](../../../../skills/methodology-system/SKILL.md) | 繁體中文
 
 > [!WARNING]
 > **實驗性功能 / Experimental Feature**

package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/runtime.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/methodology-system/runtime.md
+source: ../../../../skills/methodology-system/runtime.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -8,7 +8,7 @@ status: experimental
 
 # 方法論執行時引導
 
-> **Language**: [English](../../../../../skills/claude-code/methodology-system/runtime.md) | 繁體中文
+> **Language**: [English](../../../../skills/methodology-system/runtime.md) | 繁體中文
 
 > [!WARNING]
 > **實驗性功能 / Experimental Feature**
@@ -161,7 +161,7 @@ AI 應從以下來源偵測方法論上下文：
    - 「為這個變更建立規格」
 
 3. **命令調用**
-   - `/tdd`、`/bdd`、`/spec`、`/atdd`
+   - `/tdd`、`/bdd`、`/sdd`、`/atdd`
    - `/methodology switch <id>`
 
 ### 載入方法論定義

package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md

@@ -0,0 +1,66 @@
+---
+source: ../../../../skills/project-discovery/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  在既有程式碼庫新增功能前的 Phase 0 評估，評估專案健康度、架構與風險。
+  使用時機：新增功能前、專案健康度檢查、風險評估。
+  關鍵字：discover, assessment, health, risk, 評估, 健康度, 風險, 架構。
+---
+
+# 專案現況評估
+
+> **語言**: [English](../../../../skills/project-discovery/SKILL.md) | 繁體中文
+
+在既有程式碼庫新增功能前的 Phase 0 評估。評估專案健康度、架構與風險。
+
+## 評估維度
+
+| 維度 | 檢查項目 |
+|------|----------|
+| **架構** | 模組結構、相依圖、進入點 |
+| **相依套件** | 過時套件、已知漏洞、授權風險 |
+| **測試覆蓋率** | 現有測試、覆蓋率缺口、測試品質 |
+| **安全性** | `npm audit` 結果、硬編碼密鑰、暴露端點 |
+| **技術債** | TODO 標記、程式碼重複、複雜度熱點 |
+
+## 工作流程
+
+1. **掃描專案** - 讀取 package.json、目錄結構、設定檔
+2. **分析架構** - 繪製模組、相依性和資料流圖
+3. **檢查相依套件** - 執行 `npm outdated`、`npm audit` 取得健康信號
+4. **評估風險** - 識別複雜度熱點、缺失測試、安全問題
+5. **產生報告** - 輸出健康分數與可執行的建議
+
+## 輸出格式
+
+```
+專案健康報告
+=====================
+總分：7.2 / 10
+
+| 維度           | 分數  | 狀態    | 主要發現                |
+|----------------|-------|---------|------------------------|
+| 架構           | 8/10  | 良好    | 模組邊界清晰            |
+| 相依套件       | 6/10  | 警告    | 5 個過時、1 個重大問題   |
+| 測試覆蓋率     | 7/10  | 尚可    | 72% 行覆蓋率            |
+| 安全性         | 8/10  | 良好    | 無重大漏洞              |
+| 技術債         | 6/10  | 警告    | 23 個 TODO、3 個熱點    |
+
+建議：
+1. [高] 更新 lodash 以修復 CVE-2024-XXXX
+2. [中] 為 src/payments/ 新增測試（0% 覆蓋率）
+3. [低] 解決 src/utils/ 中的 TODO 積壓
+```
+
+## 使用方式
+
+- `/discover` - 完整專案健康度評估
+- `/discover auth` - 針對 auth 相關模組進行評估
+- `/discover payments` - 在新增支付功能前評估風險
+
+## 參考
+
+- 詳細指南：[guide.md](./guide.md)