universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-CN/options/testing/unit-testing.md

@@ -0,0 +1,165 @@
+---
+source: ../../../../options/testing/unit-testing.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 单元测试
+
+> **语言**: [English](../../../../options/testing/unit-testing.md) | 繁体中文
+
+**上层标准**: [测试指南](../../core/testing.md)
+
+---
+
+## 概述
+
+单元测试验证程式码的个别单元（函式、方法、类别）在隔离状态下正确运作。单元测试是测试金字塔的基础，提供快速回馈并实现安全的重构。
+
+## 特性
+
+| 属性 | 值 |
+|------|------|
+| 范围 | 单一函式、方法或类别 |
+| 相依性 | 模拟或替身 |
+| 执行速度 | 毫秒等级 |
+| 隔离性 | 完全隔离于外部系统 |
+| 数量 | 最多的测试 |
+
+## 适用情境
+
+- 测试纯函式和业务逻辑
+- 验证边界案例和错误处理
+- 实现安全重构
+- 记录程式码行为
+- 快速的 CI/CD 回馈
+
+## 测试金字塔位置
+
+```
+        /\
+       /  \      E2E 测试（少）
+      /----\
+     /      \    整合测试（中）
+    /--------\
+   /          \  单元测试（多）← 这一层
+  /------------\
+```
+
+## 结构：Arrange-Act-Assert
+
+```javascript
+// JavaScript/TypeScript 范例
+describe('calculateDiscount', () => {
+  it('should apply 10% discount for orders over $100', () => {
+    // Arrange（安排）
+    const orderTotal = 150;
+    const discountThreshold = 100;
+    const discountRate = 0.10;
+
+    // Act（执行）
+    const result = calculateDiscount(orderTotal, discountThreshold, discountRate);
+
+    // Assert（验证）
+    expect(result).toBe(15);
+  });
+});
+```
+
+## 应该测试什么
+
+### 应该测试
+
+| 类别 | 范例 |
+|------|------|
+| 纯函式 | 数学计算、字串转换 |
+| 业务逻辑 | 验证规则、价格计算 |
+| 边界案例 | 空阵列、null 值、边界条件 |
+| 错误条件 | 无效输入、例外抛出 |
+| 状态转换 | 物件状态变更 |
+
+### 不应该测试
+
+| 类别 | 原因 |
+|------|------|
+| 私有方法 | 透过公开介面测试 |
+| 框架程式码 | 已被框架测试 |
+| 简单 getter/setter | 无逻辑可验证 |
+| 外部系统 | 使用整合测试 |
+
+## 模拟指南
+
+### 何时使用模拟
+
+```javascript
+// 模拟外部相依性
+const mockDatabase = {
+  findUser: jest.fn().mockResolvedValue({ id: 1, name: 'Test' })
+};
+
+const userService = new UserService(mockDatabase);
+```
+
+### 何时不使用模拟
+
+- 不要模拟被测试的单元
+- 不要模拟简单的值物件
+- 不要模拟所有东西——某些真实物件是可以的
+
+## 测试命名惯例
+
+```javascript
+// 行为导向
+it('should return null when user is not found')
+// 当找不到使用者时应该回传 null
+
+// Given-When-Then
+it('given an invalid email, when validating, then throws ValidationError')
+// 给定无效的 email，当验证时，抛出 ValidationError
+
+// Method_Scenario_Expectation
+it('validateEmail_withInvalidFormat_throwsError')
+```
+
+## 覆盖率指南
+
+| 指标 | 目标 | 备注 |
+|------|------|------|
+| 行覆盖率 | 80%+ | 最低门槛 |
+| 分支覆盖率 | 75%+ | 覆盖条件路径 |
+| 函式覆盖率 | 90%+ | 所有公开函式 |
+| 关键路径 | 100% | 付款、验证、资料处理 |
+
+### 覆盖率注意事项
+
+- 高覆盖率 ≠ 好测试
+- 专注于有意义的测试，而非覆盖率数字
+- 关键程式码值得 100% 覆盖
+- 不要只为了覆盖率测试琐碎程式码
+
+## 常见框架
+
+| 语言 | 框架 | 备注 |
+|------|------|------|
+| JavaScript | Jest | 最受欢迎，内建模拟 |
+| JavaScript | Vitest | 快速，Vite 相容 |
+| Python | pytest | 弹性，丰富插件 |
+| Java | JUnit 5 | Java 标准 |
+| C# | xUnit | 现代、可扩展 |
+| Go | testing | 内建套件 |
+
+## 相关选项
+
+- [整合测试](./integration-testing.md) - 测试元件互动
+- [系统测试](./system-testing.md) - 测试完整系统
+- [E2E 测试](./e2e-testing.md) - 测试使用者流程
+
+---
+
+## 授权条款
+
+本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md

