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

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

@@ -0,0 +1,151 @@
+---
+source: ../../../../skills/claude-code/CONTRIBUTING.template.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+> **语言**: [English](../../../../skills/claude-code/CONTRIBUTING.template.md) | 简体中文
+
+# 貢獻指南範本
+
+> 將此文件複制到您的项目中并命名为 `CONTRIBUTING.md`，然後根据需要进行自订。
+> 此範本包含 [universal-dev-skills](https://github.com/AsiaOstrich/universal-dev-skills) 的配置區塊。
+
+---
+
+## 停用的技能
+
+<!--
+所有技能预设为啟用。
+取消註解并列出您想要在此项目中停用的技能。
+-->
+
+<!--
+- testing-guide
+- release-standards
+-->
+
+---
+
+## 开发标准
+
+### Commit 消息语言
+
+此项目使用**英文** commit 类型。
+<!-- 选项：English | 简体中文 | Bilingual -->
+
+#### 允許的类型
+
+| Type | 说明 |
+|------|------|
+| `feat` | 新功能 |
+| `fix` | 错误修復 |
+| `refactor` | 程序码重構 |
+| `docs` | 文件 |
+| `style` | 格式化 |
+| `test` | 测试 |
+| `perf` | 效能 |
+| `build` | 建置系统 |
+| `ci` | CI/CD 变更 |
+| `chore` | 維護 |
+| `revert` | 还原提交 |
+| `security` | 安全性修復 |
+
+#### 允許的範圍
+
+- `auth` - 认证模組
+- `api` - API 层
+- `ui` - 使用者界面
+- `db` - 数据庫
+- `core` - 核心功能
+<!-- 新增您项目特定的範圍 -->
+
+---
+
+### 确定性标签语言
+
+此项目使用**英文**确定性标签。
+<!-- 选项：English | 中文 -->
+
+#### 标签參考
+
+| 标签 | 使用时机 |
+|------|----------|
+| `[Confirmed]` | 來自程序码/文件的直接证据 |
+| `[Inferred]` | 從证据进行邏辑推論 |
+| `[Assumption]` | 基於常見模式 |
+| `[Unknown]` | 信息不可用 |
+| `[Need Confirmation]` | 需要使用者确认 |
+
+---
+
+### Git 工作流程
+
+#### 分支策略
+
+此项目使用 **GitHub Flow**。
+<!-- 选项：GitFlow | GitHub Flow | Trunk-Based Development -->
+
+#### 分支命名
+
+格式：`<type>/<description>`
+
+| Type | 用途 | 範例 |
+|------|------|------|
+| `feature/` | 新功能 | `feature/oauth-login` |
+| `fix/` | 错误修復 | `fix/memory-leak` |
+| `hotfix/` | 緊急修復 | `hotfix/security-patch` |
+| `refactor/` | 程序码重構 | `refactor/extract-service` |
+| `docs/` | 文件 | `docs/api-reference` |
+| `chore/` | 維護 | `chore/update-deps` |
+| `release/` | 發布准备 | `release/v1.2.0` |
+
+#### 合併策略
+
+- Feature 分支：**Squash Merge**
+<!-- 选项：Merge Commit | Squash Merge | Rebase -->
+
+---
+
+## 程序码审查
+
+### 註解前綴
+
+| 前綴 | 需要的动作 |
+|------|-----------|
+| **BLOCKING** | 必須在合併前修復 |
+| **IMPORTANT** | 应該修復 |
+| **SUGGESTION** | 可選的改进 |
+| **QUESTION** | 需要釐清 |
+| **NOTE** | 信息性 |
+
+---
+
+## 测试
+
+### 最低覆蓋率
+
+| 层级 | 目標 |
+|------|------|
+| Unit Tests | 80% |
+| Integration Tests | 60% |
+| E2E Tests | 关鍵路徑 |
+
+---
+
+## Pull Request 流程
+
+1. 從 `main` 建立 feature 分支
+2. 进行您的变更
+3. 确保所有测试通過
+4. 提交 pull request
+5. 处理审查意見
+6. 核准後合併
+
+---
+
+## 授权
+
+貢獻至此项目即表示您同意您的貢獻將依项目授权进行授权。

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

@@ -0,0 +1,174 @@
+---
+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/ai-collaboration-standards/SKILL.md

@@ -0,0 +1,175 @@
+---
+source: ../../../../../skills/claude-code/ai-collaboration-standards/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# AI 协作标准
+
+> **语言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+此技能确保 AI 助理提供准确、基於证据的响应，避免产生幻覺。
+
+## 快速參考
+
+### 确定性标签
+
+| 标签 | 使用时机 |
+|-----|----------|
+| `[Confirmed]` | 來自程序码/文件的直接证据 |
+| `[Inferred]` | 基於证据的邏辑推論 |
+| `[Assumption]` | 基於常見模式（需要验证） |
+| `[Unknown]` | 信息不可用 |
+| `[Need Confirmation]` | 需要使用者澄清 |
+
+### 來源类型
+
+| 來源类型 | 标签 | 可靠性 |
+|-------------|-----|-------------|
+| 项目程序码 | `[Source: Code]` | ⭐⭐⭐⭐⭐ 最高 |
+| 项目文件 | `[Source: Docs]` | ⭐⭐⭐⭐ 高 |
+| 外部文件 | `[Source: External]` | ⭐⭐⭐⭐ 高 |
+| 网络搜尋 | `[Source: Search]` | ⭐⭐⭐ 中等 |
+| AI 知識 | `[Source: Knowledge]` | ⭐⭐ 低 |
+| 使用者提供 | `[Source: User]` | ⭐⭐⭐ 中等 |
+
+### 核心規則
+
+1. **僅基於证据**: 只分析已明确读取的内容
+2. **引用來源**: 包含程序码參考的文件路徑和行号
+3. **分类确定性**: 为所有陳述標记确定性等级
+4. **永遠提供建议**: 在呈現选项时，包含建议选择及其理由
+
+## 详细指南
+
+完整标准請參阅：
+- [防幻覺指南](./anti-hallucination.md)
+- [确定性标签參考](./certainty-labels.md)
+
+## 範例
+
+### ✅ 正确响应
+
+```
+[Confirmed] src/auth/service.ts:45 - JWT 验证使用 'jsonwebtoken' 函式庫
+[Inferred] 基於 src/repositories/ 中的储存庫模式，可能使用依賴注入
+[Need Confirmation] 新功能是否应支援多租戶？
+```
+
+### ❌ 错误响应
+
+```
+系统使用 Redis 进行快取（程序码未审查）
+UserService 应該有 authenticate() 方法（API 未验证）
+```
+
+### ✅ 正确选项呈現
+
+```
+有三个选项：
+1. Redis 快取
+2. 记忆体快取
+3. 文件快取
+
+**建议：选项 1 (Redis)**：鑑於项目已有 Redis 基礎设施
+且需要跨实例快取共享，Redis 是最合適的选择。
+```
+
+### ❌ 错误选项呈現
+
+```
+有三个选项：
+1. Redis 快取
+2. 记忆体快取
+3. 文件快取
+
+請选择一个。
+```
+
+## 检查清单
+
+在做出任何陳述之前：
+
+- [ ] 來源已验证 - 我是否已读取实际文件/文件？
+- [ ] 來源类型已標记 - 我是否指定了 `[Source: Code]`、`[Source: External]` 等？
+- [ ] 參考已引用 - 我是否包含了文件路徑和行号？
+- [ ] 确定性已分类 - 我是否標记为 `[Confirmed]`、`[Inferred]` 等？
+- [ ] 無捏造 - 我是否避免了虛構 API、设置或需求？
+- [ ] 包含建议 - 在呈現选项时，我是否包含了建议选择？
+
+---
+
+## 设置檢测
+
+此技能支援项目特定的确定性标签语言设置。
+
+### 檢测順序
+
+1. 检查 `CONTRIBUTING.md` 中的「Certainty Tag Language」章节
+2. 如果找到，使用指定的语言（English / 中文）
+3. 如果未找到，**预设使用英文**标签
+
+### 首次设置
+
+如果未找到设置且情境不明确：
+
+1. 詢問使用者：「此项目尚未设置确定性标签语言偏好。您想使用哪一种？（English / 中文）」
+2. 使用者选择後，建议在 `CONTRIBUTING.md` 中记录：
+
+```markdown
+## Certainty Tag Language
+
+This project uses **[English / 中文]** certainty tags.
+<!-- Options: English | 中文 -->
+```
+
+### 设置範例
+
+在项目的 `CONTRIBUTING.md` 中：
+
+```markdown
+## Certainty Tag Language
+
+This project uses **English** certainty tags.
+
+### Tag Reference
+- [Confirmed] - Direct evidence from code/docs
+- [Inferred] - Logical deduction from evidence
+- [Assumption] - Based on common patterns
+- [Unknown] - Information not available
+- [Need Confirmation] - Requires user clarification
+```
+
+---
+
+## 相关标准
+
+- [防幻覺标准](../../core/anti-hallucination.md)
+- [程序码审查检查清单](../../core/code-review-checklist.md)
+- [测试标准](../../core/testing-standards.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|---------|------|---------|
+| 1.0.0 | 2025-12-24 | 新增：标准章节（目的、相关标准、版本历史、授权） |
+
+---
+
+## 授权
+
+此技能依据 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)