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

package/bundled/locales/zh-TW/STANDARDS-MAPPING.md

@@ -0,0 +1,177 @@
+---
+source: ../../STANDARDS-MAPPING.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 標準與技能對應矩陣
+
+本文件提供核心標準與各 AI 工具實作之間的完整對應關係。
+
+## 覆蓋摘要
+
+| 類別 | 核心標準 | AI 標準 | Claude Code 技能 | 其他 AI 工具 |
+|------|---------|--------|-----------------|-------------|
+| 開發 | 14 | 16 | 10 | 4 |
+| 測試 | 2 | 7 | 2 | 4 |
+| 文件 | 2 | 4 | 1 | 4 |
+| 流程 | 4 | 4 | 4 | 4 |
+
+**總計**：16 個核心標準 → 16 個 AI 標準 → 15 個 Claude Code 技能 → 4 個 AI 工具整合
+
+## 核心標準矩陣
+
+| 核心標準 | AI 標準 | Claude Code 技能 | Cursor | Windsurf | Cline | Copilot |
+|---------|--------|-----------------|--------|----------|-------|---------|
+| anti-hallucination.md | ✅ | ai-collaboration-standards | ✅ | ✅ | ✅ | ✅ |
+| commit-message-guide.md | ✅ commit-message.ai.yaml | commit-standards | ✅ | ✅ | ✅ | ✅ |
+| code-review-guide.md | ✅ code-review.ai.yaml | code-review-assistant | ✅ | ✅ | ✅ | ✅ |
+| git-workflow.md | ✅ git-workflow.ai.yaml | git-workflow-guide | ✅ | ✅ | ✅ | ✅ |
+| testing-standards.md | ✅ testing.ai.yaml | testing-guide | ✅ | ✅ | ✅ | ✅ |
+| versioning.md | ✅ | release-standards | ✅ | ✅ | ✅ | ✅ |
+| changelog-standards.md | ✅ changelog.ai.yaml | release-standards | ✅ | ✅ | ✅ | ✅ |
+| documentation-structure.md | ✅ documentation-structure.ai.yaml | documentation-guide | ✅ | ✅ | ✅ | ✅ |
+| requirements-template.md | ✅ | requirement-assistant | ✅ | ✅ | ✅ | ✅ |
+| project-structure.md | ✅ project-structure.ai.yaml | project-structure-guide | ✅ | ✅ | ✅ | ✅ |
+| test-completeness-dimensions.md | ✅ | testing-guide | ✅ | ✅ | ✅ | ✅ |
+| api-documentation-standards.md | ✅ | documentation-guide | ✅ | ✅ | ✅ | ✅ |
+| logging-standards.md | ✅ logging.ai.yaml | logging-guide | ✅ | ✅ | ✅ | ✅ |
+| error-code-standards.md | ✅ error-codes.ai.yaml | error-code-guide | ✅ | ✅ | ✅ | ✅ |
+| test-driven-development.md | ✅ | tdd-assistant | ✅ | ✅ | ✅ | ✅ |
+| spec-driven-development.md | ✅ | spec-driven-dev | ✅ | ✅ | ✅ | ✅ |
+
+圖例：✅ = 已實作 | - = 不適用作為獨立技能
+
+## AI 選項覆蓋
+
+### 測試選項
+
+| 選項 | AI 標準 | 語言/框架 |
+|-----|--------|----------|
+| 單元測試 | ✅ unit-testing.ai.yaml | 全部 |
+| 整合測試 | ✅ integration-testing.ai.yaml | 全部 |
+| 系統測試 | ✅ system-testing.ai.yaml | 全部 |
+| 端對端測試 | ✅ e2e-testing.ai.yaml | 全部 |
+| 安全測試 | ✅ security-testing.ai.yaml | 全部 |
+| 效能測試 | ✅ performance-testing.ai.yaml | 全部 |
+| 契約測試 | ✅ contract-testing.ai.yaml | 微服務 |
+| ISTQB 框架 | ✅ istqb-framework.ai.yaml | 企業級 |
+| 業界金字塔 | ✅ industry-pyramid.ai.yaml | 敏捷 |
+
+### 專案結構選項
+
+| 語言 | AI 標準 | 框架 |
+|-----|--------|------|
+| Node.js | ✅ nodejs.ai.yaml | Express, NestJS, Next.js |
+| Python | ✅ python.ai.yaml | Django, Flask, FastAPI |
+| Java | ✅ java.ai.yaml | Spring Boot, Maven |
+| .NET | ✅ dotnet.ai.yaml | ASP.NET Core |
+| Go | ✅ go.ai.yaml | 標準佈局 |
+| Rust | ✅ rust.ai.yaml | Binary, Library, Workspace |
+| Kotlin | ✅ kotlin.ai.yaml | Gradle, Android, KMP |
+| PHP | ✅ php.ai.yaml | Laravel, Symfony |
+| Ruby | ✅ ruby.ai.yaml | Rails, Sinatra, Gem |
+| Swift | ✅ swift.ai.yaml | SPM, iOS, Vapor |
+
+### Git 工作流程選項
+
+| 工作流程 | AI 標準 | 最適合 |
+|---------|--------|-------|
+| GitHub Flow | ✅ github-flow.ai.yaml | 小團隊、CI/CD |
+| Git Flow | ✅ git-flow.ai.yaml | 定期發布 |
+| Trunk-Based | ✅ trunk-based.ai.yaml | 高部署頻率 |
+| GitLab Flow | ✅ gitlab-flow.ai.yaml | 環境分支 |
+
+### 變更日誌選項
+
+| 風格 | AI 標準 | 最適合 |
+|-----|--------|-------|
+| Keep a Changelog | ✅ keep-a-changelog.ai.yaml | 手動策展 |
+| 自動產生 | ✅ auto-generated.ai.yaml | CI/CD 自動化 |
+
+### 程式碼審查選項
+
+| 方式 | AI 標準 | 最適合 |
+|-----|--------|-------|
+| PR 審查 | ✅ pr-review.ai.yaml | 非同步團隊 |
+| 配對程式設計 | ✅ pair-programming.ai.yaml | 即時協作 |
+| 自動化審查 | ✅ automated-review.ai.yaml | CI/CD 整合 |
+
+### 文件選項
+
+| 風格 | AI 標準 | 最適合 |
+|-----|--------|-------|
+| Markdown 文件 | ✅ markdown-docs.ai.yaml | 程式碼儲存庫 |
+| API 文件 | ✅ api-docs.ai.yaml | REST/GraphQL API |
+| Wiki 風格 | ✅ wiki-style.ai.yaml | 知識庫 |
+
+## Claude Code 技能詳情
+
+| 技能 | 目錄 | 檔案 | 使用者可呼叫 |
+|-----|-----|-----|------------|
+| AI 協作標準 | ai-collaboration-standards/ | SKILL.md, anti-hallucination.md, certainty-labels.md | ✅ |
+| 變更日誌指南 | changelog-guide/ | SKILL.md | ✅ |
+| 程式碼審查助手 | code-review-assistant/ | SKILL.md, checkin-checklist.md, review-checklist.md | ✅ |
+| 提交標準 | commit-standards/ | SKILL.md, conventional-commits.md, language-options.md | ✅ |
+| 文件指南 | documentation-guide/ | SKILL.md, documentation-structure.md, readme-template.md | ✅ |
+| 錯誤碼指南 | error-code-guide/ | SKILL.md | ✅ |
+| Git 工作流程指南 | git-workflow-guide/ | SKILL.md, branch-naming.md, git-workflow.md | ✅ |
+| 日誌指南 | logging-guide/ | SKILL.md | ✅ |
+| 專案結構指南 | project-structure-guide/ | SKILL.md, language-patterns.md | ✅ |
+| 發布標準 | release-standards/ | SKILL.md, changelog-format.md, semantic-versioning.md, release-workflow.md | ✅ |
+| 需求助手 | requirement-assistant/ | SKILL.md, requirement-checklist.md, requirement-writing.md | ✅ |
+| 規格驅動開發 | spec-driven-dev/ | SKILL.md | ✅ |
+| TDD 助手 | tdd-assistant/ | SKILL.md, tdd-workflow.md, language-examples.md | ✅ |
+| 測試覆蓋助手 | test-coverage-assistant/ | SKILL.md | ✅ |
+| 測試指南 | testing-guide/ | SKILL.md, testing-pyramid.md | ✅ |
+
+## 本地化覆蓋
+
+| 語言 | 核心 | AI 標準 | AI 選項 | 技能 |
+|-----|-----|--------|--------|-----|
+| English | 16/16 | 16/16 | 35/35 | 15/15 |
+| 繁體中文 (zh-TW) | 16/16 | 16/16 | 35/35 | 15/15 |
+| 简体中文 (zh-CN) | 5/16 | 0/16 | 0/35 | 0/15 |
+
+## AI 工具整合
+
+| 工具 | 檔案 | 格式 | 狀態 |
+|-----|-----|-----|-----|
+| Claude Code | skills/claude-code/**/*.md | SKILL.md | ✅ 完成 |
+| Cursor | skills/cursor/.cursorrules | Rules 檔案 | ✅ 完成 |
+| Windsurf | skills/windsurf/.windsurfrules | Rules 檔案 | ✅ 完成 |
+| Cline | skills/cline/.clinerules | Rules 檔案 | ✅ 完成 |
+| GitHub Copilot | skills/copilot/copilot-instructions.md | Markdown | ✅ 完成 |
+
+## 統計
+
+### 依類別
+
+| 類別 | 數量 |
+|-----|-----|
+| 核心標準 (Markdown) | 16 |
+| AI 標準 (YAML) | 16 |
+| AI 選項 (YAML) | 35 |
+| Claude Code 技能 | 15 |
+| AI 工具整合 | 4 |
+| 支援語言 | 10 |
+| 本地化 | 3 |
+
+### 檔案類型
+
+| 副檔名 | 數量 | 用途 |
+|-------|-----|-----|
+| .md | ~60 | 人類可讀文件 |
+| .ai.yaml | ~50 | AI 優化標準 |
+| .cursorrules | 1 | Cursor 規則 |
+| .windsurfrules | 1 | Windsurf 規則 |
+| .clinerules | 1 | Cline 規則 |
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|-----|-----|-----|
+| 1.1.0 | 2026-01-07 | 新增 TDD 標準和 tdd-assistant 技能，更新至 15 個技能 |
+| 1.0.0 | 2025-12-30 | 初始對應矩陣 |

