universal-dev-standards 4.0.0-beta.1 → 4.0.0

package/bundled/core/testing-standards.md

@@ -2,8 +2,8 @@
 
 > **Language**: English | [繁體中文](../locales/zh-TW/core/testing-standards.md)
 
-**Version**: 2.1.0
-**Last Updated**: 2026-01-05
+**Version**: 2.2.0
+**Last Updated**: 2026-01-20
 **Applicability**: All software projects
 
 ---
@@ -38,6 +38,7 @@ This standard defines testing conventions and best practices to ensure software
 15. [Test Environment Isolation](#test-environment-isolation)
 16. [CI/CD Integration](#cicd-integration)
 17. [Best Practices](#best-practices)
+18. [Test Documentation Structure](#test-documentation-structure) ⭐ NEW
 
 ---
 
@@ -2946,6 +2947,95 @@ public void MethodName_Scenario_ExpectedBehavior()
 
 ---
 
+## Test Documentation Structure
+
+Improve test discoverability by maintaining a standardized documentation structure within test directories.
+
+### tests/README.md Required Sections
+
+Every `tests/` directory SHOULD include a README.md with the following sections for discoverability.
+
+#### 1. Test Overview Table
+
+List all test types with count, technology stack, and execution environment.
+
+```markdown
+| Test Type | Count | Framework | Environment |
+|-----------|-------|-----------|-------------|
+| Unit Tests | 150 | Jest | Node.js |
+| Integration Tests | 45 | Jest | Node.js + TestContainers |
+| E2E Tests | 12 | Playwright | Browser |
+```
+
+#### 2. Current Status Section
+
+Display latest test execution results with clear pass/fail indicators.
+
+```markdown
+## Current Status
+
+| Metric | Value | Target | Status |
+|--------|-------|--------|--------|
+| Pass Rate | 98.5% | ≥ 95% | ✅ |
+| Line Coverage | 82% | ≥ 80% | ✅ |
+| Branch Coverage | 75% | ≥ 70% | ✅ |
+
+**Last Run**: 2026-01-20 14:30 UTC
+**Report**: [test-report-20260120-143000.md](results/test-report-20260120-143000.md)
+```
+
+#### 3. Report Links Section
+
+Include links to test reports, gap analysis, and coverage summary.
+
+```markdown
+## Reports
+
+| Report Type | Location | Description |
+|-------------|----------|-------------|
+| Test Results | `results/` | Timestamped test execution reports |
+| Coverage | `coverage/` | Code coverage reports (HTML, JSON) |
+| Gap Analysis | `docs/gap-analysis.md` | Missing test coverage analysis |
+```
+
+### Test Report Naming Convention
+
+| Item | Convention | Example |
+|------|------------|---------|
+| Report filename | `test-report-YYYYMMDD-HHMMSS.md` | `test-report-20260120-143000.md` |
+| Report directory | `tests/results/` | `tests/results/test-report-*.md` |
+| Coverage directory | `tests/coverage/` | `tests/coverage/lcov-report/` |
+| Gap analysis | `tests/docs/gap-analysis.md` | - |
+
+### Directory Structure Example
+
+```
+tests/
+├── README.md                    # Test overview and status
+├── results/                     # Test execution reports
+│   ├── test-report-20260120-143000.md
+│   └── test-report-20260119-090000.md
+├── coverage/                    # Coverage reports
+│   ├── lcov-report/
+│   └── coverage-summary.json
+├── docs/                        # Test documentation
+│   └── gap-analysis.md
+├── unit/                        # Unit tests
+├── integration/                 # Integration tests
+└── e2e/                         # End-to-end tests
+```
+
+### Benefits
+
+| Benefit | Description |
+|---------|-------------|
+| **Discoverability** | Developers can quickly find test status without searching |
+| **Transparency** | Current quality metrics visible at a glance |
+| **Traceability** | Historical reports enable trend analysis |
+| **Onboarding** | New team members understand test structure immediately |
+
+---
+
 ## Quick Reference Card
 
 ```
@@ -3042,6 +3132,7 @@ public void MethodName_Scenario_ExpectedBehavior()
 
 | Version | Date | Changes |
 |---------|------|---------|
+| 2.2.0 | 2026-01-20 | Added Test Documentation Structure section: tests/README.md required sections, test report naming conventions, directory structure example. |
 | 2.1.0 | 2026-01-05 | Added SWEBOK v4.0 reference. New sections: Testing Fundamentals (Faults vs Failures, Oracle Problem, Theoretical Limitations, Testability, Test Adequacy), Test-Related Measures (Fault Density, Reliability Growth, Fault Seeding). Expanded: Test Design Techniques (Pairwise Testing, Data Flow Testing), Specialized Testing (Installation, Alpha/Beta, Recovery, Configuration, Back-to-Back, Usability). Updated Quick Reference Card. |
 | 2.0.0 | 2026-01-05 | Major update aligned with ISTQB CTFL v4.0 and ISO/IEC/IEEE 29119. Added: Static Testing (reviews, static analysis), Test Design Techniques (EP, BVA, Decision Table, State Transition, Use Case, Statement/Branch/Condition/MC/DC coverage), Experience-Based Testing (exploratory, error guessing, checklists), Risk-Based Testing (risk assessment, prioritization), Specialized Testing (contract, mutation, chaos, property-based, visual regression, accessibility), Defect Management (lifecycle, metrics, root cause), Test Process Management (planning, monitoring, completion) |
 | 1.3.0 | 2025-12-29 | Add: Testing Framework Selection (ISTQB vs Industry Pyramid), IT/SIT abbreviation clarification, source references |

package/bundled/locales/zh-CN/CLAUDE.md

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一个语言无关、框架无关的文件化标准框架。它提供：
 
-- **核心规范** (`core/`)：16 个基础开发标准
+- **核心规范** (`core/`)：22 个基础开发标准
 - **AI 技能** (`skills/`)：用于 AI 辅助开发的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用于采用标准的 Node.js CLI
 - **整合** (`integrations/`)：各种 AI 工具的配置
@@ -200,9 +200,9 @@ node cli\bin\uds.js init --help
 
 ```
 universal-dev-standards/
-├── core/                  # 核心规范（16 个档案）
+├── core/                  # 核心规范（22 个档案）
 ├── skills/                # AI 工具技能
-│   └── claude-code/       # Claude Code 技能（15 个技能）
+│   └── claude-code/       # Claude Code 技能（23 个技能）
 ├── cli/                   # Node.js CLI 工具
 │   ├── src/               # 原始码
 │   ├── tests/             # 测试档案

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

@@ -1,37 +1,32 @@
 ---
 source: ../../README.md
-source_version: 3.5.0
-translation_version: 3.5.0
-last_synced: 2026-01-15
+source_version: 4.0.0
+translation_version: 4.0.0
+last_synced: 2026-01-20
 status: current
 ---
 
 # 通用开发规范
 
-> **Language**: [English](../../README.md) | [简体中文](../zh-TW/README.md) | 简体中文
+> **Language**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 3.5.0-beta.13
-**最后更新**: 2026-01-13
+**版本**: 4.0.0
+**最后更新**: 2026-01-20
 **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
-> **🧪 Beta 通知**: 此版本包含实验性功能。API 可能在稳定版本发布前有所变动。
-> 如需稳定版本: `npm install universal-dev-standards@3.4.2`
+### 4.0.0 新功能
 
-### 功能可用性
-
-| 功能 | 稳定版 (3.4.2) | Beta 版 (3.5.x) |
-|------|:--------------:|:---------------:|
-| **核心标准** (16 个文件) | ✅ | ✅ |
-| **Claude Code 技能** (15 个技能) | ✅ | ✅ |
-| **CLI 工具** (`uds init`, `check`, `update`) | ✅ | ✅ |
-| 基于哈希的完整性检查 | ✅ | ✅ |
-| Plugin Marketplace 支持 | ✅ | ✅ |
-| **方法论系统** | ❌ | ✅ 🧪 |
-| `/methodology` 命令 | ❌ | ✅ 🧪 |
-| `/bdd` 命令 | ❌ | ✅ 🧪 |
-| TDD/BDD/SDD/ATDD 工作流 | ❌ | ✅ 🧪 |
+| 功能 | 说明 |
+|------|------|
+| **双向推演** | 正向推演 + 反向工程形成完整的规格-代码循环 |
+| **6 个新核心标准** | BDD、ATDD、反向工程、正向推演、AI 指令、重构 |
+| **23 个 Skills** | 8 个新技能，包括正向推演、BDD/ATDD 助手、Commands |
+| **24 个斜杠命令** | 9 个新命令（`/derive-*`、`/reverse-*`、`/atdd`、`/bdd`）|
+| **每工具安装层级** | Skills/Commands 支持每个 AI 工具的用户或项目层级 |
+| **增强 CLI** | Debug 标志、拒绝功能记忆、文件完整性追踪 |
+| **方法论系统** | TDD/BDD/SDD/ATDD 工作流现已正式发布 |
 
-> 🧪 = 实验性功能，API 可能变动
+> **4.0 新功能**：双向推演带来完整的规格-代码生命周期管理，包含正向推演和反向工程。
 
 ---
 
@@ -88,7 +83,7 @@ cp core/commit-message-guide.md your-project/.standards/
 | Cursor | `uds init` → `.cursorrules` | ❌ 仅 Rules | - |
 | Google Antigravity | `uds init` → `INSTRUCTIONS.md` | - | - |
 
-> **v3.5.0 新功能**：`uds init` 支持多 Agent Skills 安装。可同时选择多个 agents 安装 Skills。Gemini CLI 命令会自动转换为 TOML 格式。
+> **v4.0.0 新功能**：`uds init` 支持每工具安装层级选择（用户或项目层级）。双向推演系统（正向推演 + 反向工程）现已可用。
 
 ---
 
@@ -112,20 +107,15 @@ uds skills  # 列出已安装的技能
 npx universal-dev-standards init
 ```
 
-**Beta 版本（最新功能）**
+**特定版本**
 ```bash
-# 全局安装 beta 版
-npm install -g universal-dev-standards@beta
+# 安装特定版本
+npm install -g universal-dev-standards@4.0.0
 
-# 或安装特定版本
-npm install -g universal-dev-standards@3.5.0-beta.13
-
-# 或通过 npx
-npx universal-dev-standards@beta init
+# 或安装 beta 版以获得即将推出的功能
+npm install -g universal-dev-standards@beta
 ```
 
-> **注意**：Beta 版本包含实验性功能，例如方法论系统（`/methodology`、`/bdd`）。详见[功能可用性](#功能可用性)。
-
 **克隆并链接（开发用）**
 
 macOS / Linux：
@@ -168,7 +158,7 @@ cd universal-dev-standards\cli; npm install; npm link
 
 Agent Skills 是增强 AI 辅助开发的交互式命令（`/commit`、`/tdd`、`/review` 等）。Skills 遵循 [Agent Skills 标准](https://agentskills.io)，可跨多个 AI 工具使用。
 
-**包含的技能（15 个）：** ai-collaboration-standards、changelog-guide、code-review-assistant、commit-standards、documentation-guide、error-code-guide、git-workflow-guide、logging-guide、project-structure-guide、release-standards、requirement-assistant、spec-driven-dev、tdd-assistant、test-coverage-assistant、testing-guide
+**包含的技能（23 个）：** ai-collaboration-standards、atdd-assistant、bdd-assistant、changelog-guide、checkin-assistant、code-review-assistant、commands、commit-standards、documentation-guide、error-code-guide、forward-derivation、git-workflow-guide、logging-guide、methodology-system、project-structure-guide、refactoring-assistant、release-standards、requirement-assistant、reverse-engineer、spec-driven-dev、tdd-assistant、test-coverage-assistant、testing-guide
 
 #### 支持的工具
 
@@ -189,7 +179,7 @@ Claude Code 用户可通过 Plugin Marketplace 最简单地安装：
 **优势：**
 - 单一命令安装
 - 新版本发布时自动更新
-- 所有 15 个技能即时加载
+- 所有 22 个技能即时加载
 
 **从 v3.2.x 迁移？** 如果您使用旧的 marketplace 名称：
 
@@ -284,7 +274,7 @@ Remove-Item -Recurse $env:TEMP\uds
 
 ```
 universal-dev-standards/
-├── core/                    # 核心通用标准（16 个文件）
+├── core/                    # 核心通用标准（22 个文件）
 ├── ai/                      # AI 优化标准（.ai.yaml）
 ├── options/                 # 人类可读选项指南
 ├── skills/                  # AI 工具技能（Claude Code 等）
@@ -576,6 +566,8 @@ cp integrations/openspec/commands/* your-project/.claude/commands/
 
 | 版本 | 日期 | 亮点 |
 |------|------|------|
+| 4.0.0 | 2026-01-20 | 双向推演；6 个新核心标准；22 个技能 |
+| 3.5.0 | 2026-01-15 | 多 Agent Skills；Gemini CLI TOML；i18n 支持 |
 | 3.2.2 | 2026-01-06 | 新增 `uds skills` 命令；弃用手动安装脚本 |
 | 3.2.0 | 2026-01-02 | Plugin Marketplace 支持；CLI 增强 |
 | 3.0.0 | 2025-12-30 | 完整 Windows 支持；AI 优化标准；npm 发布 |
@@ -628,8 +620,11 @@ cp integrations/openspec/commands/* your-project/.claude/commands/
 
 ```
 universal-dev-standards/
-├── core/                                  # 核心通用标准（16 个文件）
+├── core/                                  # 核心通用标准（22 个文件）
+│   ├── acceptance-test-driven-development.md # ATDD 方法论
+│   ├── ai-instruction-standards.md       # AI 指令撰写指南
 │   ├── anti-hallucination.md             # AI 协作指南
+│   ├── behavior-driven-development.md    # BDD 方法论
 │   ├── changelog-standards.md            # 变更日志撰写指南
 │   ├── checkin-standards.md              # 代码签入质量门槛
 │   ├── code-review-checklist.md          # 代码审查指南
@@ -637,16 +632,19 @@ universal-dev-standards/
 │   ├── documentation-structure.md        # 文档组织
 │   ├── documentation-writing-standards.md # 文档撰写指南
 │   ├── error-code-standards.md           # 错误码规范
+│   ├── forward-derivation-standards.md   # 正向推演标准
 │   ├── git-workflow.md                   # Git 分支策略
 │   ├── logging-standards.md              # 日志标准
 │   ├── project-structure.md              # 项目目录规范
+│   ├── refactoring-standards.md          # 重构标准
+│   ├── reverse-engineering-standards.md  # 反向工程标准
 │   ├── spec-driven-development.md        # SDD 方法论与标准
 │   ├── test-completeness-dimensions.md   # 测试完整度维度
 │   ├── test-driven-development.md        # TDD 方法论
 │   ├── testing-standards.md              # 测试标准（UT/IT/ST/E2E）
 │   └── versioning.md                     # 语义化版本控制指南
 │
-├── ai/                             # AI 优化标准（v2.3.0）
+├── ai/                             # AI 优化标准
 │   ├── standards/                 # Token 高效的 YAML 格式（约 80% 减少）
 │   │   ├── git-workflow.ai.yaml
 │   │   ├── commit-message.ai.yaml
@@ -664,8 +662,8 @@ universal-dev-standards/
 │   ├── testing/                   # 测试层级指南
 │   └── project-structure/         # 语言特定项目结构
 │
-├── skills/                         # AI 工具技能（v2.1.0）
-│   ├── claude-code/               # Claude Code 技能（15 个技能）
+├── skills/                         # AI 工具技能
+│   ├── claude-code/               # Claude Code 技能（22 个技能）
 │   ├── cursor/                    # Cursor Rules（规划中）
 │   ├── windsurf/                  # Windsurf Rules（规划中）
 │   ├── cline/                     # Cline Rules（规划中）

package/bundled/locales/zh-CN/core/testing-standards.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/testing-standards.md
-source_version: 2.1.0
-translation_version: 2.1.0
-last_synced: 2026-01-08
+source_version: 2.2.0
+translation_version: 2.2.0
+last_synced: 2026-01-20
 status: current
 ---
 
@@ -135,6 +135,95 @@ test_<method>_<condition>_<expected result>
 
 ---
 
+## 测试文档结构
+
+通过在测试目录中维护标准化的文档结构，提升测试可发现性。
+
+### tests/README.md 必要区块
+
+每个 `tests/` 目录应包含 README.md，并具备以下区块以提高可发现性。
+
+#### 1. 测试总览表格
+
+列出所有测试类型、数量、技术栈和执行环境。
+
+```markdown
+| 测试类型 | 数量 | 框架 | 环境 |
+|----------|------|------|------|
+| 单元测试 | 150 | Jest | Node.js |
+| 集成测试 | 45 | Jest | Node.js + TestContainers |
+| E2E 测试 | 12 | Playwright | 浏览器 |
+```
+
+#### 2. 当前状态区块
+
+显示最新测试执行结果，包含清楚的通过/失败指标。
+
+```markdown
+## 当前状态
+
+| 指标 | 数值 | 目标 | 状态 |
+|------|------|------|------|
+| 通过率 | 98.5% | ≥ 95% | ✅ |
+| 行覆盖率 | 82% | ≥ 80% | ✅ |
+| 分支覆盖率 | 75% | ≥ 70% | ✅ |
+
+**最后执行**: 2026-01-20 14:30 UTC
+**报告**: [test-report-20260120-143000.md](results/test-report-20260120-143000.md)
+```
+
+#### 3. 报告链接区块
+
+包含测试报告、差距分析和覆盖率摘要的链接。
+
+```markdown
+## 报告
+
+| 报告类型 | 位置 | 说明 |
+|----------|------|------|
+| 测试结果 | `results/` | 带时间戳的测试执行报告 |
+| 覆盖率 | `coverage/` | 代码覆盖率报告（HTML、JSON） |
+| 差距分析 | `docs/gap-analysis.md` | 缺失的测试覆盖率分析 |
+```
+
+### 测试报告命名规范
+
+| 项目 | 规范 | 范例 |
+|------|------|------|
+| 报告文件名 | `test-report-YYYYMMDD-HHMMSS.md` | `test-report-20260120-143000.md` |
+| 报告目录 | `tests/results/` | `tests/results/test-report-*.md` |
+| 覆盖率目录 | `tests/coverage/` | `tests/coverage/lcov-report/` |
+| 差距分析 | `tests/docs/gap-analysis.md` | - |
+
+### 目录结构范例
+
+```
+tests/
+├── README.md                    # 测试总览与状态
+├── results/                     # 测试执行报告
+│   ├── test-report-20260120-143000.md
+│   └── test-report-20260119-090000.md
+├── coverage/                    # 覆盖率报告
+│   ├── lcov-report/
+│   └── coverage-summary.json
+├── docs/                        # 测试文档
+│   └── gap-analysis.md
+├── unit/                        # 单元测试
+├── integration/                 # 集成测试
+└── e2e/                         # 端对端测试
+```
+
+### 效益
+
+| 效益 | 说明 |
+|------|------|
+| **可发现性** | 开发者可快速找到测试状态，无需全面搜索 |
+| **透明度** | 当前质量指标一目了然 |
+| **可追溯性** | 历史报告支援趋势分析 |
+| **新人入门** | 新团队成员可立即理解测试结构 |
+
+---
+
 ## 快速参考卡
 
 ### 测试类型选择

package/bundled/locales/zh-CN/skills/claude-code/commands/bdd.md

@@ -9,7 +9,7 @@ status: experimental
 ---
 description: 引導行为驅动开发流程 | Guide through Behavior-Driven Development workflow
 allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
-argument-hint: [要实作的行为或場景 | behavior or scenario to implement]
+argument-hint: "[要实作的行为或場景 | behavior or scenario to implement]"
 status: experimental
 ---
 

package/bundled/locales/zh-CN/skills/claude-code/commands/methodology.md

@@ -9,7 +9,7 @@ status: experimental
 ---
 description: 管理开发方法論工作流 | Manage development methodology workflow
 allowed-tools: Read, Write, Glob, Grep, Bash(git:*)
-argument-hint: [action] [argument]
+argument-hint: "[action] [argument]"
 status: experimental
 ---
 

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

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供：
 
-- **核心規範** (`core/`)：16 個基礎開發標準
+- **核心規範** (`core/`)：22 個基礎開發標準
 - **AI 技能** (`skills/`)：用於 AI 輔助開發的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用於採用標準的 Node.js CLI
 - **整合** (`integrations/`)：各種 AI 工具的配置
@@ -200,9 +200,9 @@ node cli\bin\uds.js init --help
 
 ```
 universal-dev-standards/
-├── core/                  # 核心規範（16 個檔案）
+├── core/                  # 核心規範（22 個檔案）
 ├── skills/                # AI 工具技能
-│   └── claude-code/       # Claude Code 技能（15 個技能）
+│   └── claude-code/       # Claude Code 技能（23 個技能）
 ├── cli/                   # Node.js CLI 工具
 │   ├── src/               # 原始碼
 │   ├── tests/             # 測試檔案

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

@@ -1,8 +1,8 @@
 ---
 source: ../../README.md
-source_version: 3.5.0
-translation_version: 3.5.0
-last_synced: 2026-01-15
+source_version: 4.0.0
+translation_version: 4.0.0
+last_synced: 2026-01-20
 status: current
 ---
 
@@ -10,28 +10,23 @@ status: current
 
 > **Language**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 3.5.0-beta.13
-**最後更新**: 2026-01-13
+**版本**: 4.0.0
+**最後更新**: 2026-01-20
 **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
-> **🧪 Beta 注意事項**: 此版本包含實驗性功能，API 在正式版發布前可能會有變動。
-> 如需穩定版本：`npm install universal-dev-standards@3.4.2`
+### 4.0.0 新功能
 
-### 功能可用性
-
-| 功能 | 穩定版 (3.4.2) | Beta 版 (3.5.x) |
-|------|:--------------:|:---------------:|
-| **核心規範** (16 個檔案) | ✅ | ✅ |
-| **Claude Code Skills** (15 個技能) | ✅ | ✅ |
-| **CLI 工具** (`uds init`, `check`, `update`) | ✅ | ✅ |
-| Hash-based 完整性檢查 | ✅ | ✅ |
-| Plugin Marketplace 支援 | ✅ | ✅ |
-| **方法論系統** | ❌ | ✅ 🧪 |
-| `/methodology` 命令 | ❌ | ✅ 🧪 |
-| `/bdd` 命令 | ❌ | ✅ 🧪 |
-| TDD/BDD/SDD/ATDD 工作流程 | ❌ | ✅ 🧪 |
+| 功能 | 說明 |
+|------|------|
+| **雙向推演** | 正向推演 + 反向工程形成完整的規格-程式碼循環 |
+| **6 個新核心規範** | BDD、ATDD、反向工程、正向推演、AI 指令、重構 |
+| **23 個 Skills** | 8 個新技能，包括正向推演、BDD/ATDD 助手、Commands |
+| **24 個斜線命令** | 9 個新命令（`/derive-*`、`/reverse-*`、`/atdd`、`/bdd`）|
+| **每工具安裝層級** | Skills/Commands 支援每個 AI 工具的使用者或專案層級 |
+| **增強 CLI** | Debug 旗標、拒絕功能記憶、檔案完整性追蹤 |
+| **方法論系統** | TDD/BDD/SDD/ATDD 工作流程現已正式發布 |
 
-> 🧪 = 實驗性功能，API 可能會變動
+> **4.0 新功能**：雙向推演帶來完整的規格-程式碼生命週期管理，包含正向推演和反向工程。
 
 ---
 
@@ -88,7 +83,7 @@ cp core/commit-message-guide.md your-project/.standards/
 | Cursor | `uds init` → `.cursorrules` | ❌ 僅 Rules | - |
 | Google Antigravity | `uds init` → `INSTRUCTIONS.md` | - | - |
 
-> **v3.5.0 新功能**：`uds init` 支援多 Agent Skills 安裝。可同時選擇多個 agents 安裝 Skills。Gemini CLI 命令會自動轉換為 TOML 格式。
+> **v4.0.0 新功能**：`uds init` 支援每工具安裝層級選擇（使用者或專案層級）。雙向推演系統（正向推演 + 反向工程）現已可用。
 
 ---
 
@@ -112,20 +107,15 @@ uds skills  # 列出已安裝的技能
 npx universal-dev-standards init
 ```
 
-**Beta 版本（最新功能）**
+**特定版本**
 ```bash
-# 全域安裝 beta 版
-npm install -g universal-dev-standards@beta
+# 安裝特定版本
+npm install -g universal-dev-standards@4.0.0
 
-# 或安裝特定版本
-npm install -g universal-dev-standards@3.5.0-beta.13
-
-# 或透過 npx
-npx universal-dev-standards@beta init
+# 或安裝 beta 版以獲得即將推出的功能
+npm install -g universal-dev-standards@beta
 ```
 
-> **注意**：Beta 版本包含實驗性功能，例如方法論系統（`/methodology`、`/bdd`）。詳見[功能可用性](#功能可用性)。
-
 **克隆並連結（開發用）**
 
 macOS / Linux：
@@ -168,7 +158,7 @@ cd universal-dev-standards\cli; npm install; npm link
 
 Agent Skills 是增強 AI 輔助開發的互動式指令（`/commit`、`/tdd`、`/review` 等）。Skills 遵循 [Agent Skills 標準](https://agentskills.io)，可跨多個 AI 工具使用。
 
-**包含的技能（15 個）：** ai-collaboration-standards、changelog-guide、code-review-assistant、commit-standards、documentation-guide、error-code-guide、git-workflow-guide、logging-guide、project-structure-guide、release-standards、requirement-assistant、spec-driven-dev、tdd-assistant、test-coverage-assistant、testing-guide
+**包含的技能（23 個）：** ai-collaboration-standards、atdd-assistant、bdd-assistant、changelog-guide、checkin-assistant、code-review-assistant、commands、commit-standards、documentation-guide、error-code-guide、forward-derivation、git-workflow-guide、logging-guide、methodology-system、project-structure-guide、refactoring-assistant、release-standards、requirement-assistant、reverse-engineer、spec-driven-dev、tdd-assistant、test-coverage-assistant、testing-guide
 
 #### 支援的工具
 
@@ -189,7 +179,7 @@ Claude Code 用戶可透過 Plugin Marketplace 最簡單地安裝：
 **優點：**
 - 單一指令安裝
 - 新版本發布時自動更新
-- 所有 15 個技能立即載入
+- 所有 22 個技能立即載入
 
 **從 v3.2.x 遷移？** 如果您使用舊的 marketplace 名稱：
 
@@ -284,7 +274,7 @@ Remove-Item -Recurse $env:TEMP\uds
 
 ```
 universal-dev-standards/
-├── core/                    # 核心通用標準（16 個檔案）
+├── core/                    # 核心通用標準（22 個檔案）
 ├── ai/                      # AI 優化標準（.ai.yaml）
 ├── options/                 # 人類可讀選項指南
 ├── skills/                  # AI 工具技能（Claude Code 等）
@@ -556,6 +546,8 @@ cp integrations/openspec/commands/* your-project/.claude/commands/
 
 | 版本 | 日期 | 重點 |
 |------|------|------|
+| 4.0.0 | 2026-01-20 | 雙向推演；6 個新核心規範；22 個技能 |
+| 3.5.0 | 2026-01-15 | 多 Agent Skills；Gemini CLI TOML；i18n 支援 |
 | 3.2.2 | 2026-01-06 | 新增 `uds skills` 指令；棄用手動安裝腳本 |
 | 3.2.0 | 2026-01-02 | Plugin Marketplace 支援；CLI 增強 |
 | 3.0.0 | 2025-12-30 | 完整 Windows 支援；AI 優化標準；npm 發布 |
@@ -608,8 +600,11 @@ cp integrations/openspec/commands/* your-project/.claude/commands/
 
 ```
 universal-dev-standards/
-├── core/                                  # 核心通用標準（16 個檔案）
+├── core/                                  # 核心通用標準（22 個檔案）
+│   ├── acceptance-test-driven-development.md # ATDD 方法論
+│   ├── ai-instruction-standards.md       # AI 指令撰寫指南
 │   ├── anti-hallucination.md             # AI 協作指南
+│   ├── behavior-driven-development.md    # BDD 方法論
 │   ├── changelog-standards.md            # 變更日誌撰寫指南
 │   ├── checkin-standards.md              # 程式碼簽入品質門檻
 │   ├── code-review-checklist.md          # 程式碼審查指南
@@ -617,16 +612,19 @@ universal-dev-standards/
 │   ├── documentation-structure.md        # 文件組織
 │   ├── documentation-writing-standards.md # 文件撰寫指南
 │   ├── error-code-standards.md           # 錯誤碼規範
+│   ├── forward-derivation-standards.md   # 正向推演標準
 │   ├── git-workflow.md                   # Git 分支策略
 │   ├── logging-standards.md              # 日誌標準
 │   ├── project-structure.md              # 專案目錄規範
+│   ├── refactoring-standards.md          # 重構標準
+│   ├── reverse-engineering-standards.md  # 反向工程標準
 │   ├── spec-driven-development.md        # SDD 方法論與標準
 │   ├── test-completeness-dimensions.md   # 測試完整度維度
 │   ├── test-driven-development.md        # TDD 方法論
 │   ├── testing-standards.md              # 測試標準（UT/IT/ST/E2E）
 │   └── versioning.md                     # 語意化版本控制指南
 │
-├── ai/                             # AI 優化標準（v2.3.0）
+├── ai/                             # AI 優化標準
 │   ├── standards/                 # Token 高效 YAML 格式（減少約 80%）
 │   │   ├── git-workflow.ai.yaml
 │   │   ├── commit-message.ai.yaml
@@ -644,8 +642,8 @@ universal-dev-standards/
 │   ├── testing/                   # 測試層級指南
 │   └── project-structure/         # 語言特定專案結構
 │
-├── skills/                         # AI 工具技能（v2.1.0）
-│   ├── claude-code/               # Claude Code Skills（15 個技能）
+├── skills/                         # AI 工具技能
+│   ├── claude-code/               # Claude Code Skills（22 個技能）
 │   ├── cursor/                    # Cursor Rules（規劃中）
 │   ├── windsurf/                  # Windsurf Rules（規劃中）
 │   ├── cline/                     # Cline Rules（規劃中）