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

package/bundled/locales/zh-TW/integrations/openspec/README.md

@@ -0,0 +1,43 @@
+---
+source: ../../../../integrations/openspec/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# OpenSpec 整合
+
+本目錄包含 [OpenSpec](https://github.com/openspec) 的整合檔案，這是一個用於規格驅動開發的規格管理工具。
+
+## 檔案
+
+| 檔案 | 說明 |
+|------|------|
+| `AGENTS.md` | 使用 OpenSpec 的 AI 助手完整指令 |
+
+## 使用方式
+
+### 手動安裝
+
+將 `AGENTS.md` 複製到專案的 `openspec/` 目錄，或將其內容包含在 AI 助手的系統指令中。
+
+### 搭配 Claude Code
+
+如果使用 Claude Code，您可以在 `CLAUDE.md` 中引用此檔案：
+
+```markdown
+## 規格驅動開發
+
+本專案使用 OpenSpec 進行規格管理。請遵循以下指南：
+- [OpenSpec 指令](openspec/AGENTS.md)
+```
+
+## 相關資源
+
+- [Spec Kit 整合](../spec-kit/) - 替代的輕量級 SDD 工具
+- [規格驅動開發標準](../../core/spec-driven-development.md) - SDD 方法論
+
+## 注意事項
+
+OpenSpec 和 Spec Kit 是**規格驅動開發工具**，不是 AI 編碼助手。它們不包含在 `uds init` 的 AI 工具選擇中，但可以根據需要手動整合。

package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md

@@ -0,0 +1,184 @@
+---
+source: ../../../../integrations/spec-kit/AGENTS.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Spec Kit 指令
+
+使用 Spec Kit 進行規格驅動開發的 AI 編碼助手指令。
+
+## 使用方式
+
+將此檔案複製到您的專案，或包含在 AI 助手的系統指令中。
+
+---
+
+## 使用 Spec Kit 進行規格驅動開發
+
+當此專案啟用 Spec Kit 時，您必須遵循**規格驅動開發（SDD）**方法論。
+
+### 核心原則：規格優先，程式碼其次
+
+**規則**：沒有對應的已核准規格，不得進行任何功能性程式碼變更。
+
+**例外情況**：
+- 緊急修復（立即恢復服務，事後記錄）
+- 瑣碎變更（錯字、註解、格式）
+
+---
+
+## Spec Kit 指令
+
+當 Spec Kit 可用時，優先使用這些指令：
+
+| 指令 | 說明 |
+|------|------|
+| `/spec create <title>` | 建立新規格 |
+| `/spec list` | 列出所有活躍規格 |
+| `/spec show <id>` | 顯示規格詳情 |
+| `/spec approve <id>` | 標記規格為已核准 |
+| `/spec close <id>` | 關閉已完成規格 |
+| `/spec archive <id>` | 封存規格 |
+
+### 指令優先順序
+
+**規則**：始終優先使用 Spec Kit 指令，而非手動編輯檔案。
+
+**理由**：
+- **一致性**：確保規格結構遵循 schema
+- **可追溯性**：自動產生 ID 和連結
+- **驗證**：內建檢查防止無效狀態
+
+---
+
+## SDD 工作流程
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│     提案     │───▶│     審查     │───▶│     實作     │
+└──────────────┘    └──────────────┘    └──────────────┘
+                                               │
+                                               ▼
+                    ┌──────────────┐    ┌──────────────┐
+                    │     封存     │◀───│     驗證     │
+                    └──────────────┘    └──────────────┘
+```
+
+### 工作流程階段
+
+| 階段 | 說明 | 操作 |
+|------|------|------|
+| **提案** | 定義變更內容和原因 | `/spec create` |
+| **審查** | 利害關係人核准 | `/spec approve` |
+| **實作** | 執行已核准規格 | 程式碼變更 |
+| **驗證** | 確認實作符合規格 | 測試 |
+| **封存** | 關閉並封存規格 | `/spec close` |
+
+---
+
+## 任何任務之前
+
+**脈絡檢查清單**：
+- [ ] 檢查活躍規格：`/spec list`
+- [ ] 變更前審查相關規格
+- [ ] 確認無衝突規格
+- [ ] 非瑣碎變更需建立規格
+
+**可跳過規格的情況**：
+- 錯誤修復（恢復預期行為）
+- 錯字、格式、註解
+- 依賴更新（非破壞性）
+- 配置變更
+
+---
+
+## 規格文件範本
+
+手動建立規格時，使用此結構：
+
+```markdown
+# [SPEC-ID] 功能標題
+
+## 摘要
+簡述提議變更。
+
+## 動機
+為何需要此變更？解決什麼問題？
+
+## 詳細設計
+技術方案、受影響元件、資料流程。
+
+## 驗收標準
+- [ ] 標準 1
+- [ ] 標準 2
+
+## 依賴項
+列出對其他規格或外部系統的依賴。
+
+## 風險
+潛在風險和緩解策略。
+```
+
+---
+
+## 與通用文件規範的整合
+
+### Commit 訊息
+
+在 commit 訊息中引用規格 ID：
+
+```
+feat(auth): 實作登入功能
+
+實作 SPEC-001 登入功能，支援 OAuth2。
+
+Refs: SPEC-001
+```
+
+### 程式碼審查
+
+審查者應確認：
+- [ ] 變更符合已核准規格
+- [ ] 無超出規格的範圍蔓延
+- [ ] 規格驗收標準已達成
+
+---
+
+## 最佳實踐
+
+### 應該做的
+- 保持規格聚焦且原子化（每個規格一項變更）
+- 包含清晰的驗收標準
+- 將規格連結到實作 PR
+- 完成後封存規格
+
+### 不應該做的
+- 規格核准前開始編碼
+- 實作期間修改範圍而不更新規格
+- 讓規格處於懸而未決狀態（始終關閉或封存）
+- 跳過驗證步驟
+
+---
+
+## 相關標準
+
+- [規格驅動開發](../../core/spec-driven-development.md) - SDD 方法論
+- [Commit 訊息指南](../../core/commit-message-guide.md) - Commit 慣例
+- [程式碼簽入標準](../../core/checkin-standards.md) - 簽入要求
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2025-12-30 | 初始 Spec Kit 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/spec-kit/README.md

@@ -0,0 +1,43 @@
+---
+source: ../../../../integrations/spec-kit/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Spec Kit 整合
+
+本目錄包含 [Spec Kit](https://github.com/spec-kit/spec-kit) 的整合檔案，這是一個用於規格驅動開發的輕量級規格追蹤工具。
+
+## 檔案
+
+| 檔案 | 說明 |
+|------|------|
+| `AGENTS.md` | 使用 Spec Kit 的 AI 助手指令 |
+
+## 使用方式
+
+### 手動安裝
+
+將 `AGENTS.md` 複製到您的專案，或將其內容包含在 AI 助手的系統指令中。
+
+### 搭配 Claude Code
+
+如果使用 Claude Code，您可以在 `CLAUDE.md` 中引用此檔案：
+
+```markdown
+## 規格驅動開發
+
+本專案使用 Spec Kit 進行規格管理。請遵循以下指南：
+- [Spec Kit 指令](integrations/spec-kit/AGENTS.md)
+```
+
+## 相關資源
+
+- [OpenSpec 整合](../openspec/) - 替代的 SDD 工具整合
+- [規格驅動開發標準](../../core/spec-driven-development.md) - SDD 方法論
+
+## 注意事項
+
+Spec Kit 和 OpenSpec 是**規格驅動開發工具**，不是 AI 編碼助手。它們不包含在 `uds init` 的 AI 工具選擇中，但可以根據需要手動整合。

package/bundled/locales/zh-TW/options/commit-message/bilingual.md

@@ -0,0 +1,161 @@
+---
+source: ../../../../options/commit-message/bilingual.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 雙語 Commit 訊息
+
+> **語言**: [English](../../../../options/commit-message/bilingual.md) | 繁體中文
+
+**上層標準**: [Commit 訊息指南](../../core/commit-message-guide.md)
+
+---
+
+## 概述
+
+雙語 commit 訊息以結構化格式結合英文和繁體中文。此方法在維持國際可及性的同時，為中文團隊成員提供清晰的溝通。
+
+## 適用情境
+
+- 語言背景混合的團隊
+- 轉型為國際標準的公司
+- 同時有本地和國際貢獻者的專案
+- 需要雙語文件的組織
+
+## 格式
+
+### 基本結構
+
+```
+<type>(<scope>): <英文主題>
+
+<英文說明>
+
+<中文說明>
+
+<footer>
+```
+
+### 替代格式
+
+```
+<type>(<scope>): <English> / <中文>
+
+<詳細英文說明>
+
+<詳細中文說明>
+
+<footer>
+```
+
+## 範例
+
+### 功能
+
+```
+feat(auth): add two-factor authentication
+
+Add support for TOTP-based two-factor authentication.
+Users can enable 2FA from their security settings.
+
+新增基於 TOTP 的雙因素驗證支援。
+使用者可以從安全設定中啟用 2FA。
+
+Closes #234
+```
+
+### 錯誤修復
+
+```
+fix(api): handle timeout in payment processing
+
+The payment gateway timeout was causing silent failures.
+Added proper error handling and user notification.
+
+付款閘道逾時導致靜默失敗。
+新增適當的錯誤處理和使用者通知。
+
+Fixes #567
+```
+
+### 重大變更
+
+```
+feat(api): migrate to GraphQL API
+
+BREAKING CHANGE: REST API endpoints are deprecated.
+All clients must migrate to GraphQL by v3.0.
+
+重大變更：REST API 端點已棄用。
+所有客戶端必須在 v3.0 前遷移至 GraphQL。
+
+Migration guide / 遷移指南：
+- Replace REST calls with GraphQL queries
+- 將 REST 呼叫替換為 GraphQL 查詢
+
+Closes #789
+```
+
+### 精簡格式
+
+對於較小的變更，使用行內雙語格式：
+
+```
+fix(ui): correct button alignment / 修正按鈕對齊
+
+style(css): update color scheme / 更新配色方案
+
+docs: fix typo in README / 修正 README 錯字
+```
+
+## 撰寫指南
+
+| 指南 | 說明 |
+|------|------|
+| 英文優先 | 英文放在中文之前 |
+| 各語言 50 字元 | 每種語言保持簡潔 |
+| 英文祈使語氣 | 使用動詞原形 |
+| 中文動詞開頭 | 新增、修正、更新等 |
+
+## 最佳實踐
+
+### 建議
+
+- 保持兩種語言同步
+- 使用一致的格式
+- 審閱兩種語言版本
+- 使用各語言適當的慣用語
+
+### 避免
+
+- 在句子中混合語言
+- 使用未經審閱的機器翻譯
+- 「小變更」時跳過一種語言
+- 不必要地翻譯技術術語
+
+## 技術術語
+
+保持技術術語使用英文：
+
+| 術語 | 使用方式 |
+|------|----------|
+| API、REST、GraphQL | 不翻譯 |
+| CRUD 操作 | 不翻譯 |
+| Git 指令 | 不翻譯 |
+| 框架名稱 | 不翻譯 |
+
+## 相關選項
+
+- [英文](./english.md) - 純英文格式
+- [繁體中文](./traditional-chinese.md) - 純中文格式
+
+---
+
+## 授權條款
+
+本文件採用 [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/options/commit-message/english.md

@@ -0,0 +1,137 @@
+---
+source: ../../../../options/commit-message/english.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 英文 Commit 訊息
+
+> **語言**: [English](../../../../options/commit-message/english.md) | 繁體中文
+
+**上層標準**: [Commit 訊息指南](../../core/commit-message-guide.md)
+
+---
+
+## 概述
+
+此選項定義完全使用英文撰寫 commit 訊息的標準。英文是軟體開發中使用最廣泛的語言，使 commit 對全球開發者社群都可理解。
+
+## 適用情境
+
+- 國際團隊
+- 開源專案
+- 有外部貢獻者的專案
+- 以英文為公司語言的組織
+- 追求最大可及性的專案
+
+## 格式
+
+### 基本結構
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+### 組成元素
+
+| 元素 | 必填 | 說明 |
+|------|------|------|
+| type | 是 | 變更類別（feat、fix、docs 等）|
+| scope | 否 | 影響的模組或元件 |
+| subject | 是 | 簡短描述（祈使語氣）|
+| body | 否 | 詳細說明 |
+| footer | 否 | 參考連結、重大變更 |
+
+## Commit 類型
+
+| 類型 | 說明 | 範例 |
+|------|------|------|
+| `feat` | 新功能 | `feat: add user authentication` |
+| `fix` | 錯誤修復 | `fix: resolve login timeout issue` |
+| `docs` | 文件更新 | `docs: update API reference` |
+| `style` | 格式調整 | `style: fix indentation in utils` |
+| `refactor` | 程式碼重構 | `refactor: simplify validation logic` |
+| `perf` | 效能優化 | `perf: optimize database queries` |
+| `test` | 測試相關 | `test: add unit tests for auth module` |
+| `chore` | 維護作業 | `chore: update dependencies` |
+
+## 撰寫指南
+
+### 主題行
+
+1. **使用祈使語氣**：「Add feature」而非「Added feature」
+2. **冒號後不大寫**：「add feature」而非「Add feature」
+3. **結尾不加句號**：「add feature」而非「add feature.」
+4. **保持 50 字元以內**：簡潔扼要
+5. **具體明確**：「fix null pointer in user service」而非「fix bug」
+
+### 內文
+
+1. **每行 72 字元**：在終端機中保持可讀性
+2. **說明「什麼」和「為什麼」**：而非「如何」（程式碼會顯示如何）
+3. **使用項目符號**：多項變更時
+4. **與主題分隔**：使用空行
+
+## 範例
+
+### 簡單功能
+
+```
+feat(auth): add password strength indicator
+
+- Display strength bar during password input
+- Show requirements as user types
+- Prevent submission of weak passwords
+
+Closes #234
+```
+
+### 錯誤修復
+
+```
+fix(api): handle null response from payment gateway
+
+The payment gateway occasionally returns null instead of an error
+object when the service is degraded. This caused unhandled exceptions
+in the checkout flow.
+
+Added null check and appropriate error handling to gracefully
+handle this edge case.
+
+Fixes #567
+```
+
+### 重大變更
+
+```
+feat(api): change authentication to JWT tokens
+
+BREAKING CHANGE: Session-based authentication is removed.
+All API clients must now use JWT tokens for authentication.
+
+Migration guide:
+1. Obtain JWT token from /auth/token endpoint
+2. Include token in Authorization header
+3. Remove session cookie handling
+
+Closes #789
+```
+
+## 相關選項
+
+- [繁體中文](./traditional-chinese.md) - 繁體中文 Commit 訊息
+- [雙語](./bilingual.md) - 中英雙語格式
+
+---
+
+## 授權條款
+
+本文件採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權條款。
+
+**來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)