universal-dev-standards 3.5.1-beta.16 → 3.5.1-beta.17

package/bin/uds.js

@@ -57,12 +57,14 @@ program
   .description('Modify options for initialized project')
   .option('-t, --type <type>', 'Option type to configure (format, workflow, merge_strategy, commit_language, test_levels, skills, commands, all)')
   .option('--ai-tool <tool>', 'Specific AI tool to configure (claude-code, opencode, copilot, etc.) - enables non-interactive mode')
+  .option('-y, --yes', 'Apply changes immediately without prompting')
   .option('-E, --experimental', 'Enable experimental features (methodology)')
   .action(configureCommand);
 
 program
   .command('check')
   .description('Check adoption status of current project')
+  .option('--summary', 'Show compact status summary (for use by other commands)')
   .option('--diff', 'Show diff for modified files')
   .option('--restore', 'Restore all modified and missing files')
   .option('--restore-missing', 'Restore only missing files')

package/bundled/core/checkin-standards.md

@@ -2,8 +2,8 @@
 
 > **Language**: English | [繁體中文](../locales/zh-TW/core/checkin-standards.md)
 
-**Version**: 1.3.0
-**Last Updated**: 2026-01-05
+**Version**: 1.4.0
+**Last Updated**: 2026-01-16
 **Applicability**: All software projects using version control
 
 ---
@@ -90,6 +90,42 @@ pytest --cov=src tests/
 - Review test coverage report
 - Ensure new code paths are tested
 
+#### Bug Fix Testing Evaluation
+
+When fixing bugs, evaluate whether to add regression tests:
+
+**✅ MUST Add Tests (High Value)**:
+| Condition | Reason |
+|-----------|--------|
+| Security-related bugs | Prevent recurrence of vulnerabilities |
+| Data integrity bugs | Protect critical business data |
+| Bugs that caused outages | Ensure system stability |
+| Bugs that recurred | Break the cycle of repeated issues |
+| Complex business logic bugs | Document expected behavior |
+
+**⚠️ OPTIONAL Tests (Lower Value)**:
+| Condition | Reason |
+|-----------|--------|
+| Simple typos | Low recurrence risk |
+| Obvious logic errors (e.g., `>` vs `<`) | Easy to spot in review |
+| Already covered by existing tests | Avoid redundant tests |
+| One-time configuration errors | Won't recur in code |
+
+**Quick Decision Questions**:
+1. Could this bug recur from future code changes? → YES = Add test
+2. Would existing tests have caught this bug? → NO = Add test
+3. Is this a critical path or core functionality? → YES = Add test
+4. Did this bug occur before? → YES = Add test
+
+**Regression Test Naming**:
+```javascript
+describe('Regression: [BUG-ID or description]', () => {
+  it('should [correct behavior] when [trigger condition]', () => {
+    // Test that would have caught the bug
+  });
+});
+```
+
 ---
 
 ### 3. Code Quality
@@ -901,6 +937,7 @@ git commit -m "feat(module-c): add export to CSV feature"
 
 | Version | Date | Changes |
 |---------|------|---------|
+| 1.4.0 | 2026-01-16 | Added: Bug Fix Testing Evaluation section with decision matrix |
 | 1.3.0 | 2026-01-05 | Added: SWEBOK v4.0 Chapter 6 (Software Configuration Management) to References |
 | 1.2.5 | 2025-12-16 | Clarified: CHANGELOG update is for user-facing changes only, added to [Unreleased] section |
 | 1.2.4 | 2025-12-11 | Added: Pre-commit directory hygiene section (IDE artifacts, verification commands) |

package/bundled/locales/zh-CN/core/checkin-standards.md

@@ -1,8 +1,8 @@
 ---
 source: core/checkin-standards.md
-source_version: 1.3.0
-translation_version: 1.3.0
-last_synced: 2026-01-05
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-01-16
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **语言**: [English](../../../core/checkin-standards.md) | 繁体中文
 
-**版本**: 1.3.0
-**最后更新**: 2026-01-05
+**版本**: 1.4.0
+**最后更新**: 2026-01-16
 **适用范围**: 所有使用版本控制的软体专案
 
 ---
@@ -98,6 +98,42 @@ pytest --cov=src tests/
 - Review test coverage report
 - Ensure new code paths are tested
 
