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

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

@@ -1,174 +0,0 @@
----
-source: ../../../../skills/claude-code/README.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-07
-status: current
----
-
-# Claude Code Skills
-
-> **语言**: [English](../../../../skills/claude-code/README.md) | 简体中文
-
-软体开发标准的 Claude Code Skills。
-
-> 衍生自 [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) 核心标准。
-
-## 概述
-
-这些技能会根据上下文在使用 Claude Code 时自动觸發，協助您：
-
-- 透過基於证据的响应防止 AI 幻覺
-- 撰写一致且格式良好的提交消息
-- 进行全面的程序码审查
-- 遵循测试最佳实踐
-- 使用語意化版本管理發布
-
-## 可用的 Skills
-
-| Skill | 描述 | 觸發条件 |
-|-------|------|----------|
-| `ai-collaboration-standards` | 防止 AI 幻覺 | 程序码分析、"certainty" |
-| `commit-standards` | Conventional Commits 格式 | "commit"、git 操作 |
-| `code-review-assistant` | 系统化程序码审查 | "review"、"PR" |
-| `testing-guide` | 测试金字塔 | 撰写测试 |
-| `tdd-assistant` | 测试驅动开发 | "TDD"、"test first"、"紅綠重構" |
-| `release-standards` | 語意化版本控制 | 准备發布 |
-| `git-workflow-guide` | 分支策略 | "branch"、"merge" |
-| `documentation-guide` | 文件结构 | "README"、"docs" |
-| `requirement-assistant` | 需求撰写 | "requirement"、"user story" |
-
-## 静态与动态规范
-
-规范依据应用时机分为兩类：
-
-Standards are classified into two types based on when they should be applied:
-
-### 静态规范（项目文件）
-
-这些规范应該**隨时生效**，建议放在项目的 `CLAUDE.md` 或 `.cursorrules` 中：
-
-These standards should **always be active**. Add them to your project's `CLAUDE.md` or `.cursorrules`:
-
-| Standard | 核心規則 | Key Rules |
-|----------|---------|-----------|
-| [anti-hallucination](../../../../core/anti-hallucination.md) | 确定性标签、建议原則 | Certainty labels, suggestion principles |
-| [checkin-standards](../../../../core/checkin-standards.md) | 编譯通過、测试通過、覆蓋率达標 | Build passes, tests pass, coverage met |
-| [project-structure](../../../../core/project-structure.md) | 目录结构规范 | Directory structure conventions |
-
-> 📄 參見 [CLAUDE.md.template](../../../../templates/CLAUDE.md.template) 取得可直接使用的範本。
->
-> 📄 See [CLAUDE.md.template](../../../../templates/CLAUDE.md.template) for a ready-to-use template.
-
-### 动态规范（Skills）
-
-这些规范由**关鍵字觸發**，按需载入。安裝为 Skills 使用：
-
-These are **triggered by keywords** or specific tasks. Install as Skills:
-
-| Skill | 觸發关鍵字 | Trigger Keywords |
-|-------|-----------|-----------------|
-| commit-standards | 提交、消息 | commit, git, message |
-| code-review-assistant | 审查、检查 | review, PR, checklist |
-| git-workflow-guide | 分支、合併 | branch, merge, workflow |
-| testing-guide | 测试、覆蓋率 | test, coverage, pyramid |
-| tdd-assistant | TDD、测试優先、紅綠重構 | TDD, test first, red green refactor |
-| release-standards | 版本、發布 | version, release, semver |
-| documentation-guide | 文件、文档 | README, docs, documentation |
-| requirement-assistant | 規格、需求、新功能 | spec, SDD, requirement |
-
-> 📖 參見[静态与动态指南](../../../../adoption/STATIC-DYNAMIC-GUIDE.md)了解详细分类说明。
->
-> 📖 See [Static vs Dynamic Guide](../../../../adoption/STATIC-DYNAMIC-GUIDE.md) for detailed classification.
-
-## 安裝
-
-### 推荐：Plugin Marketplace
-
-透過 Claude Code Plugin Marketplace 安裝以獲得自动更新：
-
-```bash
-# 新增 marketplace（一次性设置）
-/plugin marketplace add AsiaOstrich/universal-dev-standards
-
-# 安裝包含所有 15 个技能的插件
-/plugin install universal-dev-standards@asia-ostrich
-```
-
-**優点：**
-- ✅ Claude Code 重啟时自动更新
-- ✅ 与 Claude Code 更好的集成
-- ✅ 無需手动維護
-
-所有技能將自动载入并可使用。
-
-### 替代方案：脚本安裝（已棄用）
-
-> ⚠️ **已棄用**：透過脚本手动安裝已棄用，將在未來版本中移除。請改用 Plugin Marketplace。
-
-适用于无法访问 Marketplace 的环境（例如企业网络）：
-
-#### 手动安装（选择性 Skills）
-
-**macOS / Linux:**
-```bash
-mkdir -p ~/.claude/skills
-cp -r ai-collaboration-standards ~/.claude/skills/
-cp -r commit-standards ~/.claude/skills/
-```
-
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
-Copy-Item -Recurse ai-collaboration-standards $env:USERPROFILE\.claude\skills\
-Copy-Item -Recurse commit-standards $env:USERPROFILE\.claude\skills\
-```
-
-### 替代方案：项目层级安裝（已棄用）
-
-> ⚠️ **已棄用**：项目层级手动安裝已棄用。建议使用 Plugin Marketplace 以獲得最佳体驗。
-
-適用於项目特定技能自订：
-
-**macOS / Linux:**
-```bash
-mkdir -p .claude/skills
-cp -r /path/to/skills/claude-code/* .claude/skills/
-```
-
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path .claude\skills
-Copy-Item -Recurse path\to\skills\claude-code\* .claude\skills\
-```
-
-> **注意**：项目层级技能（`.claude/skills/`）優先於全域技能（`~/.claude/skills/`）。
-
-## 设置
-
-Skills 支援透過 `CONTRIBUTING.md` 进行项目特定设置。
-
-### 停用 Skills
-
-在您的项目 `CONTRIBUTING.md` 中加入：
-
-```markdown
-## Disabled Skills
-
-- testing-guide
-- release-standards
-```
-
-### 设置範本
-
-完整设置选项請參見 [CONTRIBUTING.template.md](../../../../skills/claude-code/CONTRIBUTING.template.md)。
-
-## Skill 優先順序
-
-當同一个 skill 同时存在於兩个位置时：
-1. **项目层级**（`.claude/skills/`）優先
-2. **全域层级**（`~/.claude/skills/`）为备援
-
-## 授权条款
-
-雙重授权：CC BY 4.0（文件）+ MIT（程序码）

package/bundled/locales/zh-CN/skills/claude-code/test-coverage-assistant/SKILL.md

@@ -1,282 +0,0 @@
----
-name: test-coverage-assistant
-description: |
-  使用 7 維度框架评估测试完整性。
-  使用时机：撰写测试、审查测试覆蓋率、确保测试品质。
-  关鍵字：test coverage, completeness, dimensions, 7 dimensions, test quality, 测试覆蓋, 测试完整性, 七維度。
-source: ../../../../../skills/claude-code/test-coverage-assistant/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-08
-status: current
----
-
-# 测试覆蓋助手
-
-> **语言**: [English](../../../../../skills/claude-code/test-coverage-assistant/SKILL.md) | 简体中文
-
-**版本**: 1.0.0
-**最後更新**: 2025-12-30
-**適用範圍**: Claude Code Skills
-
----
-
-## 目的
-
-此技能使用 7 維度框架幫助评估和改善测试完整性，确保每个功能都有全面的测试覆蓋。
-
-## 快速參考
-
-### 7 个維度
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│              测试完整性 = 7 个維度                            │
-├─────────────────────────────────────────────────────────────┤
-│  1. 正常路徑        正常预期行为                              │
-│  2. 邊界条件        最小/最大值、限制                         │
-│  3. 错误处理        無效输入、例外状况                        │
-│  4. 授权验证        角色存取控制                              │
-│  5. 状态变更        前後状态验证                              │
-│  6. 验证邏辑        格式、商业規則                            │
-│  7. 集成测试        真实查詢验证                              │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 維度摘要表
-
-| # | 維度 | 测试内容 | 关鍵問題 |
-|---|------|----------|----------|
-| 1 | **正常路徑** | 有效输入 → 预期输出 | 正常流程是否运作？ |
-| 2 | **邊界条件** | 最小/最大值、限制 | 邊界情况会發生什麼？ |
-| 3 | **错误处理** | 無效输入、找不到数据 | 错误如何处理？ |
-| 4 | **授权验证** | 角色权限 | 誰可以做什麼？ |
-| 5 | **状态变更** | 前後状态 | 状态是否正确变更？ |
-| 6 | **验证邏辑** | 格式、商业規則 | 输入是否有验证？ |
-| 7 | **集成测试** | 真实 DB/API 呼叫 | 查詢真的有效嗎？ |
-
-### 各功能类型需要的維度
-
-| 功能类型 | 需要的維度 |
-|----------|------------|
-| CRUD API | 1, 2, 3, 4, 6, 7 |
-| 查詢/搜尋 | 1, 2, 3, 4, 7 |
-| 状态机 | 1, 3, 4, 5, 6 |
-| 验证邏辑 | 1, 2, 3, 6 |
-| 背景作业 | 1, 3, 5 |
-| 外部集成 | 1, 3, 7 |
-
-## 测试设计检查清单
-
-为每个功能使用此检查清单：
-
-```
-功能：___________________
-
-□ 正常路徑
-  □ 有效输入产生预期成功
-  □ 正确的数据被回传/建立
-  □ 预期的副作用發生
-
-□ 邊界条件
-  □ 最小有效值
-  □ 最大有效值
-  □ 空集合
-  □ 单一项目集合
-  □ 大型集合（如適用）
-
-□ 错误处理
-  □ 無效输入格式
-  □ 缺少必要欄位
-  □ 重複/衝突情况
-  □ 找不到数据情况
-  □ 外部服务失败（如適用）
-
-□ 授权验证
-  □ 每个允許的角色已测试
-  □ 每个拒絕的角色已测试
-  □ 未认证存取已测试
-  □ 跨邊界存取已测试
-
-□ 状态变更
-  □ 初始状态已验证
-  □ 最終状态已验证
-  □ 所有有效的状态转换已测试
-
-□ 验证邏辑
-  □ 格式验证（電子郵件、電話等）
-  □ 商业規則验证
-  □ 跨欄位验证
-
-□ 集成测试（如 UT 使用萬用字元）
-  □ 查詢述詞已验证
-  □ 实体关联已验证
-  □ 分页已验证
-  □ 排序/過濾已验证
-```
-
-## 详细指南
-
-完整标准請參考：
-- [测试完整性維度](../../../core/test-completeness-dimensions.md)
-- [测试标准](../../../core/testing-standards.md)
-
-### AI 優化格式（节省 Token）
-
-AI 助手可使用 YAML 格式文件以減少 Token 使用量：
-- 基礎标准：`ai/standards/test-completeness-dimensions.ai.yaml`
-
-## 範例
-
-### 1. 正常路徑
-
-```csharp
-[Fact]
-public async Task CreateUser_WithValidData_ReturnsSuccess()
-{
-    // Arrange
-    var request = new CreateUserRequest
-    {
-        Username = "newuser",
-        Email = "user@example.com"
-    };
-
-    // Act
-    var result = await _service.CreateUserAsync(request);
-
-    // Assert
-    result.Success.Should().BeTrue();
-    result.Data.Username.Should().Be("newuser");
-}
-```
-
-### 2. 邊界条件
-
-```csharp
-[Theory]
-[InlineData(0, false)]      // 低於最小值
-[InlineData(1, true)]       // 最小有效值
-[InlineData(100, true)]     // 最大有效值
-[InlineData(101, false)]    // 高於最大值
-public void ValidateQuantity_BoundaryValues_ReturnsExpected(
-    int quantity, bool expected)
-{
-    var result = _validator.IsValidQuantity(quantity);
-    result.Should().Be(expected);
-}
-```
-
-### 4. 授权验证
-
-```csharp
-[Fact]
-public async Task DeleteUser_AsAdmin_Succeeds()
-{
-    var adminContext = CreateContext(role: "Admin");
-    var result = await _service.DeleteUserAsync(userId, adminContext);
-    result.Success.Should().BeTrue();
-}
-
-[Fact]
-public async Task DeleteUser_AsMember_ReturnsForbidden()
-{
-    var memberContext = CreateContext(role: "Member");
-    var result = await _service.DeleteUserAsync(userId, memberContext);
-    result.ErrorCode.Should().Be("FORBIDDEN");
-}
-```
-
-### 5. 状态变更
-
-```csharp
-[Fact]
-public async Task DisableUser_UpdatesStateCorrectly()
-{
-    // Arrange
-    var user = await CreateEnabledUser();
-    user.IsEnabled.Should().BeTrue();  // 验证初始状态
-
-    // Act
-    await _service.DisableUserAsync(user.Id);
-
-    // Assert
-    var updatedUser = await _repository.GetByIdAsync(user.Id);
-    updatedUser.IsEnabled.Should().BeFalse();  // 验证最終状态
-}
-```
-
-## 授权矩陣範本
-
-为每个功能建立矩陣：
-
-| 操作 | 管理員 | 經理 | 成員 | 訪客 |
-|------|--------|------|------|------|
-| 建立 | ✅ | ✅ | ❌ | ❌ |
-| 读取全部 | ✅ | ⚠️ 範圍限制 | ❌ | ❌ |
-| 更新 | ✅ | ⚠️ 僅自己部門 | ❌ | ❌ |
-| 刪除 | ✅ | ❌ | ❌ | ❌ |
-
-每个格子都应該有对应的测试案例。
-
-## 要避免的反模式
-
-- ❌ 只测试正常路徑
-- ❌ 多角色系统缺少授权测试
-- ❌ 没有验证状态变更
-- ❌ 单元测试使用萬用字元但没有对应的集成测试
-- ❌ 测试数据中 ID 和业务識别码使用相同值
-- ❌ 测试实作細节而非行为
-
----
-
-## 设置偵测
-
-此技能支援项目特定设置。
-
-### 偵测順序
-
-1. 检查 `CONTRIBUTING.md` 中的「测试标准」區段
-2. 检查程序码庫中現有的测试模式
-3. 若無找到，**预设使用全部 7 个維度**
-
-### 首次设置
-
-若未找到设置：
-
-1. 建议：「此项目尚未设置测试完整性要求。您要自订需要哪些維度嗎？」
-2. 建议在 `CONTRIBUTING.md` 中记录：
-
-```markdown
-## 测试完整性
-
-我們使用 7 維度框架來确保测试覆蓋。
-
-### 各功能类型需要的維度
-- API 端点：全部 7 个維度
-- 工具函式：維度 1, 2, 3, 6
-- 背景作业：維度 1, 3, 5
-```
-
----
-
-## 相关标准
-
-- [测试完整性維度](../../../core/test-completeness-dimensions.md)
-- [测试标准](../../../core/testing-standards.md)
-- [测试指南](../testing-guide/SKILL.md)
-
----
-
-## 版本历史
-
-| 版本 | 日期 | 变更 |
-|------|------|------|
-| 1.0.0 | 2025-12-30 | 初始發布 |
-
----
-
-## 授权
-
-此技能採用 [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-TW/skills/claude-code/README.md

@@ -1,174 +0,0 @@
----
-source: ../../../../skills/claude-code/README.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-07
-status: current
----
-
-# Claude Code Skills
-
-> **語言**: [English](../../../../skills/claude-code/README.md) | 繁體中文
-
-軟體開發標準的 Claude Code Skills。
-
-> 衍生自 [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) 核心標準。
-
-## 概述
-
-這些技能會根據上下文在使用 Claude Code 時自動觸發，協助您：
-
-- 透過基於證據的回應防止 AI 幻覺
-- 撰寫一致且格式良好的提交訊息
-- 進行全面的程式碼審查
-- 遵循測試最佳實踐
-- 使用語意化版本管理發布
-
-## 可用的 Skills
-
-| Skill | 描述 | 觸發條件 |
-|-------|------|----------|
-| `ai-collaboration-standards` | 防止 AI 幻覺 | 程式碼分析、"certainty" |
-| `commit-standards` | Conventional Commits 格式 | "commit"、git 操作 |
-| `code-review-assistant` | 系統化程式碼審查 | "review"、"PR" |
-| `testing-guide` | 測試金字塔 | 撰寫測試 |
-| `tdd-assistant` | 測試驅動開發 | "TDD"、"test first"、"紅綠重構" |
-| `release-standards` | 語意化版本控制 | 準備發布 |
-| `git-workflow-guide` | 分支策略 | "branch"、"merge" |
-| `documentation-guide` | 文件結構 | "README"、"docs" |
-| `requirement-assistant` | 需求撰寫 | "requirement"、"user story" |
-
-## 靜態與動態規範
-
-規範依據應用時機分為兩類：
-
-Standards are classified into two types based on when they should be applied:
-
-### 靜態規範（專案檔案）
-
-這些規範應該**隨時生效**，建議放在專案的 `CLAUDE.md` 或 `.cursorrules` 中：
-
-These standards should **always be active**. Add them to your project's `CLAUDE.md` or `.cursorrules`:
-
-| Standard | 核心規則 | Key Rules |
-|----------|---------|-----------|
-| [anti-hallucination](../../../../core/anti-hallucination.md) | 確定性標籤、建議原則 | Certainty labels, suggestion principles |
-| [checkin-standards](../../../../core/checkin-standards.md) | 編譯通過、測試通過、覆蓋率達標 | Build passes, tests pass, coverage met |
-| [project-structure](../../../../core/project-structure.md) | 目錄結構規範 | Directory structure conventions |
-
-> 📄 參見 [CLAUDE.md.template](../../../../templates/CLAUDE.md.template) 取得可直接使用的範本。
->
-> 📄 See [CLAUDE.md.template](../../../../templates/CLAUDE.md.template) for a ready-to-use template.
-
-### 動態規範（Skills）
-
-這些規範由**關鍵字觸發**，按需載入。安裝為 Skills 使用：
-
-These are **triggered by keywords** or specific tasks. Install as Skills:
-
-| Skill | 觸發關鍵字 | Trigger Keywords |
-|-------|-----------|-----------------|
-| commit-standards | 提交、訊息 | commit, git, message |
-| code-review-assistant | 審查、檢查 | review, PR, checklist |
-| git-workflow-guide | 分支、合併 | branch, merge, workflow |
-| testing-guide | 測試、覆蓋率 | test, coverage, pyramid |
-| tdd-assistant | TDD、測試優先、紅綠重構 | TDD, test first, red green refactor |
-| release-standards | 版本、發布 | version, release, semver |
-| documentation-guide | 文件、文檔 | README, docs, documentation |
-| requirement-assistant | 規格、需求、新功能 | spec, SDD, requirement |
-
-> 📖 參見[靜態與動態指南](../../../../adoption/STATIC-DYNAMIC-GUIDE.md)了解詳細分類說明。
->
-> 📖 See [Static vs Dynamic Guide](../../../../adoption/STATIC-DYNAMIC-GUIDE.md) for detailed classification.
-
-## 安裝
-
-### 推薦：Plugin Marketplace
-
-透過 Claude Code Plugin Marketplace 安裝以獲得自動更新：
-
-```bash
-# 新增 marketplace（一次性設定）
-/plugin marketplace add AsiaOstrich/universal-dev-standards
-
-# 安裝包含所有 15 個技能的插件
-/plugin install universal-dev-standards@asia-ostrich
-```
-
-**優點：**
-- ✅ Claude Code 重啟時自動更新
-- ✅ 與 Claude Code 更好的整合
-- ✅ 無需手動維護
-
-所有技能將自動載入並可使用。
-
-### 替代方案：腳本安裝（已棄用）
-
-> ⚠️ **已棄用**：透過腳本手動安裝已棄用，將在未來版本中移除。請改用 Plugin Marketplace。
-
-適用於無法存取 Marketplace 的環境（例如企業網路）：
-
-#### 手動安裝（選擇性 Skills）
-
-**macOS / Linux:**
-```bash
-mkdir -p ~/.claude/skills
-cp -r ai-collaboration-standards ~/.claude/skills/
-cp -r commit-standards ~/.claude/skills/
-```
-
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
-Copy-Item -Recurse ai-collaboration-standards $env:USERPROFILE\.claude\skills\
-Copy-Item -Recurse commit-standards $env:USERPROFILE\.claude\skills\
-```
-
-### 替代方案：專案層級安裝（已棄用）
-
-> ⚠️ **已棄用**：專案層級手動安裝已棄用。建議使用 Plugin Marketplace 以獲得最佳體驗。
-
-適用於專案特定技能自訂：
-
-**macOS / Linux:**
-```bash
-mkdir -p .claude/skills
-cp -r /path/to/skills/claude-code/* .claude/skills/
-```
-
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path .claude\skills
-Copy-Item -Recurse path\to\skills\claude-code\* .claude\skills\
-```
-
-> **注意**：專案層級技能（`.claude/skills/`）優先於全域技能（`~/.claude/skills/`）。
-
-## 設定
-
-Skills 支援透過 `CONTRIBUTING.md` 進行專案特定設定。
-
-### 停用 Skills
-
-在您的專案 `CONTRIBUTING.md` 中加入：
-
-```markdown
-## Disabled Skills
-
-- testing-guide
-- release-standards
-```
-
-### 設定範本
-
-完整設定選項請參見 [CONTRIBUTING.template.md](../../../../skills/claude-code/CONTRIBUTING.template.md)。
-
-## Skill 優先順序
-
-當同一個 skill 同時存在於兩個位置時：
-1. **專案層級**（`.claude/skills/`）優先
-2. **全域層級**（`~/.claude/skills/`）為備援
-
-## 授權條款
-
-雙重授權：CC BY 4.0（文件）+ MIT（程式碼）