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

package/bundled/locales/zh-CN/skills/claude-code/ai-collaboration-standards/anti-hallucination.md

@@ -0,0 +1,223 @@
+---
+source: skills/claude-code/ai-collaboration-standards/anti-hallucination.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 防止幻覺指南
+
+> **语言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/anti-hallucination.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供防止 AI 幻覺并确保基於证据的响应的指南。
+
+---
+
+## 核心原則
+
+### 1. 僅基於证据的分析
+
+**規則**: 僅分析和引用已明确提供或读取的内容。
+
+**指南**:
+- ✅ 分析已使用文件读取工具读取的程序码文件
+- ✅ 引用已獲取的文件
+- ✅ 引用已检查的配置文件
+- ❌ 不要推测未見過的 API、函數或配置
+- ❌ 不要在未验证的情况下假设框架行为
+- ❌ 不要捏造需求細节
+
+---
+
+### 2. 明确的來源歸屬
+
+**規則**: 所有引用必須包含來源类型、位置和可验证性信息。
+
+#### 來源类型
+
+| 來源类型 | 标签 | 可靠性 |
+|-------------|-----|-------------|
+| 项目程序码 | `[Source: Code]` | ⭐⭐⭐⭐⭐ 最高 |
+| 项目文件 | `[Source: Docs]` | ⭐⭐⭐⭐ 高 |
+| 外部文件 | `[Source: External]` | ⭐⭐⭐⭐ 高 |
+| 网络搜尋 | `[Source: Search]` | ⭐⭐⭐ 中等 |
+| AI 知識 | `[Source: Knowledge]` | ⭐⭐ 低 |
+| 使用者提供 | `[Source: User]` | ⭐⭐⭐ 中等 |
+
+#### 歸屬格式
+
+**程序码引用**:
+```
+[Source: Code] 文件路徑:行号 - 描述
+```
+
+**外部文件**:
+```
+[Source: External] URL - 描述 (版本: x.x.x, 存取日期: YYYY-MM-DD)
+```
+
+**AI 知識**:
+```
+[Source: Knowledge] 主題 - 描述 (⚠️ 需要验证)
+```
+
+#### 版本敏感性
+
+引用函式庫、框架或 API 时，务必包含版本信息：
+
+```
+✅ [Source: External] Next.js App Router (v14.x) - Server Components 是预设的
+✅ [Source: Code] package.json:12 - 使用 "express": "^4.18.2"
+❌ "Next.js 使用 Server Components" (哪个版本?)
+```
+
+---
+
+### 3. 分类确定性级别
+
+**規則**: 清楚區分已确认的事实、推論和未知项目。
+
+| 标签 | 使用时机 |
+|-----|----------|
+| `[Confirmed]` | 來自程序码/文件的直接证据 |
+| `[Inferred]` | 基於可用证据的邏辑推論 |
+| `[Assumption]` | 基於常見模式（需要验证） |
+| `[Unknown]` | 信息不可用 |
+| `[Need Confirmation]` | 需要使用者澄清 |
+
+**範例**:
+
+```
+[Confirmed] src/database/connection.ts:12 - 使用 PostgreSQL 驅动程序 'pg'
+[Inferred] 基於 src/repositories/ 中的储存庫模式，可能使用依賴注入
+[Assumption] 项目可能使用 OAuth2，但需要檢视认证配置
+[Unknown] API 速率限制策略未记录
+[Need Confirmation] 新功能是否应支援多租戶?
+```
+
+---
+
+### 4. 建议原則
+
+**規則**: 提供多个选项时，务必包含建议选择及其理由。
+
+| 情境 | 要求 |
+|------|------|
+| 提出 2 个以上选项 | 必須標示建议选项及理由 |
+| 存在明确的最佳选择 | 直接建议最佳选项及理由 |
+| 存在权衡取捨 | 根据當前情境建议，说明权衡取捨 |
+| 無法确定 | 说明需要什麼信息才能提出建议 |
+
+---
+
+### 5. 禁止行为
+
+AI 助理絕对不能:
+
+1. **捏造 API 或函數簽章**
+   - ❌ 不要捏造方法名称、參數或返回类型
+   - ✅ 要读取实际原始码或詢問使用者
+
+2. **假设需求**
+   - ❌ 不要猜测使用者需求或业务規則
+   - ✅ 當需求模糊时要提出澄清問題
+
+3. **推测未读取的程序码**
+   - ❌ 不要描述未檢视文件的功能
+   - ✅ 要明确说明「需要读取 [文件] 以确认」
+
+4. **捏造配置**
+   - ❌ 不要假设環境变數、配置鍵或数据庫架構
+   - ✅ 要檢视实际的配置文件
+
+5. **幻想错误或 Bug**
+   - ❌ 不要在没有证据的情况下聲称程序码有問題
+   - ✅ 要分析实际程序码并引用特定行
+
+6. **提出选项但不給建议**
+   - ❌ 不要只列出选项并要求使用者选择而不提供指引
+   - ✅ 务必包含建议选择及理由
+
+---
+
+## AI 助理工作流程
+
+```
+┌─────────────────────────────────┐
+│  收到使用者请求                    │
+└─────────────┬───────────────────┘
+              │
+              ▼
+┌─────────────────────────────────┐
+│  識别所需信息                      │
+│  - 程序码文件?                     │
+│  - 配置?                          │
+│  - 需求?                          │
+└─────────────┬───────────────────┘
+              │
+              ▼
+         ┌────┴────┐
+         │ 可用? │
+         └────┬────┘
+              │
+      ┌───────┴───────┐
+      │               │
+     是              否
+      │               │
+      ▼               ▼
+┌──────────┐   ┌─────────────┐
+│  读取/   │   │  向使用者   │
+│  分析    │   │  詢問信息   │
+└────┬─────┘   └──────┬──────┘
+     │                │
+     ▼                ▼
+┌─────────────────────────────────┐
+│  標记响应:                        │
+│  - [Confirmed] 用於事实           │
+│  - [Inferred] 用於推論            │
+│  - [Need Confirmation] 用於缺口   │
+└─────────────┬───────────────────┘
+              │
+              ▼
+┌─────────────────────────────────┐
+│  引用來源 (文件:行号)              │
+└─────────────┬───────────────────┘
+              │
+              ▼
+┌─────────────────────────────────┐
+│  包含建议                         │
+│  (如果提出选项)                    │
+└─────────────────────────────────┘
+```
+
+---
+
+## 相关标准
+
+- [防止幻覺标准](../../../core/anti-hallucination.md)
+- [确定性标签參考](./certainty-labels.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)