+#### Bug 修复测试评估
+
+修复 bug 时，评估是否需要新增回归测试：
+
+**✅ 必须加测试（高价值）**：
+| 情况 | 原因 |
+|------|------|
+| 安全相关的 bug | 防止漏洞再次发生 |
+| 数据完整性相关的 bug | 保护关键业务数据 |
+| 造成服务中断的 bug | 确保系统稳定性 |
+| 曾经重复出现的 bug | 打破重复出现的循环 |
+| 复杂业务逻辑的 bug | 记录预期行为 |
+
+**⚠️ 测试为可选（低价值）**：
+| 情况 | 原因 |
+|------|------|
+| 单纯的 typo 修正 | 再发风险低 |
+| 显而易见的逻辑错误（如 `>` 写成 `<`） | 审查时容易发现 |
+| 已被现有测试覆盖 | 避免重复测试 |
+| 一次性的配置错误 | 不会在程序码中再发生 |
+
+**快速决策问题**：
+1. 这个 bug 是否可能因未来的程序码变更而重现？ → 是 = 加测试
+2. 现有的测试是否能捕捉到这个 bug？ → 否 = 加测试
+3. 这是否影响核心功能或关键路径？ → 是 = 加测试
+4. 这个 bug 曾经出现过吗？ → 是 = 加测试
+
+**回归测试命名**：
+```javascript
+describe('Regression: [BUG-ID or description]', () => {
+  it('should [correct behavior] when [trigger condition]', () => {
+    // Test that would have caught the bug
+  });
+});
+```
+
 ---
 
 ### 3. 程序码品质
@@ -909,6 +945,7 @@ git commit -m "feat(module-c): add export to CSV feature"
 
 | 版本 | 日期 | 变更 |
 |---------|------|---------|
+| 1.4.0 | 2026-01-16 | 新增：Bug 修复测试评估章节与决策矩阵 |
 | 1.3.0 | 2026-01-05 | 新增：SWEBOK v4.0 第 6 章（软体配置管理）至参考资料 |
 | 1.2.5 | 2025-12-16 | Clarified: CHANGELOG update is for user-facing changes only, added to [Unreleased] section |
 | 1.2.4 | 2025-12-11 | Added: Pre-commit directory hygiene section (IDE artifacts, verification commands) |

package/bundled/locales/zh-TW/core/checkin-standards.md

@@ -1,8 +1,8 @@
 ---
 source: core/checkin-standards.md
-source_version: 1.3.0
-translation_version: 1.3.0
-last_synced: 2026-01-05
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-01-16
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **語言**: [English](../../../core/checkin-standards.md) | 繁體中文
 
-**版本**: 1.3.0
-**最後更新**: 2026-01-05
+**版本**: 1.4.0
+**最後更新**: 2026-01-16
 **適用範圍**: 所有使用版本控制的軟體專案
 
 ---
@@ -98,6 +98,42 @@ pytest --cov=src tests/
 - Review test coverage report
 - Ensure new code paths are tested
 
+#### Bug 修復測試評估
+
+修復 bug 時，評估是否需要新增回歸測試：
+
+**✅ 必須加測試（高價值）**：
+| 情況 | 原因 |
+|------|------|
+| 安全相關的 bug | 防止漏洞再次發生 |
+| 資料完整性相關的 bug | 保護關鍵業務資料 |
+| 造成服務中斷的 bug | 確保系統穩定性 |
+| 曾經重複出現的 bug | 打破重複出現的循環 |
+| 複雜業務邏輯的 bug | 記錄預期行為 |
+
+**⚠️ 測試為可選（低價值）**：
+| 情況 | 原因 |
+|------|------|
+| 單純的 typo 修正 | 再發風險低 |
+| 顯而易見的邏輯錯誤（如 `>` 寫成 `<`） | 審查時容易發現 |
+| 已被現有測試覆蓋 | 避免重複測試 |
+| 一次性的配置錯誤 | 不會在程式碼中再發生 |
+
+**快速決策問題**：
+1. 這個 bug 是否可能因未來的程式碼變更而重現？ → 是 = 加測試
+2. 現有的測試是否能捕捉到這個 bug？ → 否 = 加測試
+3. 這是否影響核心功能或關鍵路徑？ → 是 = 加測試
+4. 這個 bug 曾經出現過嗎？ → 是 = 加測試
+
+**回歸測試命名**：
+```javascript
+describe('Regression: [BUG-ID or description]', () => {
+  it('should [correct behavior] when [trigger condition]', () => {
+    // Test that would have caught the bug
+  });
+});
+```
+
 ---
 
 ### 3. 程式碼品質
