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

package/bundled/locales/zh-TW/skills/claude-code/commands/methodology.md

@@ -0,0 +1,274 @@
+---
+source: ../../../../../skills/claude-code/commands/methodology.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-12
+status: experimental
+---
+
+---
+description: 管理開發方法論工作流 | Manage development methodology workflow
+allowed-tools: Read, Write, Glob, Grep, Bash(git:*)
+argument-hint: [action] [argument]
+status: experimental
+---
+
+# /methodology 命令
+
+> **Language**: [English](../../../../../skills/claude-code/commands/methodology.md) | 繁體中文
+
+> [!WARNING]
+> **實驗性功能 / Experimental Feature**
+>
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+> This feature is under active development and may change significantly in v4.0.
+
+管理當前專案的開發方法論。支援 TDD、BDD、SDD、ATDD 和自訂方法論。
+
+---
+
+## 動作
+
+| 動作 | 說明 |
+|------|------|
+| *(無)* | 顯示當前方法論狀態 |
+| `status` | 顯示當前階段和檢查清單 |
+| `switch <id>` | 切換到不同方法論 |
+| `phase [name]` | 顯示或變更當前階段 |
+| `checklist` | 顯示當前階段檢查清單 |
+| `skip` | 跳過當前階段（會有警告） |
+| `list` | 列出可用方法論 |
+| `create` | 建立自訂方法論 |
+
+---
+
+## 使用方式
+
+### 顯示狀態
+
+```bash
+/methodology
+/methodology status
+```
+
+**輸出：**
+```
+┌────────────────────────────────────────────────┐
+│ 📋 啟用的方法論: TDD                            │
+│ 📍 當前階段: 🔴 紅燈 (1-5 分鐘)                 │
+│ ⏱️  持續時間: 3 分鐘                            │
+├────────────────────────────────────────────────┤
+│ 檢查清單：                                      │
+│   ✅ 測試描述預期行為                           │
+│   ✅ 測試名稱清晰                               │
+│   ⬜ 測試遵循 AAA 模式                          │
+│   ⬜ 測試執行失敗                               │
+├────────────────────────────────────────────────┤
+│ 下一步：完成檢查清單，然後執行測試              │
+└────────────────────────────────────────────────┘
+```
+
+### 切換方法論
+
+```bash
+/methodology switch sdd
+/methodology switch bdd
+/methodology switch my-custom-workflow
+```
+
+**輸出：**
+```
+切換方法論：TDD → SDD
+
+⚠️ 警告：您有未提交的變更。
+   當前階段：綠燈
+   變更的檔案：3
+
+選項：
+[1] 先提交變更，然後切換
+[2] 暫存變更並切換
+[3] 直接切換（保留變更）
+[4] 取消
+
+> 1
+
+正在提交變更...
+已切換到：SDD（規格驅動開發）
+當前階段：提案
+```
+
+### 變更階段
+
+```bash
+/methodology phase              # 顯示當前階段
+/methodology phase green        # 移動到綠燈階段 (TDD)
+/methodology phase refactor     # 移動到重構階段
+```
+
+### 顯示檢查清單
+
+```bash
+/methodology checklist
+```
+
+**輸出：**
+```
+📋 紅燈階段檢查清單 (TDD)
+
+必填：
+  ⬜ 測試描述預期行為
+  ✅ 測試名稱清楚說明測試內容
+  ⬜ 測試遵循 AAA 模式（Arrange-Act-Assert）
+  ⬜ 測試執行時失敗
+  ⬜ 失敗是正確的原因
+
+選填：
+  ⬜ 測試只有一個斷言
+
+進度：1/5 必填項目完成
+```
+
+### 跳過階段
+
+```bash
+/methodology skip
+```
+
+**輸出：**
+```
+⚠️ 跳過階段警告
+
+您即將跳過紅燈階段，尚未完成：
+  ⬜ 測試遵循 AAA 模式
+  ⬜ 測試執行時失敗
+
+這是警告前的第 2 次跳過（共 3 次）。
+
+確定要跳過嗎？
+[1] 是，跳過此階段
+[2] 否，繼續完成檢查清單
+```
+
+### 列出方法論
+
+```bash
+/methodology list
+```
+
+**輸出：**
+```
+📚 可用的方法論
+
+內建：
+  ├─ tdd    測試驅動開發（紅燈 → 綠燈 → 重構）
+  ├─ bdd    行為驅動開發（Given-When-Then）
+  ├─ sdd    規格驅動開發（規格優先、程式碼其次）
+  └─ atdd   驗收測試驅動開發
+
+自訂（.standards/methodologies/）：
+  └─ my-team-workflow   我們團隊的開發流程
+
+啟用中：tdd ✓
+
+使用 '/methodology switch <id>' 來變更。
+```
+
+### 建立自訂
+
+```bash
+/methodology create
+```
+
+啟動互動式方法論建立精靈。詳見[建立自訂方法論](../methodology-system/create-methodology.md)。
+
+---
+
+## 配置
+
+方法論設定儲存在 `.standards/manifest.json`：
+
+```json
+{
+  "methodology": {
+    "active": "tdd",
+    "available": ["tdd", "bdd", "sdd", "atdd", "my-team-workflow"],
+    "config": {
+      "tdd": {
+        "checkpointsEnabled": true,
+        "reminderIntensity": "suggest",
+        "skipLimit": 3
+      }
+    }
+  }
+}
+```
+
+### 透過 /config 配置
+
+您也可以使用以下命令配置方法論設定：
+
+```bash
+/config methodology
+```
+
+---
+
+## 範例
+
+### 為功能啟動 TDD
+
+```bash
+# 啟用 TDD 方法論
+/methodology switch tdd
+
+# 或直接使用 TDD 命令（自動啟用 TDD）
+/tdd "驗證用戶郵箱格式"
+```
+
+### 開發過程中檢查進度
+
+```bash
+# 檢查當前狀態
+/methodology status
+
+# 檢視檢查清單
+/methodology checklist
+
+# 如果準備好了，移動到下一個階段
+/methodology phase green
+```
+
+### 為重大變更切換到 SDD
+
+```bash
+# 切換到規格驅動以進行架構變更
+/methodology switch sdd
+
+# 這會啟動 提案 → 審查 → 實作 流程
+```
+
+---
+
+## 相關命令
+
+| 命令 | 說明 |
+|------|------|
+| `/tdd` | 啟動 TDD 工作流（啟用 TDD 方法論） |
+| `/spec` | 啟動 SDD 工作流（啟用 SDD 方法論） |
+| `/config methodology` | 配置方法論設定 |
+
+---
+
+## 參考
+
+- [方法論系統 Skill](../methodology-system/SKILL.md) - 完整 skill 文檔
+- [執行時引導](../methodology-system/runtime.md) - AI 行為規格
+- [建立自訂方法論](../methodology-system/create-methodology.md) - 自訂方法論指南
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-12 | 初始 /methodology 命令 |

