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

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

@@ -0,0 +1,268 @@
+---
+description: Manage development methodology workflow
+allowed-tools: Read, Write, Glob, Grep, Bash(git:*)
+argument-hint: "[action] [argument]"
+status: experimental
+---
+
+# Methodology Command | 方法論命令
+
+> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/commands/methodology.md)
+
+> [!WARNING]
+> **Experimental Feature / 實驗性功能**
+>
+> This feature is under active development and may change significantly in v4.0.
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+Manage the active development methodology for the current project. Supports TDD, BDD, SDD, ATDD, and custom methodologies.
+
+管理當前專案的開發方法論。支援 TDD、BDD、SDD、ATDD 和自訂方法論。
+
+---
+
+## Actions | 動作
+
+| Action | Description | 說明 |
+|--------|-------------|------|
+| *(none)* | Show current methodology status | 顯示當前方法論狀態 |
+| `status` | Show current phase and checklist | 顯示當前階段和檢查清單 |
+| `switch <id>` | Switch to different methodology | 切換到不同方法論 |
+| `phase [name]` | Show or change current phase | 顯示或變更當前階段 |
+| `checklist` | Show current phase checklist | 顯示當前階段檢查清單 |
+| `skip` | Skip current phase (with warning) | 跳過當前階段（會有警告） |
+| `list` | List available methodologies | 列出可用方法論 |
+| `create` | Create custom methodology | 建立自訂方法論 |
+
+---
+
+## Usage | 使用方式
+
+### Show Status | 顯示狀態
+
+```bash
+/methodology
+/methodology status
+```
+
+**Output:**
+```
+┌────────────────────────────────────────────────┐
+│ 📋 Active Methodology: TDD                      │
+│ 📍 Current Phase: 🔴 RED (1-5 min)              │
+│ ⏱️  Duration: 3 minutes                         │
+├────────────────────────────────────────────────┤
+│ Checklist:                                     │
+│   ✅ Test describes behavior                   │
+│   ✅ Test name is clear                        │
+│   ⬜ Test follows AAA pattern                  │
+│   ⬜ Test fails when run                       │
+├────────────────────────────────────────────────┤
+│ Next: Complete the checklist, then run test    │
+└────────────────────────────────────────────────┘
+```
+
+### Switch Methodology | 切換方法論
+
+```bash
+/methodology switch sdd
+/methodology switch bdd
+/methodology switch my-custom-workflow
+```
+
+**Output:**
+```
+Switching methodology: TDD → SDD
+
+⚠️ Warning: You have uncommitted changes.
+   Current phase: GREEN
+   Files changed: 3
+
+Options:
+[1] Commit changes first, then switch
+[2] Stash changes and switch
+[3] Switch anyway (changes preserved)
+[4] Cancel
+
+> 1
+
+Committing changes...
+Switched to: SDD (Spec-Driven Development)
+Current phase: Proposal
+```
+
+### Change Phase | 變更階段
+
+```bash
+/methodology phase              # Show current phase
+/methodology phase green        # Move to GREEN phase (TDD)
+/methodology phase refactor     # Move to REFACTOR phase
+```
+
+### Show Checklist | 顯示檢查清單
+
+```bash
+/methodology checklist
+```
+
+**Output:**
+```
+📋 RED Phase Checklist (TDD)
+
+Required:
+  ⬜ Test describes expected behavior
+  ✅ Test name clearly states what is being tested
+  ⬜ Test follows AAA pattern (Arrange-Act-Assert)
+  ⬜ Test FAILS when run
+  ⬜ Failure is for the RIGHT reason
+
+Optional:
+  ⬜ Test has exactly ONE assertion
+
+Progress: 1/5 required items complete
+```
+
+### Skip Phase | 跳過階段
+
+```bash
+/methodology skip
+```
+
+**Output:**
+```
+⚠️ Skip Phase Warning
+
+You are about to skip the RED phase without completing:
+  ⬜ Test follows AAA pattern
+  ⬜ Test FAILS when run
+
+This is skip #2 of 3 before warning.
+
+Are you sure you want to skip?
+[1] Yes, skip this phase
+[2] No, continue working on checklist
+```
+
+### List Methodologies | 列出方法論
+
+```bash
+/methodology list
+```
+
+**Output:**
+```
+📚 Available Methodologies
+
+Built-in:
+  ├─ tdd    Test-Driven Development (Red → Green → Refactor)
+  ├─ bdd    Behavior-Driven Development (Given-When-Then)
+  ├─ sdd    Spec-Driven Development (Spec First, Code Second)
+  └─ atdd   Acceptance Test-Driven Development
+
+Custom (.standards/methodologies/):
+  └─ my-team-workflow   Our Team's Development Process
+
+Active: tdd ✓
+
+Use '/methodology switch <id>' to change.
+```
+
+### Create Custom | 建立自訂
+
+```bash
+/methodology create
+```
+
+Starts the interactive methodology creation wizard. See [create-methodology.md](../methodology-system/create-methodology.md) for details.
+
+---
+
+## Configuration | 配置
+
+Methodology settings are stored in `.standards/manifest.json`:
+
+```json
+{
+  "methodology": {
+    "active": "tdd",
+    "available": ["tdd", "bdd", "sdd", "atdd", "my-team-workflow"],
+    "config": {
+      "tdd": {
+        "checkpointsEnabled": true,
+        "reminderIntensity": "suggest",
+        "skipLimit": 3
+      }
+    }
+  }
+}
+```
+
+### Configuration via /config | 透過 /config 配置
+
+You can also configure methodology settings using:
+
+```bash
+/config methodology
+```
+
+---
+
+## Examples | 範例
+
+### Start TDD for a Feature | 為功能啟動 TDD
+
+```bash
+# Activate TDD methodology
+/methodology switch tdd
+
+# Or use the TDD command directly (activates TDD automatically)
+/tdd "validate user email format"
+```
+
+### Review Progress During Development | 開發過程中檢查進度
+
+```bash
+# Check current status
+/methodology status
+
+# View checklist
+/methodology checklist
+
+# If ready, move to next phase
+/methodology phase green
+```
+
+### Switch to SDD for Major Change | 為重大變更切換到 SDD
+
+```bash
+# Switch to spec-driven for architectural changes
+/methodology switch sdd
+
+# This activates the Proposal → Review → Implementation flow
+```
+
+---
+
+## Related Commands | 相關命令
+
+| Command | Description |
+|---------|-------------|
+| `/tdd` | Start TDD workflow (activates TDD methodology) |
+| `/spec` | Start SDD workflow (activates SDD methodology) |
+| `/config methodology` | Configure methodology settings |
+
+---
+
+## Reference | 參考
+
+- [Methodology System Skill](../methodology-system/SKILL.md) - Full skill documentation
+- [Runtime Guide](../methodology-system/runtime.md) - AI behavior specification
+- [Create Custom](../methodology-system/create-methodology.md) - Custom methodology guide
+
+---
+
+## Version History | 版本歷史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2026-01-12 | Initial /methodology command |

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