@@ -909,6 +945,7 @@ git commit -m "feat(module-c): add export to CSV feature"
 
 | 版本 | 日期 | 變更 |
 |---------|------|---------|
+| 1.4.0 | 2026-01-16 | 新增：Bug 修復測試評估章節與決策矩陣 |
 | 1.3.0 | 2026-01-05 | 新增：SWEBOK v4.0 第 6 章（軟體配置管理）至參考資料 |
 | 1.2.5 | 2025-12-16 | Clarified: CHANGELOG update is for user-facing changes only, added to [Unreleased] section |
 | 1.2.4 | 2025-12-11 | Added: Pre-commit directory hygiene section (IDE artifacts, verification commands) |

package/bundled/skills/claude-code/commands/check.md

@@ -27,6 +27,7 @@ uds check --restore
 
 | Option | Description | 說明 |
 |--------|-------------|------|
+| `--summary` | Show compact status summary | 顯示精簡狀態摘要 |
 | `--offline` | Skip npm registry check | 跳過 npm registry 檢查 |
 | `--diff` | Show diff for modified files | 顯示修改檔案的差異 |
 | `--restore` | Restore all modified and missing files | 還原所有修改和遺失的檔案 |
@@ -35,6 +36,23 @@ uds check --restore
 
 ## Output Sections | 輸出區段
 
+### Summary Mode (--summary) | 摘要模式
+
+When using `--summary`, shows compact status for use by other commands:
+
+使用 `--summary` 時，顯示供其他命令使用的精簡狀態：
+
+```
+UDS Status Summary
+──────────────────────────────────────────────────
+  Version: 3.5.1-beta.16 ✓
+  Level: 2 - Recommended (推薦)
+  Files: 12 ✓
+  Skills: Claude Code ✓ | OpenCode ○
+  Commands: OpenCode ✓
+──────────────────────────────────────────────────
+```
+
 ### Adoption Status | 採用狀態
 - Adoption level (1-3)
 - Installation date

package/bundled/skills/claude-code/commands/config.md

@@ -16,6 +16,20 @@ When invoked without a specific type, use AskUserQuestion to ask what to configu
 
 當不指定類型時，使用 AskUserQuestion 詢問要配置什麼。
 
+### Step 0: Show Current Status | 步驟 0：顯示目前狀態
+
+First, run `uds check --summary` to show current installation status.
+
+首先，執行 `uds check --summary` 顯示目前安裝狀態。
+
+```bash
+uds check --summary
+```
+
+This helps users understand what's currently configured before making changes.
+
+這幫助用戶在修改前了解目前的配置。
+
 ### Step 1: Ask Configuration Type | 步驟 1：詢問配置類型
 
 Use AskUserQuestion with these options:

package/bundled/skills/claude-code/commands/update.md

@@ -18,7 +18,15 @@ When invoked without `--yes`, use AskUserQuestion to confirm update preferences.
 
 ### Step 1: Check Current Status | 步驟 1：檢查目前狀態
 
-First, run `uds check` to show current installation status and available updates.
+First, run `uds check --summary` to show compact installation status.
+
+首先，執行 `uds check --summary` 顯示精簡安裝狀態。
+
+```bash
+uds check --summary
+```
+
+This shows: version (with update indicator), level, files status, Skills status, and Commands status.
 
 ### Step 2: Ask Update Preferences | 步驟 2：詢問更新偏好
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "3.5.1-beta.16",
+  "version": "3.5.1-beta.17",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",
@@ -43,6 +43,7 @@
     "test:e2e": "vitest run tests/e2e/",
     "test:all": "vitest run && vitest run tests/e2e/",
     "lint": "eslint src/",
+    "generate:e2e-spec": "node scripts/generate-e2e-spec.mjs",
     "prepare": "node ../scripts/setup-husky.mjs",
     "prepack": "node scripts/prepack.mjs"
   },