package/bundled/locales/zh-CN/skills/claude-code/ai-collaboration-standards/certainty-labels.md

@@ -0,0 +1,132 @@
+---
+source: skills/claude-code/ai-collaboration-standards/certainty-labels.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 确定性标签參考
+
+> **语言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/certainty-labels.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供 AI 响应中使用的确定性标签和來源类型的參考。
+
+---
+
+## 标签对照表（英文 / 中文）
+
+| English Tag | 中文标签 | 使用时机 |
+|-------------|---------|----------|
+| `[Confirmed]` | `[已确认]` | 來自程序码/文件的直接证据 |
+| `[Inferred]` | `[推論]` | 基於证据的邏辑推論 |
+| `[Assumption]` | `[假设]` | 基於常見模式（需要验证） |
+| `[Unknown]` | `[未知]` | 信息不可用 |
+| `[Need Confirmation]` | `[待确认]` | 需要使用者澄清 |
+
+---
+
+## 來源类型
+
+| 來源类型 | 标签 | 说明 | 可靠性 |
+|-------------|-----|-------------|-------------|
+| 项目程序码 | `[Source: Code]` | 直接從程序码庫读取 | ⭐⭐⭐⭐⭐ 最高 |
+| 项目文件 | `[Source: Docs]` | README、Wiki、行內註解 | ⭐⭐⭐⭐ 高 |
+| 外部文件 | `[Source: External]` | 附帶 URL 的官方文件 | ⭐⭐⭐⭐ 高 |
+| 网络搜尋 | `[Source: Search]` | 搜尋結果（包含日期） | ⭐⭐⭐ 中等 |
+| AI 知識 | `[Source: Knowledge]` | AI 訓练数据（需要验证） | ⭐⭐ 低 |
+| 使用者提供 | `[Source: User]` | 來自使用者对话的信息 | ⭐⭐⭐ 中等 |
+
+---
+
+## 使用範例
+
+### 在技術文件中
+
+```markdown
+## 系统架構分析
+
+`[Confirmed]` 系统使用 ASP.NET Core 8.0 框架 [Source: Code] Program.cs:1
+`[Confirmed]` 数据庫使用 SQL Server [Source: Code] appsettings.json:12
+`[Inferred]` 基於 Repository Pattern 的使用，系统可能採用 DDD 架構
+`[Assumption]` 快取机制可能使用 Redis（需要确认设置）
+`[Need Confirmation]` 是否应該支援多租戶？
+```
+
+### 在程序码审查中
+
+```markdown
+## 审查意見
+
+`[Confirmed]` src/Services/AuthService.cs:45 - 密码验证缺乏暴力破解防護
+`[Inferred]` 这里可能需要速率限制
+`[Need Confirmation]` 是否已有其他层级的防護机制？
+```
+
+---
+
+## 最佳实踐
+
+### 1. 一致性
+
+- 在整个文件中使用相同语言的标签（全中文或全英文）
+- 团队应在 `CONTRIBUTING.md` 中指定偏好语言
+
+### 2. 來源引用
+
+- 中文标签仍需要來源引用
+- 格式：`[已确认]` 陳述 [Source: Code] file_path:line_number
+
+### 3. 团队協議
+
+- 在项目開始时决定使用中文或英文标签
+- 记录在 `CONTRIBUTING.md` 或 `.standards/` 目录中
+
+---
+
+## 快速决策指南
+
+```
+你是否读取了实际的程序码/文件？
+├── 是 → [Confirmed] / [已确认]
+└── 否
+    ├── 你能從現有证据推論嗎？
+    │   ├── 是 → [Inferred] / [推論]
+    │   └── 否
+    │       ├── 这是常見模式嗎？
+    │       │   ├── 是 → [Assumption] / [假设]
+    │       │   └── 否 → [Unknown] / [未知]
+    └── 使用者需要澄清嗎？
+        └── 是 → [Need Confirmation] / [待确认]
+```
+
+---
+
+## 相关标准
+
+- [防幻覺指南](./anti-hallucination.md)
+- [防幻覺标准](../../../core/anti-hallucination.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)

