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

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