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

package/bundled/locales/zh-CN/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-CN/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 / 简体中文 / Bilingual）
+3. 若未找到，**预设使用 English** 以獲得最大工具相容性
+
+### 首次设置
+
+若未找到配置且情境不明确：
+
+1. 詢問使用者：「此项目尚未配置提交消息语言偏好。您想使用哪个选项？（English / 中文 / Bilingual）」
+2. 使用者选择後，建议记录於 `CONTRIBUTING.md`：
+
+```markdown
+## Commit Message Language
+
+This project uses **[chosen option]** commit types.
+<!-- Options: English | 简体中文 | 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-CN/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)