@@ -0,0 +1,50 @@
+---
+description: Guide through release process with semantic versioning
+allowed-tools: Read, Grep, Glob, Bash(git:*), Bash(npm version:*), Bash(gh release:*)
+argument-hint: "[version type: major|minor|patch|beta | 版本類型]"
+---
+
+# Release Assistant | 發布助手
+
+Guide through the complete release process following semantic versioning standards.
+
+引導完整的發布流程，遵循語義化版本標準。
+
+## Workflow | 工作流程
+
+1. **Pre-release checks** - Run tests, linting, verify git status
+2. **Determine version** - Based on changes since last release
+3. **Update CHANGELOG** - Document all changes
+4. **Update version** - Bump version in package.json
+5. **Create tag** - Git tag with version number
+6. **Push changes** - Commit and push to remote
+7. **Create release** - GitHub release (triggers npm publish)
+
+## Version Types | 版本類型
+
+| Type | When to Use | Example |
+|------|-------------|---------|
+| `major` | Breaking changes | 1.0.0 → 2.0.0 |
+| `minor` | New features (backward compatible) | 1.0.0 → 1.1.0 |
+| `patch` | Bug fixes | 1.0.0 → 1.0.1 |
+| `beta` | Pre-release testing | 1.0.0 → 1.1.0-beta.1 |
+| `alpha` | Early testing | 1.0.0 → 1.1.0-alpha.1 |
+
+## Pre-release Checklist | 發布前檢查
+
+- [ ] All tests pass
+- [ ] Linting passes
+- [ ] Git working directory is clean
+- [ ] On correct branch (main for stable)
+- [ ] CHANGELOG is updated
+
+## Usage | 使用方式
+
+- `/release` - Interactive release wizard
+- `/release patch` - Create patch release
+- `/release beta` - Create beta pre-release
+
+## Reference | 參考
+
+- Full standard: [release-standards](../../release-standards/SKILL.md)
+- Workflow guide: [release-workflow](../../release-standards/release-workflow.md)

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