@@ -0,0 +1,218 @@
+---
+source: ../../../skills/INTEGRATION-GUIDE.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 技能集成指南
+
+本指南说明如何在开发工作流程中集成使用多个技能。
+
+## 概览
+
+通用开发标准提供 14 个 Claude Code 技能，共同支援完整的开发生命周期：
+
+```
+规划 → 编码 → 测试 → 审查 → 提交 → 发布
+  │      │      │      │      │      │
+  ▼      ▼      ▼      ▼      ▼      ▼
+需求   专案   测试   程序码  提交   发布
+助手   结构   指南   审查   标准   标准
+```
+
+## 技能互动矩阵
+
+| 来源技能 → | 目标技能 | 互动方式 |
+|------------|----------|----------|
+| 需求助手 | 全部 | 需求影响所有决策 |
+| 专案结构 | 测试指南 | 测试位置遵循结构 |
+| 测试指南 | 程序码审查 | 审查检查测试覆盖 |
+| 程序码审查 | 提交标准 | 审查通过后才能提交 |
+| 提交标准 | 发布标准 | 提交决定版本号 |
+| Git 工作流程 | 全部 | 分支策略影响所有 |
+
+## 工作流程场景
+
+### 场景 1：新功能开发
+
+```mermaid
+graph LR
+    A[需求] --> B[专案结构]
+    B --> C[撰写程序码]
+    C --> D[测试指南]
+    D --> E[程序码审查]
+    E --> F[提交标准]
+    F --> G[Git 工作流程]
+```
+
+**使用的技能**：
+1. **需求助手** - 厘清功能需求
+2. **专案结构** - 决定档案位置
+3. **测试指南** - 为新功能撰写测试
+4. **程序码审查** - 取得程序码审查
+5. **提交标准** - 撰写正确的提交讯息
+6. **Git 工作流程** - 透过正确的分支策略合并
+
+### 场景 2：错误修正
+
+```mermaid
+graph LR
+    A[识别错误] --> B[撰写测试]
+    B --> C[修正程序码]
+    C --> D[审查]
+    D --> E[提交]
+```
+
+**使用的技能**：
+1. **测试指南** - 先撰写失败的测试
+2. **程序码审查** - 快速审查修正
+3. **提交标准** - 使用 `fix:` 类型
+4. **Git 工作流程** - 建立 `fix/` 分支
+
+### 场景 3：发布准备
+
+```mermaid
+graph LR
+    A[汇整变更] --> B[更新版本]
+    B --> C[更新变更日志]
+    C --> D[建立标签]
+    D --> E[发布]
+```
+
+**使用的技能**：
+1. **提交标准** - 审查提交历史
+2. **发布标准** - 决定版本升级
+3. **文件指南** - 更新变更日志
+4. **Git 工作流程** - 标签与发布
+
+## 技能优先顺序解析
+
+当多个技能适用时，使用此优先顺序：
+
+| 优先 | 类别 | 技能 |
+|------|------|------|
+| 1 | 安全 | AI 协作（防幻觉） |
+| 2 | 正确性 | 测试指南、程序码审查 |
+| 3 | 流程 | Git 工作流程、提交标准 |
+| 4 | 文件 | 文件指南、发布标准 |
+| 5 | 指引 | 需求助手、专案结构 |
+
+## 常见技能组合
+
+### 程序码品质组合
+
+同时使用以获得高品质程序码：
+- **测试指南** + **程序码审查**
+- 确保测试存在且程序码已审查
+
+### 发布组合
+
+同时使用以正确发布：
+- **提交标准** + **发布标准** + **Git 工作流程**
+- 确保正确的版本控制和变更日志
+
+### 新专案组合
+
+启动专案时同时使用：
+- **专案结构** + **文件指南** + **Git 工作流程**
+- 建立正确的基础
+
+## 冲突解决
+
+### 测试 vs 速度
+
+**冲突**：需要快速交付但测试指南要求覆盖率
+
+**解决方式**：
+1. 撰写关键路径测试（测试指南）
+2. 记录技术债（文件指南）
+3. 使用适当的提交类型（提交标准）
+
+### 审查 vs 紧急
+
+**冲突**：紧急修正需要立即部署
+
+**解决方式**：
+1. 使用加速审查（程序码审查 - 紧急流程）
+2. 建立 hotfix 分支（Git 工作流程）
+3. 记录例外（文件指南）
+
+## 依活动触发技能
+
+| 活动 | 主要技能 | 支援技能 |
+|------|----------|----------|
+| 启动新专案 | 专案结构 | Git 工作流程、文件 |
+| 新增功能 | 需求助手 | 测试、程序码审查 |
+| 修正错误 | 测试指南 | 程序码审查、提交 |
+| 撰写测试 | 测试指南 | 程序码审查 |
+| 程序码审查 | 程序码审查 | 测试、AI 协作 |
+| 提交程序码 | 提交标准 | Git 工作流程 |
+| 建立 PR | Git 工作流程 | 程序码审查、文件 |
+| 发布 | 发布标准 | Git 工作流程、文件 |
+| 撰写文件 | 文件指南 | - |
+
+## 最佳实践
+
+### 1. 从需求开始
+
+在使用其他技能之前，始终从明确的需求开始：
+```
+使用者故事 → 验收标准 → 实作 → 测试 → 审查
+```
+
+### 2. 提早测试
+
+在程序码审查之前调用测试指南：
+```
+撰写程序码 → 撰写测试 → 自我审查 → 请求审查
+```
+
+### 3. 一致的提交
+
+全程使用提交标准，而非只在最后：
+```
+每个逻辑变更 = 一个具有正确格式的提交
+```
+
+### 4. 记录决策
+
+使用文件指南记录重要决策：
+```
+做出决策 → 记录在 ADR → 在程序码中引用
+```
+
+## 快速参考
+
+### 日常开发
+
+| 任务 | 技能 |
+|------|------|
+| 开始编码 | 专案结构 |
+| 撰写测试 | 测试指南 |
+| 审查程序码 | 程序码审查 |
+| 提交变更 | 提交标准 |
+| 推送到远端 | Git 工作流程 |
+
+### 每周/冲刺任务
+
+| 任务 | 技能 |
+|------|------|
+| 规划功能 | 需求助手 |
+| 审查进度 | 程序码审查 |
+| 更新文件 | 文件指南 |
+
+### 发布任务
+
+| 任务 | 技能 |
+|------|------|
+| 决定版本 | 发布标准 |
+| 更新变更日志 | 发布标准 |
+| 建立发布 | Git 工作流程 |
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2025-12-30 | 初始集成指南 |

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

