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

package/bundled/locales/zh-TW/adoption/checklists/minimal.md

@@ -0,0 +1,141 @@
+---
+source: adoption/checklists/minimal.md
+source_version: 1.0.1
+translation_version: 1.0.1
+last_synced: 2025-12-25
+status: current
+---
+
+# 等級 1：基本採用檢查清單
+
+> **語言**: [English](../../../adoption/checklists/minimal.md) | 繁體中文
+
+> 任何專案的最低可行標準
+>
+> 設置時間：約 30 分鐘
+
+---
+
+## 前置條件
+
+- [ ] 已初始化 Git 儲存庫
+- [ ] 已安裝 Claude Code（用於 Skills）
+
+---
+
+## Skills 安裝
+
+### 選項 A：Plugin Marketplace（推薦）
+
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+### 選項 B：手動複製（macOS / Linux）
+
+```bash
+# Copy only Level 1 skills
+cp -r universal-dev-skills/skills/ai-collaboration-standards ~/.claude/skills/
+cp -r universal-dev-skills/skills/commit-standards ~/.claude/skills/
+```
+
+### 選項 C：手動複製（Windows PowerShell）
+
+```powershell
+# Copy only Level 1 skills
+Copy-Item -Recurse universal-dev-skills\skills\ai-collaboration-standards $env:USERPROFILE\.claude\skills\
+Copy-Item -Recurse universal-dev-skills\skills\commit-standards $env:USERPROFILE\.claude\skills\
+```
+
+**檢查清單**：
+- [ ] 已安裝 ai-collaboration-standards skill
+- [ ] 已安裝 commit-standards skill
+
+---
+
+## 參考文件
+
+將這些文件複製到您的專案：
+
+**macOS / Linux:**
+```bash
+# In your project root
+mkdir -p .standards
+
+# Copy Level 1 reference documents
+cp path/to/universal-dev-standards/core/checkin-standards.md .standards/
+cp path/to/universal-dev-standards/core/spec-driven-development.md .standards/
+```
+
+**Windows PowerShell:**
+```powershell
+# In your project root
+New-Item -ItemType Directory -Force -Path .standards
+
+# Copy Level 1 reference documents
+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\
+```
+
+**檢查清單**:
+- [ ] `.standards/` 目錄已建立
+- [ ] `checkin-standards.md` 已複製
+- [ ] `spec-driven-development.md` 已複製
+
+---
+
+## 驗證
+
+### 測試 Skills
+
+1. Open Claude Code in your project
+2. Try: "Help me write a commit message" → Should follow Conventional Commits
+3. Ask about code changes → Should provide evidence-based responses
+
+### 檢閱參考文件
+
+- [ ] Read `checkin-standards.md` and understand quality gates
+- [ ] Read `spec-driven-development.md` and understand the methodology
+
+---
+
+## 最終檢查清單
+
+| Item | Status |
+|------|--------|
+| ai-collaboration-standards skill | [ ] |
+| commit-standards skill | [ ] |
+| .standards/checkin-standards.md | [ ] |
+| .standards/spec-driven-development.md | [ ] |
+
+---
+
+## 下一步
+
+準備升級到等級二（推薦）時：
+- 參見 [recommended.md](recommended.md)
+
+---
+
+## 相關標準
+
+- [Recommended Adoption Checklist](recommended.md) - Level 2 升級指南
+- [Enterprise Adoption Checklist](enterprise.md) - Level 3 升級指南
+- [Checkin Standards](../../../core/checkin-standards.md) - 簽入標準
+- [Spec-Driven Development](../../../core/spec-driven-development.md) - 規格驅動開發
+
+---
+
+## 版本歷史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.1 | 2025-12-24 | Added: Related Standards, License sections |
+| 1.0.0 | 2025-12-23 | Initial checklist |
+
+---
+
+## 授權
+
+本檢查清單以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/adoption/checklists/recommended.md