@@ -0,0 +1,54 @@
+---
+description: Write user stories and requirements following INVEST criteria
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[feature name or description | 功能名稱或描述]"
+---
+
+# Requirement Assistant | 需求助手
+
+Write well-structured user stories and requirements following INVEST criteria.
+
+撰寫結構良好的用戶故事和需求文件，遵循 INVEST 標準。
+
+## Workflow | 工作流程
+
+1. **Understand context** - Gather information about the feature
+2. **Identify stakeholders** - Who benefits from this feature?
+3. **Write user story** - Follow the standard format
+4. **Define acceptance criteria** - Specific, testable conditions
+5. **Validate with INVEST** - Check quality criteria
+
+## User Story Format | 用戶故事格式
+
+```markdown
+As a [role],
+I want [feature],
+So that [benefit].
+
+### Acceptance Criteria
+
+- [ ] Given [context], when [action], then [result]
+- [ ] Given [context], when [action], then [result]
+```
+
+## INVEST Criteria | INVEST 標準
+
+| Criterion | Description | 說明 |
+|-----------|-------------|------|
+| **I**ndependent | Can be developed separately | 可獨立開發 |
+| **N**egotiable | Details can be discussed | 可協商細節 |
+| **V**aluable | Delivers value to user | 提供用戶價值 |
+| **E**stimable | Can estimate effort | 可估算工作量 |
+| **S**mall | Fits in one sprint | 適合單一迭代 |
+| **T**estable | Has clear test criteria | 有明確測試標準 |
+
+## Usage | 使用方式
+
+- `/requirement` - Interactive requirement writing wizard
+- `/requirement user login` - Write requirement for specific feature
+- `/requirement "users can export data"` - Based on description
+
+## Reference | 參考
+
+- Full standard: [requirement-assistant](../../requirement-assistant/SKILL.md)
+- Core guide: [requirements-standards](../../../../core/requirements-standards.md)

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

@@ -0,0 +1,50 @@
+---
+description: Perform systematic code review with checklist
+allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*)
+argument-hint: "[file path or branch | 檔案路徑或分支名稱]"
+---
+
+# Code Review Assistant | 程式碼審查助手
+
+Perform systematic code review using standardized checklists and comment prefixes.
+
+執行系統性的程式碼審查，使用標準化的檢查清單和評論前綴。
+
+## Workflow | 工作流程
+
+1. **Identify changes** - Get diff of files to review
+2. **Apply checklist** - Check each category systematically
+3. **Generate report** - Output findings with standard prefixes
+4. **Summarize** - Provide overall assessment
+
+## Review Categories | 審查類別
+
+1. **Functionality** - Does it work correctly?
+2. **Design** - Is the architecture appropriate?
+3. **Quality** - Is the code clean and maintainable?
+4. **Readability** - Is it easy to understand?
+5. **Tests** - Is there adequate test coverage?
+6. **Security** - Are there any vulnerabilities?
+7. **Performance** - Is it efficient?
+8. **Error Handling** - Are errors handled properly?
+
+## Comment Prefixes | 評論前綴
+
+| Prefix | Meaning | Action |
+|--------|---------|--------|
+| **BLOCKING** | Must fix before merge | Required |
+| **IMPORTANT** | Should fix | Recommended |
+| **SUGGESTION** | Nice-to-have | Optional |
+| **QUESTION** | Need clarification | Discuss |
+| **NOTE** | Informational | FYI |
+
+## Usage | 使用方式
+
+- `/review` - Review all changes in current branch
+- `/review src/auth.js` - Review specific file
+- `/review feature/login` - Review specific branch
+
+## Reference | 參考
+
+- Full standard: [code-review-assistant](../../code-review-assistant/SKILL.md)
+- Core guide: [code-review-checklist](../../../../core/code-review-checklist.md)

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

