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

package/bundled/locales/zh-CN/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-CN/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-CN/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)