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

package/bundled/locales/zh-TW/README.md

@@ -6,7 +6,7 @@
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 4.1.0 | **發布日期**: 2026-01-21 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.0.0-alpha.1 (Pre-release) | **發布日期**: 2026-01-29 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。確保不同技術堆疊之間的一致性、品質和可維護性。
 
@@ -154,8 +154,8 @@ uds init  # 選擇 AI 工具，skills 自動安裝
 macOS / Linux:
 ```bash
 git clone https://github.com/AsiaOstrich/universal-dev-standards.git /tmp/uds
-cp -r /tmp/uds/skills/claude-code/* ~/.claude/skills/    # 全域
-# 或: cp -r /tmp/uds/skills/claude-code/* .claude/skills/  # 專案
+cp -r /tmp/uds/skills/* ~/.claude/skills/    # 全域
+# 或: cp -r /tmp/uds/skills/* .claude/skills/  # 專案
 rm -rf /tmp/uds
 ```
 
@@ -194,7 +194,11 @@ Remove-Item -Recurse $env:TEMP\uds
 
 ## 核心標準概覽
 
-### Level 1：基本（30 分鐘設定）
+> **更新 (v4.3.0)**：核心標準已針對 AI Token 使用量進行最佳化。
+> - **規則 (`core/*.md`)**：供 AI 驗證使用的精簡檢查清單與規則。
+> - **指南 (`core/guides/*.md`)**：供人類閱讀的詳細解釋與教學。
+
+### 等級一：基本（30 分鐘設定）
 
 每個專案必須包含：
 
@@ -372,15 +376,17 @@ CLI 安裝：執行 `uds update --skills`。
 
 ---
 
-## 目錄結構
+### 目錄結構
 
 ```
 universal-dev-standards/
-├── core/                    # 核心標準（22 個檔案）
+├── core/                    # 核心規則與檢查清單（輕量化）
+│   ├── guides/              # 詳細指南與教學
 │   ├── anti-hallucination.md
 │   ├── commit-message-guide.md
-│   ├── testing-standards.md
 │   └── ...
+├── methodologies/           # 方法論指南 (TDD, BDD, SDD)
+│   └── guides/              # 詳細方法論教學
 ├── ai/                      # AI 最佳化格式（.ai.yaml）
 ├── skills/                  # AI 工具 skills
 │   └── claude-code/         # 23 個 skill 目錄

package/bundled/locales/zh-TW/STANDARDS-MAPPING.md

@@ -139,7 +139,7 @@ status: current
 
 | 工具 | 檔案 | 格式 | 狀態 |
 |-----|-----|-----|-----|
-| Claude Code | skills/claude-code/**/*.md | SKILL.md | ✅ 完成 |
+| Claude Code | skills/**/*.md | SKILL.md | ✅ 完成 |
 | Cursor | skills/cursor/.cursorrules | Rules 檔案 | ✅ 完成 |
 | Windsurf | skills/windsurf/.windsurfrules | Rules 檔案 | ✅ 完成 |
 | Cline | skills/cline/.clinerules | Rules 檔案 | ✅ 完成 |

package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md

@@ -8,7 +8,7 @@ status: current
 
 # 規範採用指南
 
-> **語言**: [English](../../adoption/ADOPTION-GUIDE.md) | 繁體中文
+> **語言**: [English](../../../adoption/ADOPTION-GUIDE.md) | 繁體中文
 >
 > 版本 1.0.0
 
@@ -96,7 +96,7 @@ status: current
 
 # 或手動複製（macOS / Linux）
 mkdir -p ~/.claude/skills
-cp -r skills/claude-code/commit-standards ~/.claude/skills/
+cp -r skills/commit-standards ~/.claude/skills/
 ```
 
 ### 類別二：參考文件
@@ -248,7 +248,7 @@ Copy-Item <source-file> .standards\
 ```bash
 git clone https://github.com/AsiaOstrich/universal-dev-standards.git
 mkdir -p ~/.claude/skills
-cp -r universal-dev-standards/skills/claude-code/commit-standards ~/.claude/skills/
+cp -r universal-dev-standards/skills/commit-standards ~/.claude/skills/
 ```
 
 **替代方案：手動複製（Windows PowerShell）**