@@ -0,0 +1,69 @@
+---
+description: Create or review specification documents for Spec-Driven Development
+allowed-tools: Read, Write, Grep, Glob, Bash(git:*)
+argument-hint: "[spec name or feature | 規格名稱或功能]"
+---
+
+# Spec-Driven Development Assistant | 規格驅動開發助手
+
+Create, review, and manage specification documents for implementing features.
+
+建立、審查和管理規格文件，用於實作功能。
+
+## Workflow | 工作流程
+
+1. **Create spec** - Write detailed specification document
+2. **Review spec** - Validate against requirements
+3. **Approve spec** - Get stakeholder sign-off
+4. **Implement** - Code follows the approved spec
+5. **Verify** - Ensure implementation matches spec
+
+## Spec Document Structure | 規格文件結構
+
+```markdown
+# Feature: [Feature Name]
+
+## Overview
+Brief description of the feature.
+
+## Requirements
+- REQ-001: [Requirement description]
+- REQ-002: [Requirement description]
+
+## Technical Design
+### Architecture
+[Design details]
+
+### API Changes
+[API specifications]
+
+### Database Changes
+[Schema changes]
+
+## Test Plan
+- [ ] Unit tests for [component]
+- [ ] Integration tests for [flow]
+
+## Rollout Plan
+[Deployment strategy]
+```
+
+## Spec States | 規格狀態
+
+| State | Description | 說明 |
+|-------|-------------|------|
+| Draft | Work in progress | 草稿中 |
+| Review | Under review | 審查中 |
+| Approved | Ready for implementation | 已核准 |
+| Implemented | Code complete | 已實作 |
+| Archived | Completed or deprecated | 已歸檔 |
+
+## Usage | 使用方式
+
+- `/spec` - Interactive spec creation wizard
+- `/spec auth-flow` - Create spec for specific feature
+- `/spec review` - Review existing specs
+
+## Reference | 參考
+
+- Full standard: [spec-driven-dev](../../spec-driven-dev/SKILL.md)

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

