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

package/bundled/locales/zh-TW/skills/claude-code/code-review-assistant/checkin-checklist.md

@@ -0,0 +1,257 @@
+---
+source: /skills/claude-code/code-review-assistant/checkin-checklist.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# Pre-Commit Checklist（提交前檢查清單）
+
+> **語言**: [English](../../../../../skills/claude-code/code-review-assistant/checkin-checklist.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供開發者在提交程式碼變更前需要驗證的檢查清單。
+
+---
+
+## 必要檢查
+
+### 1. 建置驗證
+
+- [ ] **程式碼編譯成功**
+  - 零建置錯誤
+  - 零建置警告（或已記錄的例外情況）
+
+- [ ] **依賴套件已滿足**
+  - 所有套件依賴已安裝
+  - 依賴版本已鎖定
+  - 無缺少的 imports
+
+---
+
+### 2. 測試驗證
+
+- [ ] **所有現有測試通過**
+  - 單元測試：100% 通過率
+  - 整合測試：100% 通過率
+
+- [ ] **新程式碼已測試**
+  - 新功能有對應的測試
+  - Bug 修復包含回歸測試
+
+- [ ] **測試覆蓋率已維持**
+  - 覆蓋率百分比未降低
+  - 關鍵路徑已測試
+
+---
+
+### 3. 程式碼品質
+
+- [ ] **遵循編碼標準**
+  - 遵守命名慣例
+  - 程式碼格式一致
+  - 需要時有註解
+
+- [ ] **無程式碼異味**
+  - 方法 ≤50 行
+  - 巢狀深度 ≤3 層
+  - 循環複雜度 ≤10
+  - 無重複程式碼區塊
+
+- [ ] **安全性已檢查**
+  - 無硬編碼的密鑰
+  - 無 SQL 注入漏洞
+  - 無 XSS 漏洞
+  - 無不安全的依賴套件
+
+---
+
+### 4. 文件
+
+- [ ] **API 文件已更新**
+  - 公開 API 有文件註解
+  - 參數已說明
+  - 回傳值已記錄
+
+- [ ] **README 已更新（如需要）**
+  - 新功能已記錄
+  - 重大變更已註記
+
+- [ ] **CHANGELOG 已更新（如適用）**
+  - 面向使用者的變更已加入 `[Unreleased]`
+  - 重大變更已標記
+
+---
+
+### 5. 工作流程合規性
+
+- [ ] **分支命名正確**
+  - 遵循專案慣例（`feature/`、`fix/`）
+
+- [ ] **提交訊息已格式化**
+  - 遵循 conventional commits 或專案標準
+
+- [ ] **與目標分支同步**
+  - 已合併目標分支的最新變更
+  - 無合併衝突
+
+---
+
+## 提交時機指南
+
+### ✅ 適當的提交時機
+
+1. **完成的功能單元**
+   - 功能完全實作
+   - 測試已撰寫並通過
+   - 文件已更新
+
+2. **特定 Bug 已修復**
+   - Bug 已重現並修復
+   - 已加入回歸測試
+
+3. **獨立的重構**
+   - 重構完成
+   - 無功能變更
+   - 所有測試仍通過
+
+4. **可執行狀態**
+   - 程式碼編譯無錯誤
+   - 應用程式可執行/啟動
+   - 核心功能未損壞
+
+### ❌ 不適當的提交時機
+
+1. **建置失敗**
+   - 存在編譯錯誤
+   - 未解決的依賴問題
+
+2. **測試失敗**
+   - 一個或多個測試失敗
+   - 新程式碼尚未撰寫測試
+
+3. **未完成的功能**
+   - 功能部分實作
+   - 會破壞現有功能
+
+4. **實驗性程式碼**
+   - 散佈 TODO 註解
+   - 遺留除錯程式碼
+   - 註解掉的程式碼區塊
+
+---
+
+## 提交粒度
+
+### 理想的提交大小
+
+| 指標 | 建議 |
+|--------|-------------|
+| 檔案數量 | 1-10 個檔案 |
+| 變更行數 | 50-300 行 |
+| 範圍 | 單一關注點 |
+
+### 拆分原則
+
+**合併為一個提交**：
+- 功能實作 + 對應的測試
+- 緊密相關的多檔案變更
+
+**分開提交**：
+- 功能 A + 功能 B → 分開
+- 重構 + 新功能 → 分開
+- Bug 修復 + 附帶重構 → 分開
+
+---
+
+## 特殊情境
+
+### 緊急離開（WIP）
+
+**選項 1：Git Stash（推薦）**
+```bash
+git stash save "WIP: description of incomplete work"
+# Resume later
+git stash pop
+```
+
+**選項 2：WIP 分支**
+```bash
+git checkout -b wip/feature-temp
+git commit -m "WIP: progress save (do not merge)"
+```
+
+### Hotfix
+
+1. 從 main 建立 hotfix 分支
+2. 最小化變更（僅修復問題）
+3. 快速驗證（確保測試通過）
+4. 在提交訊息中標記緊急性：
+   ```
+   fix(module): [URGENT] fix critical issue
+   ```
+
+---
+
+## 常見違規
+
+### ❌ "WIP" 提交
+
+```
+git commit -m "WIP"
+git commit -m "save work"
+git commit -m "trying stuff"
+```
+
+**解決方案**：使用 `git stash` 或在合併前 squash
+
+### ❌ 註解掉的程式碼
+
+**問題**：使程式碼庫雜亂，混淆未來的開發者
+
+**解決方案**：刪除它。Git 歷史會保留舊程式碼。
+
+### ❌ 混合關注點
+
+```
+git commit -m "fix bug and refactor and add feature"
+```
+
+**解決方案**：分開為多個提交：
+```
+git commit -m "fix(module-a): resolve null pointer error"
+git commit -m "refactor(module-b): extract validation logic"
+git commit -m "feat(module-c): add export feature"
+```
+
+---
+
+## 相關標準
+
+- [Checkin Standards](../../../../../core/checkin-standards.md)
+- [Code Review Checklist](./review-checklist.md)
+- [Commit Message Guide](../../../../../core/commit-message-guide.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/code-review-assistant/review-checklist.md

@@ -0,0 +1,246 @@
+---
+source: skills/claude-code/code-review-assistant/review-checklist.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 程式碼審查檢查清單
+
+> **語言**: [English](../../../../../skills/claude-code/code-review-assistant/review-checklist.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供全面的程式碼審查檢查清單，以確保程式碼品質和標準合規性。
+
+---
+
+## 1. 功能性
+
+- [ ] **程式碼執行預期功能**
+  - 已驗證需求/規格對齊
+  - 滿足驗收標準
+  - 處理邊界情況
+
+- [ ] **無明顯錯誤**
+  - 存在 null/undefined 檢查
+  - 檢查陣列邊界
+  - 處理錯誤條件
+
+- [ ] **邏輯正確**
+  - 條件合理
+  - 迴圈正確終止
+  - 計算準確
+
+---
+
+## 2. 設計與架構
+
+- [ ] **遵循專案架構**
+  - 尊重分層
+  - 維持關注點分離
+  - 依賴方向正確
+
+- [ ] **使用適當的設計模式**
+  - 無過度設計
+  - 無設計不足
+  - 正確應用模式
+
+- [ ] **程式碼放置在正確位置**
+  - 檔案邏輯組織
+  - 相關程式碼集中放置
+
+---
+
+## 3. 程式碼品質
+
+- [ ] **遵循編碼標準**
+  - 遵守命名慣例
+  - 格式一致
+  - 遵循樣式指南
+
+- [ ] **無程式碼異味**
+  - 方法 ≤50 行
+  - 類別具有單一職責
+  - 圈複雜度 ≤10
+  - 無深層巢狀條件（≤3 層）
+
+- [ ] **應用 DRY 原則**
+  - 無重複程式碼區塊
+  - 提取共用邏輯
+
+---
+
+## 4. 可讀性
+
+- [ ] **程式碼易於理解**
+  - 變數名稱具描述性
+  - 函式名稱揭示意圖
+  - 邏輯自然流暢
+
+- [ ] **註解有幫助**
+  - 解釋複雜邏輯
+  - 記錄為什麼（WHY），而非什麼（WHAT）
+  - 無被註解掉的程式碼
+
+---
+
+## 5. 測試
+
+- [ ] **存在測試**
+  - 新程式碼有測試
+  - 測試涵蓋正常路徑
+  - 測試涵蓋錯誤情況
+  - 測試邊界情況
+
+- [ ] **測試品質良好**
+  - 測試可讀
+  - 測試名稱描述場景
+  - 斷言清晰
+  - 無不穩定測試
+
+- [ ] **維持測試覆蓋率**
+  - 覆蓋率未降低
+  - 涵蓋關鍵路徑
+
+---
+
+## 6. 安全性
+
+- [ ] **無安全漏洞**
+  - 無 SQL 注入風險
+  - 無 XSS 漏洞
+  - 無硬編碼密鑰
+  - 無不安全的依賴
+
+- [ ] **存在輸入驗證**
+  - 清理使用者輸入
+  - 執行型別檢查
+  - 強制執行大小限制
+
+- [ ] **身份驗證/授權正確**
+  - 適當的身份驗證檢查
+  - 強制執行基於角色的存取
+  - 保護敏感資料
+
+---
+
+## 7. 效能
+
+- [ ] **無明顯效能問題**
+  - 無 N+1 查詢
+  - 無不必要的迴圈
+  - 熱路徑中無阻塞操作
+
+- [ ] **使用高效演算法**
+  - 考慮複雜度
+  - 適當的資料結構
+  - 有益處時使用快取
+
+- [ ] **資源管理適當**
+  - 關閉連線
+  - 防止記憶體洩漏
+  - 釋放檔案控制代碼
+
+---
+
+## 8. 錯誤處理
+
+- [ ] **適當處理錯誤**
+  - 存在 try-catch 區塊
+  - 捕獲特定例外
+  - 避免通用捕獲
+
+- [ ] **錯誤訊息有幫助**
+  - 訊息具描述性
+  - 包含可操作資訊
+  - 無暴露敏感資料
+
+- [ ] **日誌記錄充分**
+  - 記錄錯誤與上下文
+  - 日誌層級適當
+  - 無過度日誌記錄
+
+---
+
+## 9. 文件
+
+- [ ] **存在 API 文件**
+  - 記錄公開方法
+  - 解釋參數
+  - 描述回傳值
+  - 記錄例外
+
+- [ ] **如需要則更新 README**
+  - 記錄新功能
+  - 更新安裝說明
+
+- [ ] **更新 CHANGELOG（如適用）**
+  - 將面向使用者的變更加入 `[Unreleased]`
+  - 以 **BREAKING** 標記破壞性變更
+
+---
+
+## 10. 依賴
+
+- [ ] **依賴有正當理由**
+  - 新依賴必要
+  - 授權相容
+  - 無安全漏洞
+  - 積極維護
+
+- [ ] **依賴版本已鎖定**
+  - 指定確切版本
+  - 更新鎖定檔案
+
+---
+
+## 快速參考卡
+
+```
+┌─────────────────────────────────────────┐
+│ Code Review Quick Checklist            │
+├─────────────────────────────────────────┤
+│ ✓ Functionality - Does it work?        │
+│ ✓ Design - Right architecture?         │
+│ ✓ Quality - Clean code?                │
+│ ✓ Readability - Easy to understand?    │
+│ ✓ Tests - Adequate coverage?           │
+│ ✓ Security - No vulnerabilities?       │
+│ ✓ Performance - Efficient?             │
+│ ✓ Errors - Properly handled?           │
+│ ✓ Docs - Updated?                      │
+│ ✓ Dependencies - Necessary?            │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 相關標準
+
+- [Code Review Checklist](../../../../../core/code-review-checklist.md)
+- [Checkin Standards](../../../../../core/checkin-standards.md)
+- [Pre-Commit Checklist](./checkin-checklist.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/commands/bdd.md

@@ -0,0 +1,142 @@
+---
+source: ../../../../../skills/claude-code/commands/bdd.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-12
+status: experimental
+---
+
+---
+description: 引導行為驅動開發流程 | Guide through Behavior-Driven Development workflow
+allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
+argument-hint: [要實作的行為或場景 | behavior or scenario to implement]
+status: experimental
+---
+
+# BDD 助手
+
+> [!WARNING]
+> **實驗性功能 / Experimental Feature**
+>
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+> This feature is under active development and may change significantly in v4.0.
+
+引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式。
+
+## 方法論整合
+
+當調用 `/bdd` 時：
+1. **自動啟用 BDD 方法論**（如果尚未啟用）
+2. **將當前階段設為探索**（探索行為）
+3. **追蹤階段轉換**隨著工作進展
+4. **在回應中顯示階段指示器**（🔍 探索、📝 制定、🤖 自動化、📚 活文件）
+
+詳見 [methodology-system](../methodology-system/SKILL.md) 了解完整方法論追蹤。
+
+## BDD 循環
+
+```
+┌───────────────────────────────────────────────────────┐
+│                                                       │
+│  ┌────┐   ┌────┐   ┌──────┐   ┌──────┐               │
+│  │探索│ ► │制定│ ► │自動化│ ► │活文件│               │
+│  └────┘   └────┘   └──────┘   └──────┘               │
+│    ▲                              │                   │
+│    └──────────────────────────────┘                   │
+│                                                       │
+└───────────────────────────────────────────────────────┘
+```
+
+## 工作流程
+
+### 1. 探索 - 探索行為
+- 與利害關係人討論
+- 識別範例和邊界情況
+- 理解功能背後的「為什麼」
+
+### 2. 制定 - 撰寫場景
+- 撰寫 Gherkin 場景（Given-When-Then）
+- 使用通用語言
+- 讓場景具體且明確
+
+### 3. 自動化 - 實作測試
+- 實作步驟定義
+- 撰寫最小程式碼以通過
+- 在自動化中遵循 TDD 循環
+
+### 4. 活文件 - 維護
+- 保持場景最新
+- 作為文件使用
+- 與利害關係人分享
+
+## Gherkin 格式
+
+```gherkin
+功能: 用戶登入
+  作為一個註冊用戶
+  我想要登入我的帳戶
+  以便我可以訪問我的個人儀表板
+
+  場景: 使用有效憑證成功登入
+    假設 我在登入頁面
+    而且 我有一個註冊帳戶，郵箱為 "user@example.com"
+    當 我輸入郵箱 "user@example.com"
+    而且 我輸入密碼 "correctpassword"
+    而且 我點擊登入按鈕
+    那麼 我應該被重定向到我的儀表板
+    而且 我應該看到歡迎訊息
+
+  場景: 使用無效密碼登入失敗
+    假設 我在登入頁面
+    當 我輸入郵箱 "user@example.com"
+    而且 我輸入密碼 "wrongpassword"
+    而且 我點擊登入按鈕
+    那麼 我應該看到錯誤訊息 "無效的憑證"
+    而且 我應該留在登入頁面
+```
+
+## 三劍客會議
+
+BDD 最適合協作：
+
+| 角色 | 關注點 |
+|------|--------|
+| 業務 | 什麼和為什麼 |
+| 開發 | 如何實現 |
+| 測試 | 假設情況 |
+
+## 使用方式
+
+- `/bdd` - 啟動互動式 BDD 會話
+- `/bdd "用戶可以重設密碼"` - 針對特定功能的 BDD
+- `/bdd login-feature.feature` - 使用現有功能檔案
+
+## 階段檢查清單
+
+### 探索階段
+- [ ] 已識別利害關係人
+- [ ] 已討論用戶故事
+- [ ] 已收集範例
+- [ ] 已識別邊界情況
+
+### 制定階段
+- [ ] 場景遵循 Given-When-Then
+- [ ] 語言是通用的（共享詞彙）
+- [ ] 場景具體且明確
+- [ ] 場景中無實作細節
+
+### 自動化階段
+- [ ] 已實作步驟定義
+- [ ] 測試可執行
+- [ ] 程式碼通過所有場景
+- [ ] 重構完成
+
+### 活文件階段
+- [ ] 場景是最新的
+- [ ] 文件可訪問
+- [ ] 利害關係人可閱讀和理解
+
+## 參考
+
+- 方法論: [bdd.methodology.yaml](../../../../../methodologies/bdd.methodology.yaml)
+- 方法論系統: [methodology-system](../methodology-system/SKILL.md)