@@ -340,7 +340,7 @@ Copy-Item path\to\universal-dev-standards\integrations\github-copilot\copilot-in
 - **漸進式採用**：你不需要為所有舊程式碼進行反向工程
 - **任務導向工作流程選擇**：根據任務類型選擇方法論
 - **舊有程式碼策略**：Golden Master Testing、特徵測試
-- **可用命令**：日常使用的快速參考（`/tdd`、`/bdd`、`/spec` 等）
+- **可用命令**：日常使用的快速參考（`/tdd`、`/bdd`、`/sdd` 等）
 
 > **關鍵洞察**：對於舊專案，專注於「觸碰一點，保護一點」，而非全面的前期文件化。
 

package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md

@@ -1,15 +1,15 @@
 ---
 source: ../../../adoption/DAILY-WORKFLOW-GUIDE.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-19
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-02-10
 status: current
 ---
 
 # 日常開發工作流程指南
 
-**版本**: 1.0.0
-**最後更新**: 2026-01-19
+**版本**: 1.1.0
+**最後更新**: 2026-02-10
 
 > **語言**: [English](../../../adoption/DAILY-WORKFLOW-GUIDE.md) | 繁體中文
 
@@ -19,6 +19,7 @@ status: current
 
 ## 目錄
 
+- [Phase 0：專案現況評估](#phase-0專案現況評估)
 - [核心原則：漸進式採用](#核心原則漸進式採用)
 - [根據任務類型選擇工作流程](#根據任務類型選擇工作流程)
 - [Greenfield 與 Brownfield 專案](#greenfield-與-brownfield-專案)
@@ -34,6 +35,41 @@ status: current
 
 ---
 
+## Phase 0：專案現況評估
+
+> **使用時機**：首次接觸既有程式碼庫，或在不熟悉的模組進行重大變更之前。
+
+在 Brownfield 專案進行程式碼變更之前，先執行 `/discover` 評估現況：
+
+```
+1. /discover [area]     → 評估專案健康度、架構、風險
+2. /reverse spec        → 反向工程現有程式碼為規格（如有需要）
+3. /sdd                 → 撰寫新功能規格
+4. 實作                  → 使用 /tdd 或 /bdd 在測試保護下實作
+```
+
+### 評估維度
+
+| 維度 | 檢查項目 |
+|------|----------|
+| **架構** | 模組結構、相依圖、進入點 |
+| **相依性** | 過時套件、已知漏洞、授權風險 |
+| **測試覆蓋** | 現有測試、覆蓋率缺口、測試品質 |
+| **安全性** | `npm audit` 結果、硬編碼密鑰、暴露端點 |
+| **技術債** | TODO 標記、程式碼重複、複雜度熱點 |
+
+### 輸出
+
+Discovery Report 提供：
+- 整體健康度分數（1-10）
+- 各維度分數與關鍵發現
+- **結論**：GO / NO-GO / CONDITIONAL
+- 優先級排序的建議（HIGH / MED / LOW）
+
+> **下一步**：評估完成後，如需理解現有程式碼請使用 `/reverse`，然後用 `/sdd` 設計新功能。
+
+---
+
 ## 核心原則：漸進式採用
 
 ### 常見誤解 vs 實際做法
@@ -71,6 +107,12 @@ status: current
 │                    任務類型 → 工作流程選擇                        │
 ├─────────────────────────────────────────────────────────────────┤
 │                                                                 │
+│  第一次接觸這個程式碼庫？                                        │
+│  │                                                              │
+│  ├─ 是 → 先執行 /discover（Phase 0 評估）                       │
+│  │                                                              │
+│  └─ 否（熟悉程式碼庫）                                          │
+│                                                                 │
 │  這是全新功能嗎？                                                │
 │  │                                                              │
 │  ├─ 是（Greenfield）                                            │
@@ -209,6 +251,11 @@ test('should reject email without domain', () => {
 │                                                                │
 │  ⚠️  只有這種情況才需要較完整的流程                             │
 │                                                                │
+│  0️⃣  評估現況（Discovery + 反向工程）                          │
+│      ├─ /discover 評估專案健康度與風險                          │
+│      ├─ /reverse spec 反向工程現有程式碼                        │
+│      └─ 輸出：Discovery Report + 現有規格                      │
+│                                                                │
 │  1️⃣  撰寫變更規格（SDD）                                       │
 │      ├─ 描述為什麼要重構                                       │
 │      ├─ 定義影響範圍                                           │
@@ -248,7 +295,7 @@ test('should reject email without domain', () => {
     ├─ 根據 AC 撰寫技術設計文件
     ├─ 技術審查並獲得批准
     └─ 輸出：SPEC-XXX 文件
-    💡 命令：/spec
+    💡 命令：/sdd
 
 3️⃣  BDD 階段：撰寫行為規格
     ├─ Discovery：從 AC 識別場景
@@ -314,14 +361,22 @@ test('should reject email without domain', () => {
 
 | 命令 | 用途 | 使用時機 |
 |------|------|----------|
+| `/discover` | 評估專案健康度與風險 | 首次接觸程式碼庫、重大變更前 |
+| `/reverse` | 反向工程程式碼為規格/BDD/TDD | 理解現有程式碼 |
 | `/tdd` | 啟動 TDD 工作流程 | 寫程式碼時 |
 | `/bdd` | 啟動 BDD 工作流程 | 設計行為規格時 |
-| `/spec` | 啟動 SDD 工作流程 | 需要技術規格時 |
+| `/sdd` | 啟動 SDD 工作流程 | 需要技術規格時 |
 | `/atdd` | 啟動 ATDD 工作流程 | 需要正式驗收的功能 |
+| `/refactor` | 啟動重構工作流程 | 改善程式碼結構 |
 | `/methodology` | 查看/切換當前方法論 | 管理開發流程 |
 | `/commit` | 生成規範的 commit message | 提交程式碼 |
 | `/review` | 啟動程式碼審查 | 審查 PR |
 | `/requirement` | 撰寫需求文件 | 定義 User Story |
+| `/checkin` | 提交前品質驗證 | 提交程式碼前 |
+| `/changelog` | 生成變更日誌條目 | 準備發布期間 |
+| `/coverage` | 分析測試覆蓋率 | 評估測試品質 |
+| `/docs` | 管理文件 | 撰寫/更新文件 |
+| `/release` | 引導發布流程 | 準備發布 |
 
 ---
 
@@ -444,6 +499,9 @@ test('should reject email without domain', () => {
 ## 相關標準
 
 - [採用指南](ADOPTION-GUIDE.md) - 如何安裝 UDS
+- [專案現況評估](../../../skills/project-discovery/SKILL.md) - Phase 0 專案評估
+- [反向工程標準](../../../core/reverse-engineering-standards.md) - 反向工程工作流程
+- [重構標準](../../../core/refactoring-standards.md) - 重構工作流程
 - [測試驅動開發](../../../core/test-driven-development.md) - TDD 標準（包含 Golden Master Testing）
 - [行為驅動開發](../../../core/behavior-driven-development.md) - BDD 工作流程
 - [驗收測試驅動開發](../../../core/acceptance-test-driven-development.md) - ATDD 工作流程
@@ -457,6 +515,7 @@ test('should reject email without domain', () => {
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.1.0 | 2026-02-10 | 新增 Phase 0 專案評估、/discover + /reverse + /refactor 命令 |
 | 1.0.0 | 2026-01-19 | 初版日常工作流程指南 |
 
 ---

package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md

@@ -86,7 +86,7 @@ status: current
 
 | 規範 | 核心規則 | 核心目的 |
 |------|---------|---------|
-| [checkin-standards](../../core/checkin-standards.md) | 編譯通過、測試通過、覆蓋率維持 | 確保 commit 前的程式碼品質 |
+| [checkin-standards](../../../core/checkin-standards.md) | 編譯通過、測試通過、覆蓋率維持 | 確保 commit 前的程式碼品質 |
 
 ### 部署方式
 
@@ -119,8 +119,8 @@ status: current
 
 | 規範 | 靜態元件 | 動態技能 | 觸發關鍵字 |
 |------|----------|----------|------------|
-| [anti-hallucination](../../core/anti-hallucination.md) | 確定性標籤、建議原則 | ai-collaboration-standards | certainty, assumption, 確定性 |
-| [project-structure](../../core/project-structure.md) | 目錄慣例 | project-structure-guide | structure, organization, 結構 |
+| [anti-hallucination](../../../core/anti-hallucination.md) | 確定性標籤、建議原則 | ai-collaboration-standards | certainty, assumption, 確定性 |
+| [project-structure](../../../core/project-structure.md) | 目錄慣例 | project-structure-guide | structure, organization, 結構 |
 
 ### 部署方式
 
@@ -147,22 +147,22 @@ status: current
 
 | 規範 | 技能 | 觸發關鍵字 |
 |------|------|-----------|
-| [anti-hallucination](../../core/anti-hallucination.md) | ai-collaboration-standards | certainty, assumption, 確定性 |
-| [changelog-standards](../../core/changelog-standards.md) | changelog-guide | changelog, release notes, 變更日誌 |
-| [code-review-checklist](../../core/code-review-checklist.md) | code-review-assistant | review, PR, 審查 |
-| [commit-message-guide](../../core/commit-message-guide.md) | commit-standards | commit, git, 提交, feat, fix |
-| [documentation-structure](../../core/documentation-structure.md) | documentation-guide | README, docs, 文件 |
-| [documentation-writing-standards](../../core/documentation-writing-standards.md) | documentation-guide | documentation |
-| [error-code-standards](../../core/error-code-standards.md) | error-code-guide | error code, error handling, 錯誤碼 |
-| [git-workflow](../../core/git-workflow.md) | git-workflow-guide | branch, merge, 分支 |
-| [logging-standards](../../core/logging-standards.md) | logging-guide | logging, log level, 日誌 |
-| [project-structure](../../core/project-structure.md) | project-structure-guide | structure, organization, 結構 |
-| [spec-driven-development](../../core/spec-driven-development.md) | requirement-assistant | spec, SDD, 規格, 新功能 |
-| [spec-driven-development](../../core/spec-driven-development.md) | spec-driven-dev | spec, proposal, 提案 |
-| [test-driven-development](../../core/test-driven-development.md) | tdd-assistant | TDD, test first, 紅綠重構 |
-| [test-completeness-dimensions](../../core/test-completeness-dimensions.md) | test-coverage-assistant | test coverage, 7 dimensions, 測試覆蓋 |
-| [testing-standards](../../core/testing-standards.md) | testing-guide | test, 測試, coverage |
-| [versioning](../../core/versioning.md) | release-standards | version, release, 版本 |
+| [anti-hallucination](../../../core/anti-hallucination.md) | ai-collaboration-standards | certainty, assumption, 確定性 |
+| [changelog-standards](../../../core/changelog-standards.md) | changelog-guide | changelog, release notes, 變更日誌 |
+| [code-review-checklist](../../../core/code-review-checklist.md) | code-review-assistant | review, PR, 審查 |
+| [commit-message-guide](../../../core/commit-message-guide.md) | commit-standards | commit, git, 提交, feat, fix |
+| [documentation-structure](../../../core/documentation-structure.md) | documentation-guide | README, docs, 文件 |
+| [documentation-writing-standards](../../../core/documentation-writing-standards.md) | documentation-guide | documentation |
+| [error-code-standards](../../../core/error-code-standards.md) | error-code-guide | error code, error handling, 錯誤碼 |
+| [git-workflow](../../../core/git-workflow.md) | git-workflow-guide | branch, merge, 分支 |
+| [logging-standards](../../../core/logging-standards.md) | logging-guide | logging, log level, 日誌 |
+| [project-structure](../../../core/project-structure.md) | project-structure-guide | structure, organization, 結構 |
+| [spec-driven-development](../../../core/spec-driven-development.md) | requirement-assistant | spec, SDD, 規格, 新功能 |
+| [spec-driven-development](../../../core/spec-driven-development.md) | spec-driven-dev | spec, proposal, 提案 |
+| [test-driven-development](../../../core/test-driven-development.md) | tdd-assistant | TDD, test first, 紅綠重構 |
+| [test-completeness-dimensions](../../../core/test-completeness-dimensions.md) | test-coverage-assistant | test coverage, 7 dimensions, 測試覆蓋 |
+| [testing-standards](../../../core/testing-standards.md) | testing-guide | test, 測試, coverage |
+| [versioning](../../../core/versioning.md) | release-standards | version, release, 版本 |
 
 ### 部署方式
 
@@ -175,7 +175,7 @@ status: current
 **替代方案：手動安裝（macOS / Linux）**
 ```bash
 mkdir -p ~/.claude/skills
-cp -r skills/claude-code/commit-standards ~/.claude/skills/
+cp -r skills/commit-standards ~/.claude/skills/
 ```
 
 **替代方案：手動安裝（Windows PowerShell）**
@@ -183,7 +183,7 @@ cp -r skills/claude-code/commit-standards ~/.claude/skills/
 Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
 ```
 
-詳見 [Claude Code Skills README](../../../skills/claude-code/README.md)。
+詳見 [Claude Code Skills README](../../../skills/README.md)。
 
 ---
 
@@ -278,7 +278,7 @@ description: |
 ## 相關資源
 
 - [CLAUDE.md 範本](../../../templates/CLAUDE.md.template) - 可立即使用的靜態規則範本
-- [Claude Code Skills](../../../skills/claude-code/README.md) - 技能安裝指南
+- [Claude Code Skills](../../../skills/README.md) - 技能安裝指南
 - [採用指南](ADOPTION-GUIDE.md) - 整體採用策略
 - [MAINTENANCE.md](../MAINTENANCE.md) - 如何新增/更新技能（維護者專用）
 

package/bundled/locales/zh-TW/adoption/checklists/enterprise.md

@@ -8,7 +8,7 @@ status: current
 
 # 等級三：企業採用檢查清單
 
-> **語言**: [English](../../../adoption/checklists/enterprise.md) | 繁體中文
+> **語言**: [English](../../../../adoption/checklists/enterprise.md) | 繁體中文
 
 > 企業或受監管專案的全面標準
 >
@@ -311,10 +311,10 @@ project/
 
 - [Essential Adoption Checklist](minimal.md) - Level 1 基本採用
 - [Recommended Adoption Checklist](recommended.md) - Level 2 推薦採用
-- [Documentation Writing Standards](../../../core/documentation-writing-standards.md) - 文件撰寫規範
-- [Project Structure](../../../core/project-structure.md) - 專案結構標準
-- [Checkin Standards](../../../core/checkin-standards.md) - 簽入標準
-- [Spec-Driven Development](../../../core/spec-driven-development.md) - 規格驅動開發
+- [Documentation Writing Standards](../../../../core/documentation-writing-standards.md) - 文件撰寫規範
+- [Project Structure](../../../../core/project-structure.md) - 專案結構標準
+- [Checkin Standards](../../../../core/checkin-standards.md) - 簽入標準
+- [Spec-Driven Development](../../../../core/spec-driven-development.md) - 規格驅動開發
 
 ---
 

package/bundled/locales/zh-TW/adoption/checklists/minimal.md

@@ -1,5 +1,5 @@
 ---
-source: adoption/checklists/minimal.md
+source: ../../../../adoption/checklists/minimal.md
 source_version: 1.0.1
 translation_version: 1.0.1
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 
 # 等級 1：基本採用檢查清單
 
-> **語言**: [English](../../../adoption/checklists/minimal.md) | 繁體中文
+> **語言**: [English](../../../../adoption/checklists/minimal.md) | 繁體中文
 
 > 任何專案的最低可行標準
 >
@@ -122,8 +122,8 @@ Copy-Item path\to\universal-dev-standards\core\spec-driven-development.md .stand
 
 - [Recommended Adoption Checklist](recommended.md) - Level 2 升級指南
 - [Enterprise Adoption Checklist](enterprise.md) - Level 3 升級指南
-- [Checkin Standards](../../../core/checkin-standards.md) - 簽入標準
-- [Spec-Driven Development](../../../core/spec-driven-development.md) - 規格驅動開發
+- [Checkin Standards](../../../../core/checkin-standards.md) - 簽入標準
+- [Spec-Driven Development](../../../../core/spec-driven-development.md) - 規格驅動開發
 
 ---
 

package/bundled/locales/zh-TW/adoption/checklists/recommended.md

@@ -8,7 +8,7 @@ status: current
 
 # 等級二：推薦採用檢查清單
 
-> **語言**: [English](../../../adoption/checklists/recommended.md) | 繁體中文
+> **語言**: [English](../../../../adoption/checklists/recommended.md) | 繁體中文
 
 > 團隊專案的專業品質標準
 >
@@ -251,10 +251,10 @@ Document decision in project README or CONTRIBUTING.md.
 
 - [Essential Adoption Checklist](minimal.md) - Level 1 基本採用
 - [Enterprise Adoption Checklist](enterprise.md) - Level 3 升級指南
-- [Checkin Standards](../../../core/checkin-standards.md) - 簽入標準
-- [Git Workflow](../../../core/git-workflow.md) - Git 工作流程
-- [Testing Standards](../../../core/testing-standards.md) - 測試標準
-- [Code Review Checklist](../../../core/code-review-checklist.md) - 程式碼審查
+- [Checkin Standards](../../../../core/checkin-standards.md) - 簽入標準
+- [Git Workflow](../../../../core/git-workflow.md) - Git 工作流程
+- [Testing Standards](../../../../core/testing-standards.md) - 測試標準
+- [Code Review Checklist](../../../../core/code-review-checklist.md) - 程式碼審查
 
 ---
 

package/bundled/locales/zh-TW/ai/MAINTENANCE.md

@@ -348,7 +348,7 @@ core/anti-hallucination.md                          ← 來源
 ├── locales/zh-TW/core/anti-hallucination.md
 ├── ai/standards/anti-hallucination.ai.yaml
 ├── locales/zh-TW/ai/standards/anti-hallucination.ai.yaml
-└── skills/claude-code/ai-collaboration-standards/
+└── skills/ai-collaboration-standards/
     ├── SKILL.md
     ├── anti-hallucination.md
     └── locales/zh-TW/.../
@@ -373,7 +373,7 @@ core/changelog-standards.md                         ← 來源
 ├── locales/zh-TW/ai/options/changelog/
 │   ├── keep-a-changelog.ai.yaml
 │   └── auto-generated.ai.yaml
-└── skills/claude-code/release-standards/
+└── skills/release-standards/
     ├── SKILL.md
     ├── changelog-format.md
     └── locales/zh-TW/.../
@@ -392,7 +392,7 @@ core/checkin-standards.md                           ← 來源
 ├── locales/zh-TW/core/checkin-standards.md
 ├── ai/standards/checkin-standards.ai.yaml
 ├── locales/zh-TW/ai/standards/checkin-standards.ai.yaml
-└── skills/claude-code/commit-standards/
+└── skills/commit-standards/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -418,7 +418,7 @@ core/code-review-checklist.md                       ← 來源
 │   ├── pr-review.ai.yaml
 │   ├── pair-programming.ai.yaml
 │   └── automated-review.ai.yaml
-└── skills/claude-code/code-review-assistant/
+└── skills/code-review-assistant/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -452,7 +452,7 @@ core/commit-message-guide.md                        ← 來源
 │   ├── english.ai.yaml
 │   ├── traditional-chinese.ai.yaml
 │   └── bilingual.ai.yaml
-└── skills/claude-code/commit-standards/
+└── skills/commit-standards/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -478,7 +478,7 @@ core/documentation-structure.md                     ← 來源
 │   ├── markdown-docs.ai.yaml
 │   ├── api-docs.ai.yaml
 │   └── wiki-style.ai.yaml
-└── skills/claude-code/documentation-guide/
+└── skills/documentation-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -496,7 +496,7 @@ core/documentation-writing-standards.md             ← 來源
 ├── locales/zh-TW/core/documentation-writing-standards.md
 ├── ai/standards/documentation-writing-standards.ai.yaml
 ├── locales/zh-TW/ai/standards/documentation-writing-standards.ai.yaml
-└── skills/claude-code/documentation-guide/
+└── skills/documentation-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -542,7 +542,7 @@ core/git-workflow.md                                ← 來源
 │   └── (6 個 .ai.yaml 檔案)
 ├── locales/zh-TW/ai/options/git-workflow/
 │   └── (6 個翻譯的 .ai.yaml 檔案)
-└── skills/claude-code/git-workflow-guide/
+└── skills/git-workflow-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -596,7 +596,7 @@ core/project-structure.md                           ← 來源
 │   └── swift.ai.yaml     ← 僅 YAML（無 MD）
 ├── locales/zh-TW/ai/options/project-structure/
 │   └── (10 個翻譯的 .ai.yaml 檔案)
-└── skills/claude-code/project-structure-guide/（如存在）
+└── skills/project-structure-guide/（如存在）
 ```
 
 **需更新檔案**: ~38 個
@@ -629,7 +629,7 @@ core/test-completeness-dimensions.md                ← 來源
 ├── locales/zh-TW/core/test-completeness-dimensions.md
 ├── ai/standards/test-completeness-dimensions.ai.yaml
 ├── locales/zh-TW/ai/standards/test-completeness-dimensions.ai.yaml
-└── skills/claude-code/testing-guide/
+└── skills/testing-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -666,7 +666,7 @@ core/testing-standards.md                           ← 來源
 │   └── contract-testing.ai.yaml   ← 僅 YAML
 ├── locales/zh-TW/ai/options/testing/
 │   └── (9 個翻譯的 .ai.yaml 檔案)
-└── skills/claude-code/testing-guide/
+└── skills/testing-guide/
     ├── SKILL.md
     ├── testing-pyramid.md
     └── locales/zh-TW/.../
@@ -687,7 +687,7 @@ core/versioning.md                                  ← 來源
 ├── locales/zh-TW/core/versioning.md
 ├── ai/standards/versioning.ai.yaml
 ├── locales/zh-TW/ai/standards/versioning.ai.yaml
-└── skills/claude-code/release-standards/
+└── skills/release-standards/
     ├── SKILL.md
     ├── semantic-versioning.md
     └── locales/zh-TW/.../
@@ -734,7 +734,7 @@ core/versioning.md                                  ← 來源
 6. locales/zh-TW/options/{category}/     ← 翻譯 MD 選項
 7. ai/options/{category}/*.ai.yaml       ← 如有 YAML 選項
 8. locales/zh-TW/ai/options/{category}/  ← 翻譯 YAML 選項
-9. skills/claude-code/{skill}/           ← 更新相關技能
+9. skills/{skill}/           ← 更新相關技能
 10. locales/zh-TW/skills/...             ← 翻譯技能
 ```
 

package/bundled/locales/zh-TW/ai/standards/anti-hallucination.ai.yaml

@@ -4,9 +4,10 @@
 id: anti-hallucination
 meta:
   version: "1.3.1"
-  updated: "2025-12-30"
+  updated: "2026-01-26"
   source: core/anti-hallucination.md
-  description: AI 助手防止幻覺的嚴格指南
+  guide: core/guides/anti-hallucination-guide.md
+  description: 透過證據基礎分析和嚴格驗證標籤來防止 AI 幻覺的協議
   language: zh-TW
 
 principles:

package/bundled/locales/zh-TW/ai/standards/git-workflow.ai.yaml

@@ -3,10 +3,11 @@
 
 id: git-workflow
 meta:
-  version: "1.2.1"
-  updated: "2025-12-26"
+  version: "1.3.0"
+  updated: "2026-01-24"
   source: core/git-workflow.md
-  description: Git 分支策略與工作流程
+  guide: core/guides/git-workflow-guide.md
+  description: Git 分支策略、提交慣例與 Pull Request 工作流程
   language: zh-TW
 
 decision:

package/bundled/locales/zh-TW/ai/standards/spec-driven-development.ai.yaml

@@ -4,9 +4,9 @@
 id: spec-driven-development
 meta:
   version: "1.2.0"
-  updated: "2026-01-05"
-  source: core/spec-driven-development.md
-  description: 規格驅動開發 (SDD) 的原則和工作流程
+  updated: "2025-12-30"
+  source: methodologies/guides/sdd-guide.md
+  description: 規格驅動開發工作流程，在實作前先完成文件規範
   language: zh-TW
 
 workflow:

package/bundled/locales/zh-TW/ai/standards/testing.ai.yaml

@@ -6,6 +6,7 @@ meta:
   version: "1.3.0"
   updated: "2025-12-30"
   source: core/testing-standards.md
+  guide: skills/testing-guide/testing-theory.md
   description: 測試金字塔與建議的覆蓋率比例，支援框架選項
   language: zh-TW
 

package/bundled/locales/zh-TW/core/ai-instruction-standards.md

@@ -1,5 +1,5 @@
 ---
-source: core/ai-instruction-standards.md
+source: ../../../core/ai-instruction-standards.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-14