@@ -0,0 +1,86 @@
+---
+description: Guide through Test-Driven Development workflow
+allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
+argument-hint: "[feature or function to implement | 要實作的功能]"
+status: experimental
+---
+
+# TDD Assistant | TDD 助手
+
+> [!WARNING]
+> **Experimental Feature / 實驗性功能**
+>
+> This feature is under active development and may change significantly in v4.0.
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+Guide through the Test-Driven Development (TDD) workflow: Red-Green-Refactor.
+
+引導測試驅動開發（TDD）流程：紅-綠-重構。
+
+## Methodology Integration | 方法論整合
+
+When `/tdd` is invoked:
+1. **Automatically activate TDD methodology** if not already active
+2. **Set current phase to RED** (writing failing test)
+3. **Track phase transitions** as work progresses
+4. **Show phase indicators** in responses (🔴 RED, 🟢 GREEN, 🔵 REFACTOR)
+
+當調用 `/tdd` 時：
+1. **自動啟用 TDD 方法論**（如果尚未啟用）
+2. **將當前階段設為紅燈**（撰寫失敗的測試）
+3. **追蹤階段轉換**隨著工作進展
+4. **在回應中顯示階段指示器**（🔴 紅燈、🟢 綠燈、🔵 重構）
+
+See [methodology-system](../methodology-system/SKILL.md) for full methodology tracking.
+
+## TDD Cycle | TDD 循環
+
+```
+┌─────────────────────────────────────────┐
+│                                         │
+│    ┌─────┐     ┌─────┐     ┌─────────┐ │
+│    │ RED │ ──► │GREEN│ ──► │REFACTOR │ │
+│    └─────┘     └─────┘     └─────────┘ │
+│       ▲                          │      │
+│       └──────────────────────────┘      │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+## Workflow | 工作流程
+
+### 1. RED - Write Failing Test
+- Write a test for the desired behavior
+- Run test - it should fail
+- Confirms test is valid
+
+### 2. GREEN - Make Test Pass
+- Write minimal code to pass the test
+- No extra functionality
+- Run test - it should pass
+
+### 3. REFACTOR - Improve Code
+- Clean up the code
+- Remove duplication
+- All tests should still pass
+
+## FIRST Principles | FIRST 原則
+
+| Principle | Description | 說明 |
+|-----------|-------------|------|
+| **F**ast | Tests run quickly | 快速執行 |
+| **I**ndependent | No test dependencies | 無相依性 |
+| **R**epeatable | Same result every time | 可重複 |
+| **S**elf-validating | Pass/fail is clear | 自我驗證 |
+| **T**imely | Written before code | 及時撰寫 |
+
+## Usage | 使用方式
+
+- `/tdd` - Start interactive TDD session
+- `/tdd calculateTotal` - TDD for specific function
+- `/tdd "user can login"` - TDD for user story
+
+## Reference | 參考
+
+- Full standard: [tdd-assistant](../../tdd-assistant/SKILL.md)
+- Core guide: [testing-standards](../../../../core/testing-standards.md)

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

@@ -0,0 +1,122 @@
+---
+description: Update development standards to latest version
+allowed-tools: Read, Bash(uds update:*), Bash(uds check:*), Bash(npx:*), Bash(cat .standards/*), Bash(ls .claude/*), Bash(ls .opencode/*), Bash(ls .github/*)
+argument-hint: "[--yes] [--offline] [--beta]"
+---
+
+# Update Standards | 更新標準
+
+Update Universal Development Standards to the latest version.
+
+將 Universal Development Standards 更新至最新版本。
+
+## Interactive Mode (Default) | 互動模式（預設）
+
+When invoked without `--yes`, use AskUserQuestion to confirm update preferences.
+
+當不帶 `--yes` 執行時，使用 AskUserQuestion 確認更新偏好。
+
+### Step 1: Check Current Status | 步驟 1：檢查目前狀態
+
+First, run `uds check` to show current installation status and available updates.
+
+### Step 2: Ask Update Preferences | 步驟 2：詢問更新偏好
+
+If updates are available, use AskUserQuestion with these options:
+
+| Option | Description |
+|--------|-------------|
+| **Update Now** | Update standards to latest stable version (Recommended) |
+| **Check Beta** | Check for beta version updates |
+| **Skip** | Don't update at this time |
+
+### Step 3: Execute | 步驟 3：執行
+
+**If Update Now selected:**
+```bash
+uds update --yes
+```
+
+**If Check Beta selected:**
+```bash
+uds update --beta --yes
+```
+
+### Step 4: Check New Features | 步驟 4：檢查新功能
+
+After update completes, check if Skills/Commands need to be installed:
+
+更新完成後，檢查是否需要安裝 Skills/Commands：
+
+1. Read `.standards/manifest.json` to get `aiTools` list and `skills.installed` status
+2. Check if Skills are installed: `skills.installed === true`
+3. Check if Commands are installed for tools that support them (opencode, copilot, gemini-cli, roo-code)
+
+If `skills.installed` is `false` OR command directories are missing for supported tools, use AskUserQuestion:
+
+| Option | Description | 說明 |
+|--------|-------------|------|
+| **Install All (Recommended)** | Install Skills + Commands | 安裝 Skills 和斜線命令 |
+| **Skills Only** | Install Skills to .claude/skills/ | 只安裝 Skills |
+| **Commands Only** | Install Commands for supported tools | 只安裝斜線命令 |
+| **Skip** | Don't install features | 跳過 |
+
+**If Install All or Skills Only selected:**
+```bash
+uds update --skills
+```
+
+**If Install All or Commands Only selected:**
+```bash
+uds update --commands
+```
+
+Explain the results and any next steps to the user.
+
+## Quick Mode | 快速模式
+
+When invoked with `--yes` or specific options, skip interactive questions:
+
+```bash
+/update --yes           # Update without confirmation
+/update --beta --yes    # Update to beta version
+/update --offline       # Skip npm registry check
+```
+
+## Options Reference | 選項參考
+
+| Option | Description | 說明 |
+|--------|-------------|------|
+| `--yes`, `-y` | Skip confirmation prompt | 跳過確認提示 |
+| `--offline` | Skip npm registry check | 跳過 npm registry 檢查 |
+| `--beta` | Check for beta version updates | 檢查 beta 版本更新 |
+
+## What Gets Updated | 更新內容
+
+- Standard files in `.standards/` directory
+- Extension files (language, framework, locale)
+- Integration files (`.cursorrules`, etc.)
+- Version info in `manifest.json`
+
+## Skills Update | Skills 更新
+
+Skills are managed separately:
+
+| Installation | Update Method | 更新方法 |
+|--------------|---------------|----------|
+| Plugin Marketplace | Auto-updates on Claude Code restart | 重啟 Claude Code 自動更新 |
+| User-level | `cd ~/.claude/skills && git pull` | 手動更新 |
+| Project-level | `cd .claude/skills && git pull` | 手動更新 |
+
+## Troubleshooting | 疑難排解
+
+**"Standards not initialized"**
+- Run `/init` first to initialize standards
+
+**"Already up to date"**
+- No action needed; standards are current
+
+## Reference | 參考
+
+- CLI documentation: `uds update --help`
+- Check command: [/check](./check.md)