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

package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md

@@ -0,0 +1,299 @@
+---
+source: ../../../adoption/STATIC-DYNAMIC-GUIDE.md
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 靜態與動態規範指南
+
+> **語言**: [English](../../../adoption/STATIC-DYNAMIC-GUIDE.md) | 繁體中文
+
+**版本**: 1.2.0
+**最後更新**: 2026-01-07
+**適用範圍**: 使用本規範框架與 AI 助理協作的專案
+
+---
+
+## 目的
+
+本指南說明如何根據應用時機分類和部署開發規範。
+
+---
+
+## 分類概覽
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│           純靜態規範                                         │
+│           隨時生效，嵌入專案 context 檔案中                   │
+├─────────────────────────────────────────────────────────────┤
+│  • checkin-standards    → 編譯、測試、覆蓋率檢查點            │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│           雙重性質規範（靜態 + 動態）                         │
+│           核心規則在 context 中 + 完整指引按需觸發            │
+├─────────────────────────────────────────────────────────────┤
+│  • anti-hallucination   → 基礎規則隨時生效，詳細指引         │
+│                           透過 ai-collaboration-standards    │
+│                           技能按需觸發                       │
+│  • project-structure    → 基礎慣例隨時生效，詳細指引         │
+│                           透過 project-structure-guide       │
+│                           技能按需觸發                       │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│           純動態規範（15 個技能）                             │
+│           關鍵字觸發，按需載入                                │
+├─────────────────────────────────────────────────────────────┤
+│  • ai-collaboration-standards ← "certainty", "確定性"        │
+│  • changelog-guide      ← "changelog", "變更日誌"            │
+│  • code-review-assistant← "review", "PR", "審查"             │
+│  • commit-standards     ← "commit", "git", "提交"            │
+│  • documentation-guide  ← "docs", "README", "文件"           │
+│  • error-code-guide     ← "error code", "錯誤碼"             │
+│  • git-workflow-guide   ← "branch", "merge", "分支"          │
+│  • logging-guide        ← "logging", "日誌"                  │
+│  • project-structure-guide ← "structure", "結構"             │
+│  • release-standards    ← "version", "release", "版本"       │
+│  • requirement-assistant← "spec", "SDD", "規格"              │
+│  • spec-driven-dev      ← "spec", "proposal", "提案"         │
+│  • tdd-assistant        ← "TDD", "test first", "紅綠重構"    │
+│  • test-coverage-assistant ← "test coverage", "測試覆蓋"     │
+│  • testing-guide        ← "test", "測試"                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 純靜態規範
+
+### 定義
+
+無論執行何種任務，AI 互動時都應該**隨時生效**的規範。這些是強制性規則，無需選擇。
+
+### 特徵
+
+- 適用於所有互動（無特定觸發）
+- 內容精簡（適合放在專案 context 文件）
+- 低 token 開銷
+- 基礎行為準則
+- 強制性規則，無需決策支援
+
+### 純靜態規範清單
+
+| 規範 | 核心規則 | 核心目的 |
+|------|---------|---------|
+| [checkin-standards](../../core/checkin-standards.md) | 編譯通過、測試通過、覆蓋率維持 | 確保 commit 前的程式碼品質 |
+
+### 部署方式
+
+將以下任一檔案加入專案根目錄：
+
+- `CLAUDE.md` (Claude Code)
+- `.cursorrules` (Cursor)
+- `.github/copilot-instructions.md` (GitHub Copilot)
+- `AI_GUIDELINES.md` (通用)
+
+**範本**: 參見 [CLAUDE.md.template](../../../templates/CLAUDE.md.template)
+
+---
+
+## 雙重性質規範（靜態 + 動態）
+
+### 定義
+
+同時具有**靜態和動態元件**的規範：
+- **靜態元件**：核心規則嵌入專案 context（隨時生效）
+- **動態元件**：完整技能提供詳細指引（按需觸發）
+
+### 特徵
+
+- 核心規則足夠精簡，可放入 context 檔案
+- 詳細指引若隨時載入會使 context 膨脹
+- 兩種使用模式都有效且互補
+
+### 雙重性質規範清單
+
+| 規範 | 靜態元件 | 動態技能 | 觸發關鍵字 |
+|------|----------|----------|------------|
+| [anti-hallucination](../../core/anti-hallucination.md) | 確定性標籤、建議原則 | ai-collaboration-standards | certainty, assumption, 確定性 |
+| [project-structure](../../core/project-structure.md) | 目錄慣例 | project-structure-guide | structure, organization, 結構 |
+
+### 部署方式
+
+1. **靜態**：將核心規則摘要加入 `CLAUDE.md`
+2. **動態**：安裝對應的技能以獲得詳細指引
+
+---
+
+## 純動態規範
+
+### 定義
+
+由**特定關鍵字**或任務觸發，按需載入以提供詳細指引的規範。
+
+### 特徵
+
+- 有特定觸發條件（關鍵字、指令）
+- 內容詳細（若隨時載入會使 context 膨脹）
+- 僅在相關時載入
+- 任務特定的工作流程
+- 需要決策支援（選擇、建議）
+
+### 動態規範清單（15 個技能）
+
+| 規範 | 技能 | 觸發關鍵字 |
+|------|------|-----------|
+| [anti-hallucination](../../core/anti-hallucination.md) | ai-collaboration-standards | certainty, assumption, 確定性 |
+| [changelog-standards](../../core/changelog-standards.md) | changelog-guide | changelog, release notes, 變更日誌 |
+| [code-review-checklist](../../core/code-review-checklist.md) | code-review-assistant | review, PR, 審查 |
+| [commit-message-guide](../../core/commit-message-guide.md) | commit-standards | commit, git, 提交, feat, fix |
+| [documentation-structure](../../core/documentation-structure.md) | documentation-guide | README, docs, 文件 |
+| [documentation-writing-standards](../../core/documentation-writing-standards.md) | documentation-guide | documentation |
+| [error-code-standards](../../core/error-code-standards.md) | error-code-guide | error code, error handling, 錯誤碼 |
+| [git-workflow](../../core/git-workflow.md) | git-workflow-guide | branch, merge, 分支 |
+| [logging-standards](../../core/logging-standards.md) | logging-guide | logging, log level, 日誌 |
+| [project-structure](../../core/project-structure.md) | project-structure-guide | structure, organization, 結構 |
+| [spec-driven-development](../../core/spec-driven-development.md) | requirement-assistant | spec, SDD, 規格, 新功能 |
+| [spec-driven-development](../../core/spec-driven-development.md) | spec-driven-dev | spec, proposal, 提案 |
+| [test-driven-development](../../core/test-driven-development.md) | tdd-assistant | TDD, test first, 紅綠重構 |
+| [test-completeness-dimensions](../../core/test-completeness-dimensions.md) | test-coverage-assistant | test coverage, 7 dimensions, 測試覆蓋 |
+| [testing-standards](../../core/testing-standards.md) | testing-guide | test, 測試, coverage |
+| [versioning](../../core/versioning.md) | release-standards | version, release, 版本 |
+
+### 部署方式
+
+**推薦：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**替代方案：手動安裝（macOS / Linux）**
+```bash
+mkdir -p ~/.claude/skills
+cp -r skills/claude-code/commit-standards ~/.claude/skills/
+```
+
+**替代方案：手動安裝（Windows PowerShell）**
+```powershell
+Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
+```
+
+詳見 [Claude Code Skills README](../../../skills/claude-code/README.md)。
+
+---
+
+## 決策流程圖
+
+```
+                    ┌─────────────────┐
+                    │    新規範       │
+                    └────────┬────────┘
+                             │
+                             ▼
+               ┌─────────────────────────┐
+               │ 是否適用於所有           │
+               │ AI 互動？               │
+               └────────────┬────────────┘
+                            │
+              ┌─────────────┴─────────────┐
+              │                           │
+             是                           否
+              │                           │
+              ▼                           ▼
+    ┌─────────────────┐      ┌─────────────────────────┐
+    │ 靜態規範         │      │ 能否由關鍵字             │
+    │ 加入專案         │      │ 觸發？                  │
+    │ context 檔案    │      └────────────┬────────────┘
+    └─────────────────┘                   │
+                               ┌──────────┴──────────┐
+                               │                     │
+                              是                     否
+                               │                     │
+                               ▼                     ▼
+                    ┌─────────────────┐   ┌─────────────────┐
+                    │ 動態規範         │   │ 考慮是否應該      │
+                    │ 建立為 Skill    │   │ 拆分或合併       │
+                    │ 並設定關鍵字     │   └─────────────────┘
+                    └─────────────────┘
+```
+
+---
+
+## Skill 觸發機制
+
+Skills 使用 YAML frontmatter 定義觸發條件：
+
+```yaml
+---
+name: commit-standards
+description: |
+  遵循 conventional commits 標準格式化 commit 訊息。
+  使用時機：撰寫 commit 訊息、git commit、檢閱 commit 歷史。
+  關鍵字：commit, git, message, conventional, 提交, 訊息, feat, fix, refactor。
+---
+```
+
+**關鍵元素**:
+- `Use when:` - 描述觸發情境
+- `Keywords:` - 列出觸發關鍵字（支援多語言）
+
+---
+
+## 最佳實踐
+
+### 靜態規範
+
+1. **保持精簡**：專案 context 檔案最多 100-200 行
+2. **聚焦行為**：AI 應該隨時做/避免的事
+3. **包含快速參考**：精簡表格，非完整文件
+4. **連結詳細內容**：參考完整標準以深入了解
+
+### 動態規範
+
+1. **選擇清晰關鍵字**：明確、常用的術語
+2. **支援多語言**：為中文使用者包含中文關鍵字
+3. **群組相關規範**：如 testing-guide 涵蓋 testing-standards 與 test-completeness
+4. **提供快速參考**：Skills 頂部應有精簡摘要
+
+---
+
+## 遷移指南
+
+### 從完整規則到靜態+動態
+
+如果目前所有規則都在一個檔案中：
+
+1. **提取靜態規則**：將 anti-hallucination、checkin、結構規則移至 `CLAUDE.md`
+2. **轉換動態規則為 Skills**：為任務特定規則建立或安裝 Skills
+3. **移除重複內容**：從 context 檔案刪除重複的規則
+4. **測試觸發**：驗證 Skills 在預期關鍵字時啟動
+
+---
+
+## 相關資源
+
+- [CLAUDE.md 範本](../../../templates/CLAUDE.md.template) - 可立即使用的靜態規則範本
+- [Claude Code Skills](../../../skills/claude-code/README.md) - 技能安裝指南
+- [採用指南](ADOPTION-GUIDE.md) - 整體採用策略
+- [MAINTENANCE.md](../MAINTENANCE.md) - 如何新增/更新技能（維護者專用）
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.2.0 | 2026-01-07 | 新增 tdd-assistant 技能，更新至 15 個技能 |
+| 1.1.0 | 2025-12-30 | 新增雙重性質規範分類，更新至 14 個技能 |
+| 1.0.0 | 2025-12-24 | 初始指南 |
+
+---
+
+## 授權
+
+本指南以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

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