package/bundled/locales/zh-TW/skills/claude-code/commit-standards/SKILL.md

@@ -0,0 +1,191 @@
+---
+source: skills/claude-code/commit-standards/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+name: commit-standards
+description: |
+  遵循約定式提交標準格式化提交訊息。
+  使用時機：撰寫提交訊息、git commit、檢視提交歷史。
+  關鍵字：commit、git、message、conventional、feat、fix、refactor。
+---
+
+# 提交訊息標準
+
+> **語言**: [English](../../../../../skills/claude-code/commit-standards/SKILL.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+此技能確保遵循約定式提交標準，撰寫一致且有意義的提交訊息。
+
+## 快速參考
+
+### 基本格式
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+### 提交類型
+
+| English | 使用時機 |
+|---------|----------|
+| `feat` | 新功能 |
+| `fix` | 錯誤修正 |
+| `refactor` | 程式碼重構（無功能變更） |
+| `docs` | 僅文件變更 |
+| `style` | 格式調整（無程式碼邏輯變更） |
+| `test` | 新增或更新測試 |
+| `perf` | 效能改善 |
+| `build` | 建置系統或依賴項目 |
+| `ci` | CI/CD 流程變更 |
+| `chore` | 維護任務 |
+| `revert` | 還原先前的提交 |
+| `security` | 安全漏洞修正 |
+
+### 主旨行規則
+
+1. **長度**: ≤72 字元（50 為理想）
+2. **時態**: 祈使語氣（使用 "Add feature" 而非 "Added feature"）
+3. **大小寫**: 首字母大寫
+4. **無句點**: 結尾不加句點
+
+## 詳細指南
+
+完整標準請參考：
+- [約定式提交指南](./conventional-commits.md)
+- [語言選項](./language-options.md)
+
+## 範例
+
+### ✅ 良好範例
+
+```
+feat(auth): Add OAuth2 Google login support
+fix(api): Resolve memory leak in user session cache
+refactor(database): Extract query builder to separate class
+docs(readme): Update installation instructions for Node 20
+```
+
+### ❌ 不良範例
+
+```
+fixed bug                    # 太模糊，無範圍
+feat(auth): added google login  # 過去式
+Update stuff.                # 有句點，模糊
+WIP                          # 不具描述性
+```
+
+## 主體內容指南
+
+使用主體內容說明變更的**原因（WHY）**：
+
+```
+fix(api): Resolve race condition in concurrent user updates
+
+Why this occurred:
+- Two simultaneous PUT requests could overwrite each other
+- No optimistic locking implemented
+
+What this fix does:
+- Add version field to User model
+- Return 409 Conflict if version mismatch
+
+Fixes #789
+```
+
+## 破壞性變更
+
+務必在頁腳記錄破壞性變更：
+
+```
+feat(api): Change user endpoint response format
+
+BREAKING CHANGE: User API response format changed
+
+Migration guide:
+1. Update API clients to remove .data wrapper
+2. Use created_at instead of createdAt
+```
+
+## 議題參照
+
+```
+Closes #123    # 自動關閉議題
+Fixes #456     # 自動關閉議題
+Refs #789      # 連結但不關閉
+```
+
+---
+
+## 配置檢測
+
+此技能支援專案特定的語言配置。
+
+### 檢測順序
+
+1. 檢查 `CONTRIBUTING.md` 中的「Commit Message Language」區段
+2. 若找到，使用指定的選項（English / Traditional Chinese / Bilingual）
+3. 若未找到，**預設使用 English** 以獲得最大工具相容性
+
+### 首次設定
+
+若未找到配置且情境不明確：
+
+1. 詢問使用者：「此專案尚未配置提交訊息語言偏好。您想使用哪個選項？（English / 中文 / Bilingual）」
+2. 使用者選擇後，建議記錄於 `CONTRIBUTING.md`：
+
+```markdown
+## Commit Message Language
+
+This project uses **[chosen option]** commit types.
+<!-- Options: English | Traditional Chinese | Bilingual -->
+```
+
+### 配置範例
+
+在專案的 `CONTRIBUTING.md` 中：
+
+```markdown
+## Commit Message Language
+
+This project uses **English** commit types.
+
+### Allowed Types
+feat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security
+```
+
+---
+
+## 相關標準
+
+- [提交訊息指南](../../../../../core/commit-message-guide.md)
+- [Git 工作流程](../../../../../core/git-workflow.md)
+- [變更日誌標準](../../../../../core/changelog-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)

package/bundled/locales/zh-TW/skills/claude-code/commit-standards/conventional-commits.md

@@ -0,0 +1,264 @@
+---
+source: /skills/claude-code/commit-standards/conventional-commits.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# Conventional Commits 指南
+
+> **語言**: [English](../../../../../skills/claude-code/commit-standards/conventional-commits.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供撰寫 conventional commit 訊息的詳細指南。
+
+---
+
+## 格式結構
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+### 組成元素
+
+| 元素 | 必填 | 說明 |
+|-----------|----------|-------------|
+| `type` | ✅ 是 | 變更類型 |
+| `scope` | 選填 | 受影響的模組/元件 |
+| `subject` | ✅ 是 | 簡短描述（≤72 字元） |
+| `body` | 建議填寫 | 詳細說明 |
+| `footer` | 選填 | 議題引用、破壞性變更 |
+
+---
+
+## Commit 類型
+
+### 主要類型
+
+| 類型 | 使用時機 | 範例 |
+|------|-------------|----------|
+| `feat` | 為使用者新增功能 | `feat(cart): Add quantity selector` |
+| `fix` | 為使用者修復錯誤 | `fix(login): Resolve password reset loop` |
+| `docs` | 僅文件變更 | `docs(api): Add authentication examples` |
+| `refactor` | 程式碼變更但不涉及功能/修復 | `refactor(utils): Simplify date formatting` |
+
+### 次要類型
+
+| 類型 | 使用時機 | 範例 |
+|------|-------------|----------|
+| `style` | 格式化、空白字元 | `style: Apply prettier formatting` |
+| `test` | 新增/更新測試 | `test(auth): Add login integration tests` |
+| `perf` | 效能改進 | `perf(query): Add database index` |
+| `build` | 建置系統、依賴套件 | `build(deps): Upgrade React to v18` |
+| `ci` | CI/CD 流程 | `ci: Add deploy workflow` |
+| `chore` | 維護任務 | `chore: Update .gitignore` |
+| `revert` | 回復提交 | `revert: Revert "feat(auth): Add SSO"` |
+| `security` | 安全性修復 | `security(auth): Fix XSS vulnerability` |
+
+---
+
+## Scope 指南
+
+### 命名規則
+
+1. **使用小寫**: `auth`，而非 `Auth`
+2. **多個單字使用連字號**: `user-profile`，而非 `userProfile`
+3. **保持簡短**: 最多 1-2 個單字
+
+### 常見 Scopes
+
+**依層級**:
+- `api`, `ui`, `database`, `config`, `middleware`
+
+**依功能**:
+- `auth`, `login`, `payment`, `notification`, `search`
+
+**依檔案類型**:
+- `tests`, `docs`, `build`, `deps`
+
+**特殊**:
+- `*`: 影響多個範圍
+- (無 scope): 全域變更
+
+---
+
+## Subject 行規則
+
+1. **長度**: ≤72 字元（理想為 50）
+2. **時態**: 祈使語氣
+   - ✅ "Add feature"
+   - ❌ "Added feature"
+3. **大小寫**: 首字母大寫
+4. **無句號**: 結尾不加句號
+5. **具體明確**: 描述變更內容
+
+### 範例
+
+```
+✅ feat(auth): Add OAuth2 Google login support
+✅ fix(api): Resolve memory leak in session cache
+✅ refactor(database): Extract query builder class
+
+❌ fixed bug                    # 模糊、過去式
+❌ feat(auth): added login.     # 過去式、有句號
+❌ Update stuff                 # 太模糊
+```
+
+---
+
+## Body 指南
+
+說明**為什麼**，而非**做什麼**（程式碼已經展示做什麼）。
+
+### 範本
+
+**功能類**:
+```
+Why this feature is needed:
+- Reason 1
+- Reason 2
+
+What this implements:
+- Implementation detail 1
+- Implementation detail 2
+```
+
+**錯誤修復類**:
+```
+Why this occurred:
+- Root cause explanation
+
+What this fix does:
+- Solution description
+
+Testing:
+- How it was tested
+```
+
+**重構類**:
+```
+Why this refactoring:
+- Motivation
+
+What this changes:
+- Changes description
+
+Migration:
+- Migration steps if needed
+```
+
+---
+
+## Footer 指南
+
+### 議題引用
+
+```
+Closes #123     # 自動關閉議題
+Fixes #456      # 自動關閉議題
+Resolves #789   # 自動關閉議題
+Refs #101       # 連結但不關閉
+See also #999   # 相關引用
+```
+
+### 破壞性變更
+
+```
+BREAKING CHANGE: <description>
+
+Migration guide:
+- Step 1
+- Step 2
+```
+
+---
+
+## 完整範例
+
+```
+feat(export): Add CSV export functionality for user data
+
+Why this feature is needed:
+- Admins need to export user lists for compliance audits
+- Manual copy-paste from UI is error-prone
+- Requested by legal and compliance teams
+
+What this implements:
+- New /api/users/export endpoint
+- CSV generation using csv-writer library
+- Streaming response for large datasets
+- Date range filtering options
+
+Technical notes:
+- Streaming prevents memory issues with 100k+ users
+- Export limited to admin role only
+- Rate limited to prevent abuse
+
+Closes #567
+Refs #234 (related compliance requirement)
+```
+
+---
+
+## 反模式
+
+### ❌ 模糊訊息
+
+```
+fix: bug fix
+refactor: code improvements
+update: changes
+```
+
+### ❌ 混合多個關注點
+
+```
+feat: add login, fix bugs, refactor database
+```
+
+**修正**: 拆分成個別提交。
+
+### ❌ Subject 中包含實作細節
+
+```
+fix: change line 45 from getUserById to getUserByEmail
+```
+
+**修正**: 著重於目的，而非實作。
+
+---
+
+## 相關標準
+
+- [Commit Message Guide](../../../../../core/commit-message-guide.md)
+- [Language Options](./language-options.md)
+- [Git Workflow](../../../../../core/git-workflow.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)