@@ -0,0 +1,272 @@
+---
+source: ../../../../adoption/checklists/recommended.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 等級二：推薦採用檢查清單
+
+> **語言**: [English](../../../adoption/checklists/recommended.md) | 繁體中文
+
+> 團隊專案的專業品質標準
+>
+> 設置時間：約 2 小時
+
+---
+
+## 前置條件
+
+- [ ] 等級一（基本）已完成
+- [ ] 團隊已同意採用
+
+---
+
+## Skills 安裝
+
+安裝額外的等級二 skills:
+
+**推薦：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**檢查清單**:
+
+### 來自等級一
+- [ ] ai-collaboration-standards
+- [ ] commit-standards
+
+### 等級二 Skills
+- [ ] code-review-assistant
+- [ ] git-workflow-guide
+- [ ] release-standards
+- [ ] testing-guide
+- [ ] requirement-assistant
+
+---
+
+## 參考文件
+
+等級二沒有超出等級一的額外參考文件。
+
+**驗證等級一文件**:
+- [ ] `.standards/checkin-standards.md` exists
+- [ ] `.standards/spec-driven-development.md` exists
+
+---
+
+## 延伸規範（選擇適用的）
+
+### 語言延伸
+
+**用於 C# 專案（macOS / Linux）**:
+```bash
+cp path/to/universal-dev-standards/extensions/languages/csharp-style.md .standards/
+```
+
+**用於 C# 專案（Windows PowerShell）**:
+```powershell
+Copy-Item path\to\universal-dev-standards\extensions\languages\csharp-style.md .standards\
+```
+- [ ] `csharp-style.md` copied (if applicable)
+
+**用於 PHP 專案（macOS / Linux）**:
+```bash
+cp path/to/universal-dev-standards/extensions/languages/php-style.md .standards/
+```
+
+**用於 PHP 專案（Windows PowerShell）**:
+```powershell
+Copy-Item path\to\universal-dev-standards\extensions\languages\php-style.md .standards\
+```
+- [ ] `php-style.md` copied (if applicable)
+
+### 框架延伸
+
+**用於 Fat-Free 框架（macOS / Linux）**:
+```bash
+cp path/to/universal-dev-standards/extensions/frameworks/fat-free-patterns.md .standards/
+```
+
+**用於 Fat-Free 框架（Windows PowerShell）**:
+```powershell
+Copy-Item path\to\universal-dev-standards\extensions\frameworks\fat-free-patterns.md .standards\
+```
+- [ ] `fat-free-patterns.md` copied (if applicable)
+
+### 地區延伸
+
+**用於繁體中文團隊（macOS / Linux）**:
+```bash
+cp path/to/universal-dev-standards/extensions/locales/zh-tw.md .standards/
+```
+
+**用於繁體中文團隊（Windows PowerShell）**:
+```powershell
+Copy-Item path\to\universal-dev-standards\extensions\locales\zh-tw.md .standards\
+```
+- [ ] `zh-tw.md` copied (if applicable)
+
+---
+
+## AI 工具整合
+
+根據您的工具選擇並安裝：
+
+### GitHub Copilot
+
+**macOS / Linux:**
+```bash
+mkdir -p .github
+cp path/to/universal-dev-standards/integrations/github-copilot/copilot-instructions.md .github/
+```
+
+**Windows PowerShell:**
+```powershell
+New-Item -ItemType Directory -Force -Path .github
+Copy-Item path\to\universal-dev-standards\integrations\github-copilot\copilot-instructions.md .github\
+```
+- [ ] `.github/copilot-instructions.md` installed
+
+### Cursor IDE
+
+**macOS / Linux:**
+```bash
+cp path/to/universal-dev-standards/integrations/cursor/.cursorrules .
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item path\to\universal-dev-standards\integrations\cursor\.cursorrules .
+```
+- [ ] `.cursorrules` installed
+
+### Windsurf IDE
+
+**macOS / Linux:**
+```bash
+cp path/to/universal-dev-standards/integrations/windsurf/.windsurfrules .
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item path\to\universal-dev-standards\integrations\windsurf\.windsurfrules .
+```
+- [ ] `.windsurfrules` installed
+
+### Cline
+
+**macOS / Linux:**
+```bash
+cp path/to/universal-dev-standards/integrations/cline/.clinerules .
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item path\to\universal-dev-standards\integrations\cline\.clinerules .
+```
+- [ ] `.clinerules` installed
+
+### OpenSpec (for SDD workflow)
+
+**macOS / Linux:**
+```bash
+cp -r path/to/universal-dev-standards/integrations/openspec/ .openspec/
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item -Recurse path\to\universal-dev-standards\integrations\openspec\ .openspec\
+```
+- [ ] `.openspec/` directory installed
+
+---
+
+## 團隊配置
+
+### Git 工作流程選擇
+
+Review `git-workflow.md` and select:
+- [ ] Trunk-Based Development
+- [ ] GitHub Flow
+- [ ] GitFlow
+
+Document decision in project README or CONTRIBUTING.md.
+
+### 程式碼審查流程
+
+- [ ] Define required reviewers
+- [ ] Set up branch protection rules
+- [ ] Configure code-review-assistant skill settings
+
+### 測試標準
+
+- [ ] Define coverage targets (recommended: 70/20/7/3)
+- [ ] Set up CI/CD pipeline
+- [ ] Configure testing-guide skill settings
+
+---
+
+## 驗證
+
+### 測試所有 Skills
+
+1. **commit-standards**: Write a commit → Should follow Conventional Commits
+2. **code-review-assistant**: Review code → Should use systematic checklist
+3. **git-workflow-guide**: Ask about branching → Should explain chosen workflow
+4. **release-standards**: Ask about versioning → Should explain SemVer
+5. **testing-guide**: Ask about tests → Should explain testing pyramid
+
+### 驗證整合
+
+- [ ] AI tool follows project standards
+- [ ] AI tool provides evidence-based responses
+
+---
+
+## 最終檢查清單
+
+| Category | Items | Status |
+|----------|-------|--------|
+| **Level 1 Skills** | ai-collaboration-standards, commit-standards | [ ] |
+| **Level 2 Skills** | code-review-assistant, git-workflow-guide, release-standards, testing-guide, requirement-assistant | [ ] |
+| **Reference Docs** | checkin-standards.md, spec-driven-development.md | [ ] |
+| **Extensions** | (selected based on project) | [ ] |
+| **Integrations** | (selected based on tools) | [ ] |
+| **Team Config** | Workflow, review process, testing targets | [ ] |
+
+---
+
+## 下一步
+
+準備升級到等級三（企業）時：
+- 參見 [enterprise.md](enterprise.md)
+
+---
+
+## 相關標準
+
+- [Essential Adoption Checklist](minimal.md) - Level 1 基本採用
+- [Enterprise Adoption Checklist](enterprise.md) - Level 3 升級指南
+- [Checkin Standards](../../../core/checkin-standards.md) - 簽入標準
+- [Git Workflow](../../../core/git-workflow.md) - Git 工作流程
+- [Testing Standards](../../../core/testing-standards.md) - 測試標準
+- [Code Review Checklist](../../../core/code-review-checklist.md) - 程式碼審查
+
+---
+
+## 版本歷史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.1 | 2025-12-24 | Added: Related Standards, License sections |
+| 1.0.0 | 2025-12-23 | Initial checklist |
+
+---
+
+## 授權
+
+本檢查清單以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。