@@ -0,0 +1,332 @@
+---
+source: ../../../../adoption/checklists/enterprise.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 等級三：企業採用檢查清單
+
+> **語言**: [English](../../../adoption/checklists/enterprise.md) | 繁體中文
+
+> 企業或受監管專案的全面標準
+>
+> 設置時間：1-2 天
+
+---
+
+## 前置條件
+
+- [ ] 等級二（推薦）已完成
+- [ ] 利害關係人已批准全面採用
+- [ ] 已分配時間進行文件審查
+
+---
+
+## Skills 安裝
+
+確保安裝所有 skills:
+
+**推薦：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**完整 Skills 檢查清單**:
+
+### Level 1 Skills
+- [ ] ai-collaboration-standards
+- [ ] commit-standards
+
+### Level 2 Skills
+- [ ] code-review-assistant
+- [ ] git-workflow-guide
+- [ ] release-standards
+- [ ] testing-guide
+- [ ] requirement-assistant
+
+### Level 3 Skills
+- [ ] documentation-guide
+
+---
+
+## 參考文件
+
+複製所有參考文件到您的專案：
+
+**macOS / Linux:**
+```bash
+# In your project root
+mkdir -p .standards
+
+# 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/
+
+# Level 3 reference documents
+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
+# In your project root
+New-Item -ItemType Directory -Force -Path .standards
+
+# 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\
+
+# Level 3 reference documents
+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\
+```
+
+**檢查清單**:
+- [ ] `checkin-standards.md` (Level 1)
+- [ ] `spec-driven-development.md` (Level 1)
+- [ ] `documentation-writing-standards.md` (Level 3)
+- [ ] `project-structure.md` (Level 3)
+
+---
+
+## 模板
+
+### 遷移模板（如適用）
+
+用於涉及技術遷移的專案：
+
+**macOS / Linux:**
+```bash
+cp path/to/universal-dev-standards/templates/migration-template.md docs/
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item path\to\universal-dev-standards\templates\migration-template.md docs\
+```
+- [ ] `migration-template.md` copied (if applicable)
+
+---
+
+## 延伸規範
+
+驗證等級二的所有適用延伸規範已安裝：
+
+### 語言延伸
+- [ ] `csharp-style.md` (if C# project)
+- [ ] `php-style.md` (if PHP project)
+
+### 框架延伸
+- [ ] `fat-free-patterns.md` (if Fat-Free project)
+
+### 地區延伸
+- [ ] `zh-tw.md` (if Traditional Chinese team)
+
+---
+
+## AI 工具整合
+
+驗證等級二的所有適用整合已安裝：
+
+- [ ] GitHub Copilot: `.github/copilot-instructions.md`
+- [ ] Cursor: `.cursorrules`
+- [ ] Windsurf: `.windsurfrules`
+- [ ] Cline: `.clinerules`
+- [ ] OpenSpec: `.openspec/`
+
+---
+
+## 文件結構
+
+遵循 `documentation-structure.md`，設置：
+
+```
+project/
+├── README.md
+├── CONTRIBUTING.md
+├── CHANGELOG.md
+├── docs/
+│   ├── architecture/
+│   ├── api/
+│   ├── guides/
+│   └── adr/          # Architecture Decision Records
+├── .standards/
+│   ├── checkin-standards.md
+│   ├── spec-driven-development.md
+│   ├── documentation-writing-standards.md
+│   └── project-structure.md
+└── ...
+```
+
+**檢查清單**:
+- [ ] `README.md` created/updated
+- [ ] `CONTRIBUTING.md` created
+- [ ] `CHANGELOG.md` created
+- [ ] `docs/` directory structure created
+- [ ] `docs/adr/` for Architecture Decision Records
+
+---
+
+## 專案結構
+
+遵循 `project-structure.md`，驗證：
+
+```
+project/
+├── src/              # Source code
+├── tests/            # Test files
+├── tools/            # Build and development tools
+├── examples/         # Example code
+├── dist/             # Build output (gitignored)
+└── ...
+```
+
+- [ ] Directory structure follows standard
+- [ ] `.gitignore` properly configured
+
+---
+
+## 治理
+
+### 文件標準
+
+遵循 `documentation-writing-standards.md`:
+
+- [ ] Document matrix defined (which docs for which project type)
+- [ ] Writing guidelines communicated to team
+- [ ] Review process for documentation established
+
+### 品質閘門
+
+遵循 `checkin-standards.md`:
+
+- [ ] Pre-commit hooks configured
+- [ ] CI/CD pipeline enforces standards
+- [ ] Build verification automated
+
+### 規格驅動開發
+
+遵循 `spec-driven-development.md`:
+
+- [ ] Team trained on SDD methodology
+- [ ] OpenSpec (or equivalent) workflow established
+- [ ] Spec → Implementation → Verification cycle defined
+
+---
+
+## 合規與稽核軌跡
+
+適用於受監管產業：
+
+- [ ] Standards adoption documented
+- [ ] Change management process defined
+- [ ] Version control for all standards
+- [ ] Regular standards review scheduled
+
+---
+
+## 驗證
+
+### 完整 Skills 測試
+
+以相關情境測試每個 skill:
+
+| Skill | Test Scenario | Pass |
+|-------|--------------|------|
+| ai-collaboration-standards | Ask for unverified claim | [ ] |
+| commit-standards | Write complex commit | [ ] |
+| code-review-assistant | Review PR | [ ] |
+| git-workflow-guide | Explain branching strategy | [ ] |
+| release-standards | Plan a release | [ ] |
+| testing-guide | Design test strategy | [ ] |
+| requirement-assistant | Write user story | [ ] |
+| documentation-guide | Plan documentation | [ ] |
+
+### 文件稽核
+
+- [ ] All required documents exist
+- [ ] Documents follow writing standards
+- [ ] Documents are up-to-date
+
+### 整合驗證
+
+- [ ] All AI tools follow project standards
+- [ ] CI/CD enforces quality gates
+- [ ] Team follows established workflows
+
+---
+
+## 最終檢查清單
+
+| Category | Items | Status |
+|----------|-------|--------|
+| **All Skills (8)** | Complete set installed | [ ] |
+| **Reference Docs (4)** | All Level 1 + Level 3 docs | [ ] |
+| **Extensions** | All applicable installed | [ ] |
+| **Integrations** | All tools configured | [ ] |
+| **Documentation** | Structure established | [ ] |
+| **Project Structure** | Follows standard | [ ] |
+| **Governance** | Processes defined | [ ] |
+| **Verification** | All tests passed | [ ] |
+
+---
+
+## 維護
+
+### 定期審查
+
+- [ ] Monthly: Review standards compliance
+- [ ] Quarterly: Update standards if needed
+- [ ] Annually: Full standards audit
+
+### 更新
+
+監控更新：
+- [ ] Subscribe to universal-dev-standards releases
+- [ ] Subscribe to universal-dev-skills releases
+- [ ] Plan upgrade process for new versions
+
+---
+
+## 摘要
+
+完成後，您的專案具有：
+
+- Full AI assistance with 8 Claude Code Skills
+- Complete reference documentation
+- Language/framework-specific guidelines
+- All AI tool integrations
+- Proper documentation structure
+- Standard project organization
+- Governance processes
+
+您的專案現在遵循企業級文件標準。
+
+---
+
+## 相關標準
+
+- [Essential Adoption Checklist](minimal.md) - Level 1 基本採用
+- [Recommended Adoption Checklist](recommended.md) - Level 2 推薦採用
+- [Documentation Writing Standards](../../../core/documentation-writing-standards.md) - 文件撰寫規範
+- [Project Structure](../../../core/project-structure.md) - 專案結構標準
+- [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/) 授權發布。