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

package/bundled/locales/zh-TW/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-TW/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-TW/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)