universal-dev-standards 5.0.0-rc.1 → 5.0.0-rc.2

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

@@ -6,63 +6,13 @@
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 5.0.0-beta.12 (Pre-release) | **发布日期**: 2026-02-11 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.0.0-rc.2 (Pre-release) | **发布日期**: 2026-02-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
-语言无关、框架无关的软件项目文档标准。确保不同技术栈之间的一致性、质量和可维护性。
+语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 
 ---
 
-## 功能特色
-
-<!-- UDS_STATS_TABLE_START -->
-| 类别 | 数量 | 说明 |
-|----------|-------|-------------|
-| **核心标准** | 32 | 通用开发准则 |
-| **AI Skills** | 27 | 互动式技能 |
-| **斜线命令** | 30 | 快速操作 |
-| **CLI 命令** | 6 | list, init, configure, check, update, skills |
-<!-- UDS_STATS_TABLE_END -->
-
----
-
-## Beta 安装指南
-
-> **这是预发布版本。** 功能可能在正式发布前有所变更。如遇到任何问题，请[报告 issue](https://github.com/AsiaOstrich/universal-dev-standards/issues)。
-
-### 安装 Beta
-
-```bash
-# 全局安装最新 beta
-npm install -g universal-dev-standards@beta
-
-# 或安装特定 beta 版本
-npm install -g universal-dev-standards@5.0.0-beta.12
-
-# 无需安装直接使用
-npx universal-dev-standards@beta init
-```
-
-### 降级回稳定版
-
-```bash
-npm install -g universal-dev-standards@latest
-```
-
-### 5.0 Beta 新功能
-
-| 功能 | 说明 |
-|------|------|
-| **32 个核心标准** | 新增 10 个标准，包含安全性、性能、无障碍、需求工程 |
-| **26 Skills / 30 Commands** | 新增 `/requirement`、`/security`、`/perf` 命令 |
-| **开发者记忆** | 跨工作会话的持久记忆（`.standards/developer-memory.ai.yaml`） |
-| **增强 i18n** | 提交语言偏好设置、改进简体中文支持 |
-| **配置统一** | `uds config` 合并偏好设置 + 项目配置 |
-
-完整 beta 版本记录请参阅 [CHANGELOG.md](../../CHANGELOG.md)。
-
----
-
-## 快速开始
+## 🚀 快速开始
 
 ### 通过 npm 安装（推荐）
 
@@ -83,387 +33,134 @@ uds init
 npx universal-dev-standards init
 ```
 
-### 手动设置
-
-若不使用 npm 的手动设置方式，请参阅下方[安装方式](#安装方式)。
-
 > **注意**：仅复制标准文件不会启用 AI 协助功能。请使用 `uds init` 自动配置 AI 工具，或手动在工具配置文件中引用标准。
 
 ---
 
-## 安装方式
+## ✨ 功能特色
 
-### CLI 工具（主要方式）
+<!-- UDS_STATS_TABLE_START -->
+| 类别 | 数量 | 说明 |
+|----------|-------|-------------|
+| **核心标准** | 32 | 通用开发准则 |
+| **AI Skills** | 27 | 互动式技能 |
+| **斜线命令** | 30 | 快速操作 |
+| **CLI 命令** | 6 | list, init, configure, check, update, skills |
+<!-- UDS_STATS_TABLE_END -->
 
-**npm（推荐）**
-```bash
-npm install -g universal-dev-standards
-uds init    # 交互式初始化
-uds check   # 检查采用状态
-uds update  # 更新至最新版本
-uds skills  # 列出已安装的 skills
-```
+### 5.0 Beta 新功能
 
-**npx（无需安装）**
-```bash
-npx universal-dev-standards init
-```
+| 功能 | 说明 |
+| :--- | :--- |
+| **32 个核心标准** | 新增 10 个标准，包含安全性、性能、无障碍 |
+| **26 Skills / 30 Commands** | 新增 `/requirement`、`/security`、`/perf` 命令 |
+| **开发者记忆** | 跨工作会话的持久记忆（`.standards/developer-memory.ai.yaml`） |
+| **增强 i18n** | 提交语言偏好设置、改进简体中文支持 |
 
-**特定版本**
-```bash
-npm install -g universal-dev-standards@5.0.0-beta.12  # 最新 beta
-npm install -g universal-dev-standards@beta            # 始终获取最新 beta
-npm install -g universal-dev-standards@latest           # 稳定版
-```
+---
 
-**Clone 并链接（开发用）**
+## 🏗️ 系统架构
 
-macOS / Linux:
-```bash
-git clone https://github.com/AsiaOstrich/universal-dev-standards.git
-cd universal-dev-standards/cli && npm install && npm link
-```
+UDS 采用 **双层执行模型 (Dual-Layer Execution Model)**，专为高速互动开发与深度技术合规而设计。
 
-Windows (PowerShell):
-```powershell
-git clone https://github.com/AsiaOstrich/universal-dev-standards.git
-cd universal-dev-standards\cli; npm install; npm link
+```mermaid
+graph TD
+    A[AI 助手 / 开发者] --> B{执行层}
+    B -- "日常任务" --> C[技能层 Skills (.ai.yaml)]
+    B -- "深度审查" --> D[标准层 Standards (.md)]
+    
+    C --> C1[Token 优化]
+    C --> C2[互动式引导]
+    
+    D --> D1[完整理论与定义]
+    D --> D2[工具自动化配置]
+    
+    C1 -. "回退机制" .-> D1
 ```
 
----
-
-## AI 工具支持
-
-| AI 工具 | 状态 | Skills | 斜线命令 (Slash Commands) | 配置文件 |
-|---------|--------|:------:|:--------------:|----------|
-| **Claude Code** | ✅ 完整支持 | **26** | **30** (如 `/tdd`, `/review`) | `CLAUDE.md` |
-| **OpenCode** | ✅ 完整支持 | **26** | **30** (如 `/sdd`, `/commit`) | `AGENTS.md` |
-| **Gemini CLI** | 🧪 预览版 | **18+** | **20+** (如 `/derive`, `/config`) | `GEMINI.md` |
-| **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** (`/review`, `/refactor`) | `.cursorrules` |
-| **Cline / Roo Code**| 🔶 部分支持 | **核心** | **工作流** (`/checkin`, `/tdd`) | `.clinerules` |
-| GitHub Copilot | 🔶 部分支持 | ✅ | **对话式** (`commit`, `review`) | `copilot-instructions.md` |
-| OpenAI Codex | 🔶 部分支持 | ✅ | - | `AGENTS.md` |
-| Windsurf | 🔶 部分支持 | ✅ | **规则书** (`/sdd`, `/refactor`) | `.windsurfrules` |
-| Antigravity | 📄 最小支持 | - | - | `INSTRUCTIONS.md` |
-
-> **状态图例**（UDS CLI 实现状态）：
-> - ✅ 完整支持 = Skills + Commands 完整支持，已测试
-> - 🔶 部分支持 = Skills 可用，Commands 受限或不支持
-> - 🧪 预览版 = 功能可用但为预览版本
-> - ⏳ 计划中 = 代码存在，待测试
-> - 📄 最小支持 = 仅规则文件生成，不支持 Skills/Commands
-
-### 平台支持
-
-| 平台 | 状态 | 备注 |
-|------|------|------|
-| **macOS** | ✅ 已测试 | 主要开发平台 |
-| **Linux** | ⚠️ 未测试 | 预期可运行（基于 Node.js） |
-| **Windows** | ⚠️ 未测试 | 提供 PowerShell 脚本 |
-
-请参阅 [Windows 指南](../../docs/WINDOWS-GUIDE.md)了解平台特定说明。
+| 面向 | 技能层 Skills (执行层) | 核心标准 Standards (知识库) |
+| :--- | :--- | :--- |
+| **格式** | YAML 优化 | 完整 Markdown |
+| **目标** | 高速互动与快速查询 | 深度理解与理论依据 |
+| **Token 使用** | 极小（AI 友好） | 详细（参考文献） |
 
 ---
 
-## Skills 安装
+## 🤖 AI 工具支持
 
-### 方法 1：Claude Code Plugin Marketplace（最简单）
+| AI 工具 | 状态 | Skills | 斜线命令 | 配置文件 |
+| :--- | :--- | :---: | :---: | :--- |
+| **Claude Code** | ✅ 完整支持 | **26** | **30** | `CLAUDE.md` |
+| **OpenCode** | ✅ 完整支持 | **26** | **30** | `AGENTS.md` |
+| **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |
+| **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** | `.cursorrules` |
+| **Cline / Roo Code**| 🔶 部分支持 | **核心** | **工作流** | `.clinerules` |
+| **Windsurf** | 🔶 部分支持 | ✅ | **规则书** | `.windsurfrules` |
 
-```bash
-/plugin install universal-dev-standards@asia-ostrich
-```
+> **状态图例**：✅ 完整支持 | 🧪 預覽版 | 🔶 部分支持 | ⏳ 计划中
 
-**优点**：单一命令、自动更新、立即加载全部 26 个 skills。
+---
 
-**从 v3.x 升级？**
-```bash
-/plugin uninstall universal-dev-standards@universal-dev-standards
-/plugin install universal-dev-standards@asia-ostrich
-```
+## 📦 安装方式
 
-### 方法 2：UDS CLI
+### CLI 工具（主要方式）
 
+**npm（推荐）**
 ```bash
 npm install -g universal-dev-standards
-uds init  # 选择 AI 工具，skills 自动安装
+uds init    # 交互式初始化
+uds check   # 检查采用状态
+uds update  # 更新至最新版本
 ```
 
-使用 `uds check` 验证安装状态。
-
-### 方法 3：手动安装
+### 预发布版本 (Pre-release)
 
-macOS / Linux:
 ```bash
-git clone https://github.com/AsiaOstrich/universal-dev-standards.git /tmp/uds
-cp -r /tmp/uds/skills/* ~/.claude/skills/    # 全局
-# 或: cp -r /tmp/uds/skills/* .claude/skills/  # 项目
-rm -rf /tmp/uds
-```
+# 安装最新 RC (Release Candidate)
+npm install -g universal-dev-standards@rc
 
-Windows (PowerShell):
-```powershell
-git clone https://github.com/AsiaOstrich/universal-dev-standards.git $env:TEMP\uds
-Copy-Item -Recurse $env:TEMP\uds\skills\claude-code\* $env:USERPROFILE\.claude\skills\
-Remove-Item -Recurse $env:TEMP\uds
+# 安装最新 Beta
+npm install -g universal-dev-standards@beta
 ```
 
-### 社区市集
-
-- **[n-skills](https://github.com/numman-ali/n-skills)** - Claude Code、OpenCode、Cursor 精选市集
-- **[claude-plugins.dev](https://claude-plugins.dev/skills)** - 自动索引的 skill 探索
-- **[agentskills.io](https://agentskills.io)** - 官方 Agent Skills 规范
-
----
-
-## 使用模式
-
-| 模式 | 最适合 | 主要优势 |
-|------|--------|----------|
-| **仅 Skills** | 个人开发者 + Claude Code | 最低 token 使用量、最佳互动体验 |
-| **仅标准** | 多工具团队 / 企业 | 完整自定义、版本控制 |
-| **Skills + 标准** | 完整体验 / 学习 | 100% 功能覆盖 |
-
----
-
-## 选择您的路径
-
-根据您的角色与需求开始使用 UDS：
-
-### 🚀 个人开发者 (快速开始)
-- **目标**：利用 AI 协助进行高速开发。
-- **路径**：[仅 Skills 模式](#使用模式)。
-- **工具**：Claude Code 或 OpenCode。
-- **行动**：`/plugin install universal-dev-standards@asia-ostrich`。
-
-### 🏗️ 架构师 / 技术主管 (标准优先)
-- **目标**：建立技术边界并确保跨团队质量。
-- **路径**：[仅标准模式](#使用模式)。
-- **工具**：任何 AI 编码助手。
-- **行动**：`uds init -m full --level 2`。
-
-### 🛡️ 企业 / DevOps (治理优先)
-- **目标**：合规性、安全审计与自动化质量门槛。
-- **路径**：[Skills + 标准模式](#使用模式)。
-- **工具**：多工具环境 + CI/CD。
-- **行动**：`uds init -m full --level 3`。
-
----
-
-## 核心标准概览
-
-> **更新 (v4.3.0)**：核心标准已针对 AI Token 使用量进行最佳化。
-> - **规则 (`core/*.md`)**：供 AI 验证使用的精简检查清单与规则。
-> - **指南 (`core/guides/*.md`)**：供人类阅读的详细解释与教学。
-
-### 等级一：基本（30 分钟设置）
-
-每个项目必须包含：
-
-| 标准 | 说明 |
-|------|------|
-| `anti-hallucination.md` | AI 协作准则 |
-| `checkin-standards.md` | 提交前质量检查 |
-| `commit-message-guide.md` | Conventional Commits 格式 |
-| `spec-driven-development.md` | 规格优先方法 |
-
-### Level 2：推荐（2 小时设置）
-
-包含 Level 1 加上：
-
-| 标准 | 说明 |
-|------|------|
-| `git-workflow.md` | 分支策略（GitHub Flow、GitFlow、Trunk-Based） |
-| `code-review-checklist.md` | 系统化审查准则 |
-| `versioning.md` | 语义化版本（SemVer） |
-| `changelog-standards.md` | Keep a Changelog 格式 |
-| `testing-standards.md` | 测试金字塔（70/20/7/3） |
-| `test-driven-development.md` | TDD 方法论 |
-| `behavior-driven-development.md` | BDD 与 Given-When-Then |
-
-### Level 3：全面（1-2 天设置）
-
-包含 Level 2 加上：
-
-| 标准 | 说明 |
-|------|------|
-| `documentation-structure.md` | 文档组织 |
-| `project-structure.md` | 目录惯例 |
-| `acceptance-test-driven-development.md` | ATDD 方法论 |
-| `refactoring-standards.md` | 安全重构实务 |
-
-完整指引请参阅[采用指南](../../adoption/ADOPTION-GUIDE.md)。
-
----
-
-## 自定义
-
-### 自定义文件位置
-
-| 类型 | 文件 | 位置 |
-|------|------|------|
-| AI 工具规则 | `CLAUDE.md`、`.cursorrules` 等 | 项目根目录 |
-| 项目覆盖 | `PROJECT-STANDARDS.md` | 项目根目录 |
-| 复制的标准 | `docs/standards/` | 您的项目 |
-
-### 调整标准
-
-1. **语言**：英文、繁体中文或简体中文提交类型
-2. **工具**：配置构建命令（`npm`、`dotnet`、`mvn` 等）
-3. **阈值**：调整测试覆盖率、方法长度限制
-4. **范围**：定义模块允许的提交范围
-
-### 排除标准
-
-- **执行 `uds init` 时**：交互式选择需要的标准
-- **选择性采用**：仅复制特定文件
-- **AI 工具排除**：在 `CLAUDE.md` 或 `.cursorrules` 中添加模式
-
----
-
-## 贡献
-
-### 如何贡献
+### 源码安装（开发用）
 
-1. **建议改进**：开立 issue 说明问题与解决方案
-2. **添加示例**：提交实际使用示例
-3. **扩展标准**：贡献语言/框架/领域扩展
-4. **翻译**：协助翻译成其他语言
-
-### 准则
-
-- 核心标准保持语言/框架无关性
-- 至少在 2 個不同情境中包含示例
-- 遵循现有文档结构
-- 采用 CC BY 4.0 授权
-
-詳細準則請參閱 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
-
----
-
-## 常见问题
-
-### 如何选择「仅 Skills」还是「仅标准」？
-
-- **仅 Skills**：最适合使用 Claude Code 的个人开发者，想要以最少设置获得交互式 AI 协助
-- **仅标准**：最适合使用多个 AI 工具或需要企业合规与完整版本控制的团队
-
-### 可以只采用部分标准吗？
-
-可以！执行 `uds init` 并选择需要的标准。也可以从 `core/` 手动复制特定文件。
-
-### 如何更新已安装的 skills？
-
-Plugin Marketplace：Skills 会自动更新或使用 `/plugin update`。
-CLI 安装：执行 `uds update --skills`。
-
-### UDS 支持 Windows 吗？
-
-支持。CLI 基于 Node.js，可在所有平台运行。PowerShell 特定说明请参阅 [Windows 指南](../../docs/WINDOWS-GUIDE.md)。
-
-### 核心标准和 skills 有什么不同？
-
-- **核心标准**：定义最佳实务的文档（Markdown）- 参考资料
-- **Skills**：实现这些标准的交互式 AI 命令 - 主动协助
-
-### 为什么有些 AI 工具标示为「计划中」？
-
-我们提供这些工具的配置文件，但完整集成测试尚待进行。配置应该可以运行，但可能存在边缘案例。
-
----
-
-## 延伸阅读
-
-### 相关标准
-
-- [Conventional Commits](https://www.conventionalcommits.org/)
-- [Semantic Versioning](https://semver.org/)
-- [Keep a Changelog](https://keepachangelog.com/)
-- [Google Engineering Practices](https://google.github.io/eng-practices/)
-
-### 推荐书籍
-
-- **The Art of Readable Code** - Boswell & Foucher
-- **Clean Code** - Robert C. Martin
-- **The Pragmatic Programmer** - Hunt & Thomas
-- **Accelerate** - Forsgren, Humble & Kim
-
----
-
-## 版本历史
-
-| 版本 | 日期 | 重点 |
-|------|------|------|
-| **4.1.0** | 2026-01-21 | 增强重构标准 |
-| **4.0.0** | 2026-01-20 | 双向推导；6 个新核心标准 |
-| 3.5.0 | 2026-01-15 | 多代理 Skills；Gemini CLI；i18n |
-| 3.2.2 | 2026-01-06 | `uds skills` 命令 |
-| 3.0.0 | 2025-12-30 | Windows 支持；npm 发布 |
-
-完整历史请参阅 [CHANGELOG.md](../../CHANGELOG.md)。
+```bash
+git clone https://github.com/AsiaOstrich/universal-dev-standards.git
+cd universal-dev-standards/cli && npm install && npm link
+```
 
 ---
 
-## 4.x 新功能
-
-### 4.1.0 重点
+## ⚙️ 设置
 
-- 增强重构标准，包含战术、策略和遗留代码安全策略
-- 选择重构方法的决策矩阵
+使用 `uds config` 管理您的偏好设置：
 
-### 4.0.0 重点
-
-| 功能 | 说明 |
-|------|------|
-| **双向推导** | Forward Derivation + Reverse Engineering 实现完整规格-代码生命週期 |
-| **6 個新核心標準** | BDD、ATDD、Reverse Engineering、Forward Derivation、AI Instructions、Refactoring |
-| **26 Skills** | 7 個新 skills 包括 Forward Derivation、BDD/ATDD assistants |
-| **30 Slash Commands** | 9 個新指令（`/derive-*`、`/reverse-*`、`/atdd`、`/bdd`） |
-| **方法論系統** | TDD/BDD/SDD/ATDD 工作流已達生產就緒 |
+| 参数 | 命令示例 | 说明 |
+| :--- | :--- | :--- |
+| **提交语言** | `uds config --lang zh-CN` | 设置 AI 提交消息的偏好语言 |
+| **标准等级** | `uds init --level 2` | 选择采用深度 (1: 基本, 3: 全面) |
+| **工具模式** | `uds config --mode skills` | 在 Skills、Standards 或两者之间切换 |
 
 ---
 
-## 授权
+## 👥 贡献
 
-| 组件 | 授权 | 允许 |
-|------|------|------|
-| 文档 | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | 商业使用、修改、带署名的再发布 |
-| CLI 工具 | [MIT](../../cli/LICENSE) | 商业使用、修改、再发布 |
+1. **建议改进**：开立 issue 说明问题与解决方案。
+2. **添加示例**：提交实际使用示例。
+3. **扩展标准**：贡献语言/框架/领域扩展。
 
-完整详情请参阅 [LICENSE](../../LICENSE)。
+详细准则请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
 
 ---
 
-### 目录结构
+## 📄 授权
 
-```
-universal-dev-standards/
-├── core/                    # 核心规则与检查清单（轻量化）
-│   ├── guides/              # 详细指南与教学
-│   ├── anti-hallucination.md
-│   ├── commit-message-guide.md
-│   └── ...
-├── methodologies/           # 方法论指南 (TDD, BDD, SDD)
-│   └── guides/              # 详细方法论教学
-├── ai/                      # AI 最佳化格式（.ai.yaml）
-├── skills/                  # AI 工具 skills
-│   └── claude-code/         # 26 個 skill 目錄
-├── extensions/              # 语言/框架扩展
-│   ├── languages/           # csharp-style.md、php-style.md
-│   └── frameworks/          # fat-free-patterns.md
-├── integrations/            # AI 工具配置
-│   ├── cursor/              # .cursorrules
-│   ├── windsurf/            # .windsurfrules
-│   └── ...
-├── cli/                     # CLI 工具（uds 命令）
-├── locales/                 # 翻译
-│   ├── zh-TW/               # 繁体中文
-│   └── zh-CN/               # 简体中文
-├── templates/               # 文档模板
-└── adoption/                # 采用指南
-```
+| 组件 | 授权 |
+| :--- | :--- |
+| **文档内容** | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
+| **CLI 工具** | [MIT](../../cli/LICENSE) |
 
 ---
 
-**准备好提升项目品质了吗？** 从[快速开始](#快速开始)开始！
-
 **由开源社区用 ❤️ 维护**