@@ -0,0 +1,134 @@
+---
+source: ../../../skills/README.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 技能 - AI 编程助手规则
+
+此目录包含各种 AI 编程助手的技能/规则实作，皆衍生自本仓库的核心标准。
+
+## 目录结构
+
+```
+skills/
+├── _shared/           # 共用模板和生成工具
+├── claude-code/       # Claude Code 技能（SKILL.md 格式）
+├── cursor/            # Cursor 规则（.cursorrules、Notepads）
+├── windsurf/          # Windsurf 规则（.windsurfrules）
+├── cline/             # Cline 规则（.clinerules）
+└── copilot/           # GitHub Copilot（copilot-instructions.md）
+```
+
+## 快速开始
+
+### Claude Code
+
+**推荐：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**替代方案：手动复制（macOS / Linux）**
+```bash
+mkdir -p ~/.claude/skills
+cp -r skills/claude-code/commit-standards ~/.claude/skills/
+```
+
+**替代方案：手动安装（Windows PowerShell）**
+```powershell
+# 复制特定技能
+Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
+```
+
+### Cursor
+
+**macOS / Linux:**
+```bash
+# 复制规则到您的专案
+cp skills/cursor/.cursorrules .cursorrules
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item skills\cursor\.cursorrules .cursorrules
+```
+
+### Windsurf
+
+**macOS / Linux:**
+```bash
+cp skills/windsurf/.windsurfrules .windsurfrules
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item skills\windsurf\.windsurfrules .windsurfrules
+```
+
+### Cline
+
+**macOS / Linux:**
+```bash
+cp skills/cline/.clinerules .clinerules
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item skills\cline\.clinerules .clinerules
+```
+
+### GitHub Copilot
+
+**macOS / Linux:**
+```bash
+mkdir -p .github
+cp skills/copilot/copilot-instructions.md .github/copilot-instructions.md
+```
+
+**Windows PowerShell:**
+```powershell
+New-Item -ItemType Directory -Force -Path .github
+Copy-Item skills\copilot\copilot-instructions.md .github\copilot-instructions.md
+```
+
+## 可用技能
+
+| 技能 | 说明 | Claude Code | Cursor | Windsurf | Cline | Copilot |
+|------|------|:-----------:|:------:|:--------:|:-----:|:-------:|
+| AI 协作 | 防止幻觉 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 变更日志指南 | 变更日志撰写 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 程序码审查 | 审查检查表 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 提交标准 | Conventional Commits | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 文件 | README 模板 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 错误码指南 | 错误码标准 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| Git 工作流程 | 分支策略 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 日志指南 | 日志最佳实践 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 专案结构 | 目录规范 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 发布标准 | 语意化版本 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 需求 | 使用者故事指引 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 规格驱动开发 | SDD 方法论 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 测试覆盖率 | 覆盖率分析 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
+| 测试指南 | 测试最佳实践 | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+图例：✅ 完成 | 🚧 计划中 | ❌ 不适用
+
+## 与核心标准的关系
+
+这些技能是核心标准的**互动式实作**：
+
+```
+core/anti-hallucination.md
+    ↓ 转换为
+skills/claude-code/ai-collaboration-standards/SKILL.md
+skills/cursor/.cursorrules（AI 区段）
+```
+
+**重要**：使用技能或复制核心文件——同一标准**不要两者并用**。
+
+## 贡献
+
+请参阅 [CONTRIBUTING.md](../CONTRIBUTING.md) 了解新增技能或支援其他 AI 工具的指南。

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