package/bundled/locales/zh-CN/skills/claude-code/changelog-guide/SKILL.md

@@ -0,0 +1,237 @@
+---
+name: changelog-guide
+description: |
+  依照 Keep a Changelog 格式撰写与維護 CHANGELOG.md。
+  使用时机：建立变更日誌条目、准备發布、记录变更。
+  关鍵字：changelog, release notes, CHANGELOG.md, keep a changelog, 变更日誌, 發布说明。
+source: ../../../../../skills/claude-code/changelog-guide/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-08
+status: current
+---
+
+# 变更日誌指南
+
+> **语言**: [English](../../../../../skills/claude-code/changelog-guide/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-30
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+此技能幫助依照 Keep a Changelog 格式撰写与維護 CHANGELOG.md 文件，确保清楚地向使用者传达变更内容。
+
+## 快速參考
+
+### 文件结构
+
+```markdown
+# 变更日誌
+
+本项目的所有重要变更都將记录在此文件中。
+
+格式基於 [Keep a Changelog](https://keepachangelog.com/)，
+并遵循[語義化版本](https://semver.org/)。
+
+## [未發布]
+
+## [1.2.0] - 2025-12-15
+
+### 新增
+- 功能描述
+
+### 变更
+- 变更描述
+
+### 修復
+- 错误修復描述
+
+[未發布]: https://github.com/user/repo/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
+```
+
+### 变更类别
+
+| 类别 | 使用时机 | 範例 |
+|------|----------|------|
+| **新增 (Added)** | 新功能 | 新增深色模式支援 |
+| **变更 (Changed)** | 現有功能的修改 | 搜尋效能提升 50% |
+| **棄用 (Deprecated)** | 即將移除的功能 | 棄用 legacyParse() |
+| **移除 (Removed)** | 已移除的功能 | 移除 Node.js 14 支援 |
+| **修復 (Fixed)** | 错误修復 | 修復登入逾时問題 |
+| **安全 (Security)** | 安全性修補 | 修復 XSS 漏洞 |
+
+### Commit Type 对应 Changelog
+
+| Commit Type | Changelog 类别 | 备註 |
+|-------------|----------------|------|
+| `feat` | **新增** | 新功能 |
+| `fix` | **修復** | 错误修復 |
+| `perf` | **变更** | 效能改善 |
+| `security` | **安全** | 安全性修補 |
+| `BREAKING CHANGE` | **变更** 或 **移除** | 加上 **BREAKING** 前綴 |
+| `refactor`, `docs`, `style`, `test`, `chore` | *(通常省略)* | 对使用者無影響 |
+
+## 条目格式
+
+### 标准格式
+
+```markdown
+- [动作动詞] [变更内容] ([參考])
+```
+
+### 範例
+
+```markdown
+### 新增
+- 新增可自订小工具的使用者儀表板 (#123)
+- 新增 PostgreSQL 15 支援 (PR #456)
+
+### 变更
+- **BREAKING**: API 响应格式從 XML 改为 JSON (#789)
+- 更新最低 Node.js 版本至 18.0 (#101)
+
+### 修復
+- 修復处理大型文件时的记忆体洩漏 (#112)
+- 修復报表中日期格式错误 (#134)
+
+### 安全
+- 修復搜尋端点的 SQL 注入漏洞 (高風險, CVE-2025-12345)
+```
+
+## 详细指南
+
+完整标准請參考：
+- [变更日誌标准](../../../core/changelog-standards.md)
+
+### AI 優化格式（节省 Token）
+
+AI 助手可使用 YAML 格式文件以減少 Token 使用量：
+- 基礎标准：`ai/standards/changelog.ai.yaml`
+
+## 撰写指南
+
+### 为使用者撰写，而非开发者
+
+| ✅ 好 | ❌ 不好 | 原因 |
+|-------|--------|------|
+| 新增深色模式主題选项 | 使用 context 实作 ThemeProvider | 使用者可見的好处 |
+| 修復慢速网络的登入逾时 | 修復 AuthService 中的競爭条件 | 影響描述 |
+| 页面载入速度提升 40% | 使用索引優化 SQL 查詢 | 可量化的成果 |
+
+### 破壞性变更
+
+务必清楚標记破壞性变更：
+
+```markdown
+### 变更
+- **BREAKING**: 移除已棄用的 `getUserById()` 方法，請改用 `getUser()`
+- **BREAKING**: 设置檔格式從 YAML 改为 TOML
+
+### 移除
+- **BREAKING**: 移除 Node.js 14 支援
+```
+
+### 安全公告
+
+包含嚴重程度和 CVE（如有）：
+
+```markdown
+### 安全
+- 修復搜尋端点的 SQL 注入漏洞 (高風險, CVE-2025-12345)
+- 修復留言區的 XSS 漏洞 (中風險)
+- 更新 `lodash` 相依套件以修補原型污染 (低風險)
+```
+
+## 版本標題格式
+
+```markdown
+## [版本] - YYYY-MM-DD
+```
+
+範例：
+```markdown
+## [2.0.0] - 2025-12-15
+## [1.5.0-beta.1] - 2025-12-01
+## [未發布]
+```
+
+## 排除規則
+
+以下**不应**记录在 CHANGELOG 中：
+
+| 类别 | 範例 | 原因 |
+|------|------|------|
+| 建置输出 | `dist/`, `build/` | 产生的文件 |
+| 相依套件 | `node_modules/`, lock 文件 | 自动管理 |
+| 本地设置 | `.env`, `*.local.json` | 環境特定 |
+| IDE 设置 | `.vscode/`, `.idea/` | 开发者偏好 |
+| 內部重構 | 程序码風格、变數名称 | 对使用者無影響 |
+
+## 常見错误
+
+| ❌ 错误 | ✅ 正确 |
+|--------|--------|
+| 没有日期 | 使用 ISO 格式包含日期 |
+| 缺少版本連結 | 在底部加入比較連結 |
+| 內部術語 | 使用使用者友善的语言 |
+| 過於技術性 | 專注於使用者影響 |
+| 没有分类 | 使用标准类别 |
+
+---
+
+## 设置偵测
+
+此技能支援项目特定设置。
+
+### 偵测順序
+
+1. 检查現有 `CHANGELOG.md` 格式
+2. 检查 `CONTRIBUTING.md` 中的变更日誌指南
+3. 若無找到，**预设使用 Keep a Changelog 格式**
+
+### 首次设置
+
+若 CHANGELOG.md 不存在：
+
+1. 建议使用标准範本建立
+2. 建议在 `CONTRIBUTING.md` 中记录指南：
+
+```markdown
+## 变更日誌指南
+
+- 为所有使用者可見的变更更新 CHANGELOG.md
+- 开发期间將条目加入 [未發布] 區段
+- 使用标准类别：新增、变更、棄用、移除、修復、安全
+- 引用 issue/PR 编号：`修復错误 (#123)`
+- 使用 **BREAKING** 前綴標记破壞性变更
+```
+
+---
+
+## 相关标准
+
+- [变更日誌标准](../../../core/changelog-standards.md)
+- [版本控制标准](../../../core/versioning.md)
+- [提交消息指南](../../../core/commit-message-guide.md)
+- [發布标准技能](../release-standards/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)