package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md

@@ -0,0 +1,392 @@
+---
+source: ../../../adoption/ADOPTION-GUIDE.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 規範採用指南
+
+> **語言**: [English](../../adoption/ADOPTION-GUIDE.md) | 繁體中文
+>
+> 版本 1.0.0
+
+本指南幫助軟體專案正確採用通用文件標準，避免重複引用或遺漏。
+
+---
+
+## 目錄
+
+- [了解兩個專案](#了解兩個專案)
+- [靜態與動態規範](#靜態與動態規範)
+- [規範分類](#規範分類)
+- [完整規範對照表](#完整規範對照表)
+- [採用等級](#採用等級)
+- [如何採用](#如何採用)
+- [常見錯誤避免](#常見錯誤避免)
+
+---
+
+## 了解兩個專案
+
+| 專案 | 用途 | 使用方式 |
+|------|------|----------|
+| **[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)** | 所有規範的權威來源 | 參考文件，複製到專案 |
+| **[universal-dev-skills](https://github.com/AsiaOstrich/universal-dev-skills)** | Claude Code Skills 實作 | 互動式 AI 工作流程輔助 |
+
+### 關鍵原則
+
+**對於有 Skills 的規範**：安裝 Skill 或複製原始文件 — **擇一即可，不要兩者都做**。
+
+---
+
+## 靜態與動態規範
+
+規範依據**應用時機**分類：
+
+| 類型 | 說明 | 部署方式 |
+|------|------|----------|
+| **靜態** | 隨時生效 | 專案文件（`CLAUDE.md`） |
+| **動態** | 關鍵字觸發 | Skills（按需載入） |
+
+### 靜態規範
+
+這 3 個規範應該在專案中**隨時生效**：
+
+- `anti-hallucination.md` - 確定性標籤、建議原則
+- `checkin-standards.md` - 建置、測試、覆蓋率門檻
+- `project-structure.md` - 目錄慣例
+
+**部署方式**：加入 `CLAUDE.md` 或 `.cursorrules`。請參閱 [CLAUDE.md.template](../../../templates/CLAUDE.md.template)。
+
+### 動態規範
+
+這 10 個規範由**關鍵字觸發**，按需載入：
+
+| Skill | 觸發關鍵字 |
+|-------|-----------|
+| commit-standards | commit, git, 提交 |
+| code-review-assistant | review, PR, 審查 |
+| git-workflow-guide | branch, merge |
+| testing-guide | test, coverage |
+| release-standards | version, release |
+| documentation-guide | docs, README |
+| requirement-assistant | spec, SDD, 新功能 |
+
+**部署方式**：透過 Plugin Marketplace 或手動複製安裝為 Skills。
+
+> 詳細分類請參閱 [STATIC-DYNAMIC-GUIDE.md](../../../adoption/STATIC-DYNAMIC-GUIDE.md)。
+
+---
+
+## 規範分類
+
+### 類別一：Skills
+
+已製作為 Claude Code Skills 的規範，提供互動式 AI 輔助。
+
+**採用方式**：透過 Plugin Marketplace（推薦）或手動複製安裝
+
+```bash
+# Plugin Marketplace（推薦）
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+
+# 或手動複製（macOS / Linux）
+mkdir -p ~/.claude/skills
+cp -r skills/claude-code/commit-standards ~/.claude/skills/
+```
+
+### 類別二：參考文件
+
+靜態參考文件，提供指南但沒有工作流程對應。這些不適合製作成 Skills，因為它們是查詢參考而非互動式工作流程。
+
+**採用方式**：複製到專案的 `.standards/` 目錄
+
+**macOS / Linux:**
+```bash
+mkdir -p .standards
+cp <source-file> .standards/
+```
+
+**Windows PowerShell:**
+```powershell
+New-Item -ItemType Directory -Force -Path .standards
+Copy-Item <source-file> .standards\
+```
+
+### 類別三：延伸
+
+語言、框架或地區特定的規範。根據專案技術堆疊選用。
+
+**採用方式**：適用於專案時複製
+
+### 類別四：整合
+
+各種編輯器和 AI 助理的工具配置檔。
+
+**採用方式**：複製到工具預期的位置
+
+### 類別五：模板
+
+特定用途的文件模板。
+
+**採用方式**：根據需要複製和自訂
+
+---
+
+## 完整規範對照表
+
+### 核心規範
+
+| 規範 | 類別 | Skill 名稱 | 等級 | 採用方式 |
+|------|------|-----------|------|---------|
+| anti-hallucination.md | Skill | ai-collaboration-standards | 1 | 安裝 Skill |
+| commit-message-guide.md | Skill | commit-standards | 1 | 安裝 Skill |
+| checkin-standards.md | 參考文件 | - | 1 | 複製到專案 |
+| spec-driven-development.md | 參考文件 | - | 1 | 複製到專案 |
+| code-review-checklist.md | Skill | code-review-assistant | 2 | 安裝 Skill |
+| git-workflow.md | Skill | git-workflow-guide | 2 | 安裝 Skill |
+| versioning.md | Skill | release-standards | 2 | 安裝 Skill |
+| changelog-standards.md | Skill | release-standards | 2 | 安裝 Skill |
+| testing-standards.md | Skill | testing-guide | 2 | 安裝 Skill |
+| documentation-structure.md | Skill | documentation-guide | 3 | 安裝 Skill |
+| documentation-writing-standards.md | 參考文件 | - | 3 | 複製到專案 |
+| project-structure.md | 參考文件 | - | 3 | 複製到專案 |
+
+### 延伸規範
+
+| 規範 | 類別 | 適用範圍 | 等級 |
+|------|------|---------|------|
+| csharp-style.md | 延伸 | C# 專案 | 2 |
+| php-style.md | 延伸 | PHP 8.1+ 專案 | 2 |
+| fat-free-patterns.md | 延伸 | Fat-Free Framework | 2 |
+| zh-tw.md | 延伸 | 繁體中文團隊 | 2 |
+
+### 整合配置
+
+| 規範 | 目標路徑 | 等級 |
+|------|---------|------|
+| copilot-instructions.md | .github/copilot-instructions.md | 2 |
+| .cursorrules | .cursorrules | 2 |
+| .windsurfrules | .windsurfrules | 2 |
+| .clinerules | .clinerules | 2 |
+| google-antigravity/* | 請參閱 README | 2 |
+| openspec/* | 請參閱 README | 2 |
+
+### 模板
+
+| 模板 | 類別 | 適用範圍 | 等級 |
+|------|------|---------|------|
+| requirement-*.md | Skill | 所有專案 | 2 |
+| migration-template.md | 模板 | 遷移專案 | 3 |
+
+---
+
+## 採用等級
+
+### 等級一：基本
+
+任何專案的最低可行標準。設置時間：約 30 分鐘。
+
+**必要**：
+- [ ] ai-collaboration-standards (Skill)
+- [ ] commit-standards (Skill)
+- [ ] checkin-standards.md (參考文件)
+- [ ] spec-driven-development.md (參考文件)
+
+詳細檢查清單請參閱 [checklists/minimal.md](../../../adoption/checklists/minimal.md)。
+
+### 等級二：推薦
+
+團隊專案的專業品質標準。設置時間：約 2 小時。
+
+**包含等級一，加上**：
+- [ ] code-review-assistant (Skill)
+- [ ] git-workflow-guide (Skill)
+- [ ] release-standards (Skill)
+- [ ] testing-guide (Skill)
+- [ ] 適用的延伸規範
+- [ ] AI 工具整合
+
+詳細檢查清單請參閱 [checklists/recommended.md](../../../adoption/checklists/recommended.md)。
+
+### 等級三：企業
+
+企業或受監管專案的全面標準。設置時間：1-2 天。
+
+**包含等級二，加上**：
+- [ ] documentation-guide (Skill)
+- [ ] documentation-writing-standards.md (參考文件)
+- [ ] project-structure.md (參考文件)
+- [ ] migration-template.md (如適用)
+
+詳細檢查清單請參閱 [checklists/enterprise.md](../../../adoption/checklists/enterprise.md)。
+
+---
+
+## 如何採用
+
+### 步驟一：決定採用等級
+
+考慮專案需求：
+- **個人／副專案**：等級一
+- **團隊專案**：等級二
+- **企業／受監管**：等級三
+
+### 步驟二：安裝 Skills
+
+**推薦：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**替代方案：手動複製（macOS / Linux）**
+```bash
+git clone https://github.com/AsiaOstrich/universal-dev-standards.git
+mkdir -p ~/.claude/skills
+cp -r universal-dev-standards/skills/claude-code/commit-standards ~/.claude/skills/
+```
+
+**替代方案：手動複製（Windows PowerShell）**
+```powershell
+git clone https://github.com/AsiaOstrich/universal-dev-standards.git
+New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
+Copy-Item -Recurse universal-dev-standards\skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
+```
+
+### 步驟三：複製參考文件
+
+**macOS / Linux:**
+```bash
+# 在專案目錄中
+mkdir -p .standards
+
+# 根據等級複製參考文件
+# 等級一
+cp path/to/universal-dev-standards/core/checkin-standards.md .standards/
+cp path/to/universal-dev-standards/core/spec-driven-development.md .standards/
+
+# 等級三（額外）
+cp path/to/universal-dev-standards/core/documentation-writing-standards.md .standards/
+cp path/to/universal-dev-standards/core/project-structure.md .standards/
+```
+
+**Windows PowerShell:**
+```powershell
+# 在專案目錄中
+New-Item -ItemType Directory -Force -Path .standards
+
+# 根據等級複製參考文件
+# 等級一
+Copy-Item path\to\universal-dev-standards\core\checkin-standards.md .standards\
+Copy-Item path\to\universal-dev-standards\core\spec-driven-development.md .standards\
+
+# 等級三（額外）
+Copy-Item path\to\universal-dev-standards\core\documentation-writing-standards.md .standards\
+Copy-Item path\to\universal-dev-standards\core\project-structure.md .standards\
+```
+
+### 步驟四：複製適用的延伸
+
+**macOS / Linux:**
+```bash
+# 範例：PHP 專案，繁體中文團隊
+cp path/to/universal-dev-standards/extensions/languages/php-style.md .standards/
+cp path/to/universal-dev-standards/extensions/locales/zh-tw.md .standards/
+```
+
+**Windows PowerShell:**
+```powershell
+# 範例：PHP 專案，繁體中文團隊
+Copy-Item path\to\universal-dev-standards\extensions\languages\php-style.md .standards\
+Copy-Item path\to\universal-dev-standards\extensions\locales\zh-tw.md .standards\
+```
+
+### 步驟五：設置 AI 工具整合
+
+**macOS / Linux:**
+```bash
+# 範例：Cursor IDE
+cp path/to/universal-dev-standards/integrations/cursor/.cursorrules .
+
+# 範例：GitHub Copilot
+mkdir -p .github
+cp path/to/universal-dev-standards/integrations/github-copilot/copilot-instructions.md .github/
+```
+
+**Windows PowerShell:**
+```powershell
+# 範例：Cursor IDE
+Copy-Item path\to\universal-dev-standards\integrations\cursor\.cursorrules .
+
+# 範例：GitHub Copilot
+New-Item -ItemType Directory -Force -Path .github
+Copy-Item path\to\universal-dev-standards\integrations\github-copilot\copilot-instructions.md .github\
+```
+
+---
+
+## 常見錯誤避免
+
+### 錯誤一：同時引用 Skill 和原始文件
+
+**錯誤**：
+```
+# 專案同時有：
+- 已安裝 ai-collaboration-standards skill
+- 已複製 .standards/anti-hallucination.md
+```
+
+**正確**：
+```
+# 專案只有其中一個：
+- 已安裝 ai-collaboration-standards skill
+# 或
+- 已複製 .standards/anti-hallucination.md
+```
+
+### 錯誤二：遺漏僅參考文件的規範
+
+**錯誤**：
+```
+# 安裝了所有 skills，但忘記參考文件
+- Skills 已安裝 ✓
+- checkin-standards.md ✗（遺漏）
+- spec-driven-development.md ✗（遺漏）
+```
+
+**正確**：
+```
+# Skills 和參考文件都有
+- Skills 已安裝 ✓
+- .standards/checkin-standards.md ✓
+- .standards/spec-driven-development.md ✓
+```
+
+### 錯誤三：忘記工具整合
+
+如果使用 AI 編碼助理，不要忘記複製整合檔案：
+- `.cursorrules` 用於 Cursor
+- `.windsurfrules` 用於 Windsurf
+- `.github/copilot-instructions.md` 用於 GitHub Copilot
+
+---
+
+## 機器可讀註冊表
+
+工具和自動化請參閱 [standards-registry.json](../../../adoption/standards-registry.json)。
+
+此 JSON 檔案包含所有規範、類別和採用方法的完整對照。
+
+---
+
+## 相關連結
+
+- [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) - 來源儲存庫
+- [universal-dev-skills](https://github.com/AsiaOstrich/universal-dev-skills) - Skills 儲存庫
+- [最小檢查清單](../../../adoption/checklists/minimal.md) - 等級一採用檢查清單
+- [推薦檢查清單](../../../adoption/checklists/recommended.md) - 等級二採用檢查清單
+- [企業檢查清單](../../../adoption/checklists/enterprise.md) - 等級三採用檢查清單