@@ -0,0 +1,68 @@
+---
+source: ../../../../skills/_shared/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 共用资源
+
+用于从核心标准生成 AI 工具专用规则的共用模板和工具。
+
+## 目的
+
+此目录包含：
+- **模板**：跨不同 AI 工具使用的通用模式
+- **工具**：生成工具专用配置的脚本
+- **对应**：每个 AI 助手的标准对规则对应
+
+## 核心标准对应
+
+| 核心标准 | 技能概念 | 说明 |
+|----------|----------|------|
+| `anti-hallucination.md` | AI 协作 | 证据导向回应、确定性标签 |
+| `commit-message-guide.md` | 提交标准 | Conventional Commits 格式 |
+| `code-review-checklist.md` | 程序码审查 | 审查检查表和模式 |
+| `git-workflow.md` | Git 工作流程 | 分支策略 |
+| `testing-standards.md` | 测试指南 | 测试金字塔、覆盖率 |
+| `versioning.md` | 发布标准 | 语意化版本 |
+| `documentation-structure.md` | 文件 | README 模板、结构 |
+
+## AI 工具相容性矩阵
+
+| 功能 | Claude Code | Cursor | Windsurf | Cline | Copilot |
+|------|-------------|--------|----------|-------|---------|
+| 技能/规则 | ✅ SKILL.md | ✅ .cursorrules | ✅ .windsurfrules | ✅ .clinerules | ✅ instructions.md |
+| 自动触发 | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 专案层级 | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 全域层级 | ✅ | ✅ | ✅ | ✅ | ❌ |
+| Notepads | ❌ | ✅ | ❌ | ❌ | ❌ |
+
+## 使用方式
+
+**macOS / Linux:**
+```bash
+# 为特定工具生成规则
+./generate.sh cursor
+
+# 为所有工具生成规则
+./generate.sh all
+```
+
+**Windows PowerShell:**
+```powershell
+# 为特定工具生成规则
+.\generate.ps1 cursor
+
+# 为所有工具生成规则
+.\generate.ps1 all
+```
+
+## 贡献
+
+新增核心标准时：
+1. 在上方对应表新增条目
+2. 在 `templates/` 建立模板
+3. 更新生成脚本
+4. 用每个支援的 AI 工具测试