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

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

@@ -0,0 +1,57 @@
+---
+description: Generate or update CHANGELOG following Keep a Changelog format
+allowed-tools: Read, Grep, Glob, Bash(git log:*), Bash(git tag:*), Bash(git diff:*)
+argument-hint: "[version number | 版本號]"
+---
+
+# Changelog Assistant | 變更日誌助手
+
+Generate or update CHANGELOG.md following the Keep a Changelog format.
+
+依據 Keep a Changelog 格式產生或更新 CHANGELOG.md。
+
+## Workflow | 工作流程
+
+1. **Read existing CHANGELOG** - Parse current entries
+2. **Analyze commits** - Get commits since last version tag
+3. **Categorize changes** - Group by type (Added, Changed, etc.)
+4. **Generate entry** - Create new version section
+5. **Update file** - Insert new entry at top of Unreleased section
+
+## Change Categories | 變更類別
+
+| Category | Description | 說明 |
+|----------|-------------|------|
+| **Added** | New features | 新功能 |
+| **Changed** | Changes to existing features | 功能變更 |
+| **Deprecated** | Soon-to-be removed features | 即將移除 |
+| **Removed** | Removed features | 已移除 |
+| **Fixed** | Bug fixes | 錯誤修復 |
+| **Security** | Security vulnerability fixes | 安全修復 |
+
+## CHANGELOG Format | 格式
+
+```markdown
+## [Unreleased]
+
+### Added
+- New feature description
+
+### Fixed
+- Bug fix description
+
+## [1.0.0] - 2024-01-15
+
+### Added
+- Initial release
+```
+
+## Usage | 使用方式
+
+- `/changelog` - Update Unreleased section with recent commits
+- `/changelog 1.2.0` - Prepare changelog for specific version
+
+## Reference | 參考
+
+- Full standard: [changelog-guide](../../changelog-guide/SKILL.md)
+- Core guide: [changelog-standards](../../../../core/changelog-standards.md)

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

@@ -0,0 +1,91 @@
+---
+description: Verify standards adoption status
+allowed-tools: Read, Bash(uds check:*), Bash(npx:*)
+argument-hint: "[--offline | --restore]"
+---
+
+# Check Standards | 檢查標準
+
+Verify the adoption status of Universal Development Standards in the current project.
+
+驗證當前專案的 Universal Development Standards 採用狀態。
+
+## Quick Start | 快速開始
+
+```bash
+# Basic check
+uds check
+
+# Check without network access
+uds check --offline
+
+# Restore missing or modified files
+uds check --restore
+```
+
+## Options | 選項
+
+| Option | Description | 說明 |
+|--------|-------------|------|
+| `--offline` | Skip npm registry check | 跳過 npm registry 檢查 |
+| `--diff` | Show diff for modified files | 顯示修改檔案的差異 |
+| `--restore` | Restore all modified and missing files | 還原所有修改和遺失的檔案 |
+| `--restore-missing` | Restore only missing files | 僅還原遺失的檔案 |
+| `--migrate` | Migrate legacy manifest to hash-based tracking | 遷移舊版 manifest |
+
+## Output Sections | 輸出區段
+
+### Adoption Status | 採用狀態
+- Adoption level (1-3)
+- Installation date
+- Installed version
+
+### File Integrity | 檔案完整性
+- Checks all expected files exist
+- Reports missing or modified files
+- Shows count of present vs missing
+
+### Skills Status | Skills 狀態
+- Installation location (Marketplace, User, Project)
+- Version information
+- Migration suggestions if applicable
+
+### Coverage Summary | 覆蓋率摘要
+- Required standards count for current level
+- Skills vs reference document coverage
+
+## Status Indicators | 狀態指示
+
+| Symbol | Meaning | 意義 |
+|--------|---------|------|
+| ✓ (green) | All good | 一切正常 |
+| ⚠ (yellow) | Warning, action recommended | 警告，建議採取行動 |
+| ✗ (red) | Error, action required | 錯誤，需要採取行動 |
+
+## Common Issues | 常見問題
+
+**"Standards not initialized"**
+- Run `/init` to initialize standards
+
+**"Update available"**
+- Run `/update` to get latest version
+
+**"Missing files"**
+- Run `/check --restore` or `/update` to restore
+
+**"Modified files detected"**
+- Run `/check --diff` to see changes
+- Run `/check --restore` to reset to original
+
+## Usage | 使用方式
+
+- `/check` - Check current adoption status
+- `/check --offline` - Check without network access
+- `/check --restore` - Restore modified/missing files
+- `/check --diff` - Show file differences
+
+## Reference | 參考
+
+- CLI documentation: `uds check --help`
+- Init command: [/init](./init.md)
+- Update command: [/update](./update.md)

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

@@ -0,0 +1,48 @@
+---
+description: Generate commit messages following Conventional Commits standard
+allowed-tools: Read, Grep, Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git add:*), Bash(git commit:*)
+argument-hint: "[description of changes | 變更描述]"
+---
+
+# Commit Message Assistant | Commit Message 助手
+
+Generate well-formatted commit messages following the Conventional Commits standard.
+
+根據 staged 的變更，產生符合 Conventional Commits 格式的 commit message。
+
+## Workflow | 工作流程
+
+1. **Check status** - Run `git status` and `git diff --staged` to understand changes
+2. **Analyze changes** - Determine the type (feat, fix, refactor, etc.) and scope
+3. **Generate message** - Create a commit message following the format:
+   ```
+   <type>(<scope>): <subject>
+
+   <body>
+
+   <footer>
+   ```
+4. **Confirm and commit** - Ask user to confirm before executing `git commit`
+
+## Commit Types | 提交類型
+
+| Type | When to Use | 使用時機 |
+|------|-------------|---------|
+| `feat` | New feature | 新功能 |
+| `fix` | Bug fix | 修復錯誤 |
+| `refactor` | Code refactoring | 重構 |
+| `docs` | Documentation | 文件更新 |
+| `style` | Formatting | 格式調整 |
+| `test` | Tests | 測試相關 |
+| `perf` | Performance | 效能優化 |
+| `chore` | Maintenance | 維護任務 |
+
+## Usage | 使用方式
+
+- `/commit` - Auto-analyze changes and suggest commit message
+- `/commit fix login bug` - Generate message based on provided description
+
+## Reference | 參考
+
+- Full standard: [commit-standards](../../commit-standards/SKILL.md)
+- Core guide: [commit-message-guide](../../../../core/commit-message-guide.md)

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

@@ -0,0 +1,97 @@
+---
+description: Configure project development standards
+allowed-tools: Read, Bash(uds config:*), Bash(uds configure:*)
+argument-hint: "[type]"
+---
+
+# Config Standards | 設定標準
+
+Configure Universal Development Standards settings for the current project.
+
+配置當前專案的 Universal Development Standards 設定。
+
+## Interactive Mode (Default) | 互動模式（預設）
+
+When invoked without a specific type, use AskUserQuestion to ask what to configure.
+
+當不指定類型時，使用 AskUserQuestion 詢問要配置什麼。
+
+### Step 1: Ask Configuration Type | 步驟 1：詢問配置類型
+
+Use AskUserQuestion with these options:
+
+| Option | Description |
+|--------|-------------|
+| **AI Tools** | Add or remove AI tool integrations |
+| **Adoption Level** | Change adoption level (1/2/3) |
+| **Content Mode** | Change how much content is embedded |
+| **Other Options** | Format, workflow, merge strategy, etc. |
+
+### Step 2: Execute Based on Selection | 步驟 2：根據選擇執行
+
+**If AI Tools selected:**
+```bash
+uds config --type ai_tools
+```
+
+**If Adoption Level selected:**
+Ask which level (1/2/3), then:
+```bash
+uds config --type level
+```
+
+**If Content Mode selected:**
+Ask which mode (full/index/minimal), then:
+```bash
+uds config --type content_mode
+```
+
+**If Other Options selected:**
+Ask which specific option, then execute accordingly.
+
+## Quick Mode | 快速模式
+
+When invoked with a specific type, skip interactive questions:
+
+```bash
+/config ai_tools      # Directly configure AI tools
+/config level         # Directly configure adoption level
+/config content_mode  # Directly configure content mode
+```
+
+## Configuration Types | 設定類型
+
+| Type | Description | 說明 |
+|------|-------------|------|
+| `ai_tools` | AI tool integrations | AI 工具整合 |
+| `level` | Adoption level (1/2/3) | 採用等級 |
+| `content_mode` | Integration file content mode | 整合檔案內容模式 |
+| `format` | AI/Human documentation format | AI/人類文件格式 |
+| `workflow` | Git workflow strategy | Git 工作流程策略 |
+| `merge_strategy` | Merge strategy | 合併策略 |
+| `commit_language` | Commit message language | 提交訊息語言 |
+| `test_levels` | Test levels to include | 測試層級 |
+| `all` | Configure all options | 設定所有選項 |
+
+## Content Mode Options | 內容模式選項
+
+| Mode | Description | 說明 |
+|------|-------------|------|
+| `index` | Standards index with compliance instructions (Recommended) | 標準索引（推薦）|
+| `full` | Embed all standards in integration files | 完整內嵌所有標準 |
+| `minimal` | Only core rules embedded | 僅內嵌核心規則 |
+
+## Effects of Configuration Changes | 設定變更的影響
+
+| Configuration | Effect | 影響 |
+|---------------|--------|------|
+| AI Tools (add) | Generates new integration files | 產生新的整合檔案 |
+| AI Tools (remove) | Deletes integration files | 刪除整合檔案 |
+| Level | Updates standards, regenerates integrations | 更新標準，重新產生整合 |
+| Content Mode | Regenerates all integration files | 重新產生所有整合檔案 |
+
+## Reference | 參考
+
+- CLI documentation: `uds config --help`
+- Init command: [/init](./init.md)
+- Check command: [/check](./check.md)

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

@@ -0,0 +1,58 @@
+---
+description: Analyze test coverage and provide recommendations
+allowed-tools: Read, Grep, Glob, Bash(npm run test:coverage:*), Bash(npx:*)
+argument-hint: "[file or module to analyze | 要分析的檔案或模組]"
+---
+
+# Test Coverage Assistant | 測試覆蓋率助手
+
+Analyze test coverage across multiple dimensions and provide actionable recommendations.
+
+多維度分析測試覆蓋率並提供可執行的建議。
+
+## Coverage Dimensions | 覆蓋率維度
+
+| Dimension | What it Measures | 測量內容 |
+|-----------|------------------|----------|
+| **Line** | Lines executed | 執行的行數 |
+| **Branch** | Decision paths | 決策路徑 |
+| **Function** | Functions called | 呼叫的函數 |
+| **Statement** | Statements executed | 執行的陳述式 |
+
+## 7-Dimension Framework | 七維度框架
+
+1. **Code Coverage** - Lines, branches, functions
+2. **Requirement Coverage** - All requirements tested
+3. **Risk Coverage** - High-risk areas tested
+4. **Integration Coverage** - Component interactions
+5. **Edge Case Coverage** - Boundary conditions
+6. **Error Coverage** - Error handling paths
+7. **Permission Coverage** - Access control scenarios
+
+## Workflow | 工作流程
+
+1. **Run coverage tool** - Generate coverage report
+2. **Analyze gaps** - Identify untested areas
+3. **Prioritize** - Rank by risk and importance
+4. **Recommend tests** - Suggest specific tests to add
+5. **Track progress** - Monitor coverage over time
+
+## Coverage Targets | 覆蓋率目標
+
+| Level | Coverage | Use Case |
+|-------|----------|----------|
+| Minimum | 60% | Legacy code |
+| Standard | 80% | Most projects |
+| High | 90% | Critical systems |
+| Critical | 95%+ | Safety-critical |
+
+## Usage | 使用方式
+
+- `/coverage` - Run full coverage analysis
+- `/coverage src/auth` - Analyze specific module
+- `/coverage --recommend` - Get test recommendations
+
+## Reference | 參考
+
+- Full standard: [test-coverage-assistant](../../test-coverage-assistant/SKILL.md)
+- Core guide: [testing-standards](../../../../core/testing-standards.md)

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

@@ -0,0 +1,75 @@
+---
+description: Create or update project documentation structure
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[document type: readme|api|contributing | 文件類型]"
+---
+
+# Documentation Assistant | 文件助手
+
+Create and maintain well-structured project documentation.
+
+建立和維護結構良好的專案文件。
+
+## Workflow | 工作流程
+
+1. **Assess current state** - Check existing documentation
+2. **Identify gaps** - What documentation is missing?
+3. **Generate templates** - Create appropriate document templates
+4. **Fill content** - Add project-specific information
+5. **Validate links** - Ensure all references work
+
+## Document Types | 文件類型
+
+| Type | Purpose | 用途 |
+|------|---------|------|
+| **README.md** | Project overview | 專案概述 |
+| **CONTRIBUTING.md** | Contribution guide | 貢獻指南 |
+| **CHANGELOG.md** | Version history | 版本歷史 |
+| **API.md** | API documentation | API 文件 |
+| **docs/** | Detailed guides | 詳細指南 |
+
+## README Structure | README 結構
+
+```markdown
+# Project Name
+
+Brief description.
+
+## Features
+- Feature 1
+- Feature 2
+
+## Installation
+```bash
+npm install package
+```
+
+## Usage
+[Examples]
+
+## Contributing
+See CONTRIBUTING.md
+
+## License
+MIT
+```
+
+## Documentation Checklist | 文件檢查清單
+
+- [ ] README has clear project description
+- [ ] Installation instructions are accurate
+- [ ] Usage examples are provided
+- [ ] API is documented (if applicable)
+- [ ] Contributing guidelines exist
+- [ ] License is specified
+
+## Usage | 使用方式
+
+- `/docs` - Audit current documentation
+- `/docs readme` - Generate/update README
+- `/docs api` - Generate API documentation
+
+## Reference | 參考
+
+- Full standard: [documentation-guide](../../documentation-guide/SKILL.md)
+- Core guide: [documentation-standards](../../../../core/documentation-standards.md)

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

@@ -0,0 +1,88 @@
+---
+description: Initialize development standards in current project
+allowed-tools: Read, Bash(uds init:*), Bash(npx:*)
+argument-hint: "[--level N | --yes]"
+---
+
+# Initialize Standards | 初始化標準
+
+Initialize Universal Development Standards in the current project.
+
+在當前專案初始化 Universal Development Standards。
+
+## Interactive Mode (Default) | 互動模式（預設）
+
+When invoked without `--yes`, use AskUserQuestion to gather user preferences before executing.
+
+當不帶 `--yes` 執行時，使用 AskUserQuestion 詢問用戶偏好後再執行。
+
+### Step 1: Ask Adoption Level | 步驟 1：詢問採用層級
+
+Use AskUserQuestion with these options:
+
+| Option | Description |
+|--------|-------------|
+| **Recommended (Level 2)** | Professional quality for teams (Recommended) |
+| **Essential (Level 1)** | Minimum viable standards for small projects |
+| **Enterprise (Level 3)** | Comprehensive for regulated/enterprise projects |
+
+### Step 2: Ask Skills Location | 步驟 2：詢問 Skills 安裝位置
+
+Use AskUserQuestion with these options:
+
+| Option | Description |
+|--------|-------------|
+| **Plugin Marketplace** | Auto-updates, recommended for most users |
+| **User Level** | Install at ~/.claude/skills/ |
+| **Project Level** | Install at .claude/skills/ |
+| **Skip** | Don't install Skills |
+
+### Step 3: Execute | 步驟 3：執行
+
+After collecting answers, execute:
+
+```bash
+uds init --level <level> --skills-location <location> --yes
+```
+
+Explain the results and next steps to the user.
+
+## Quick Mode | 快速模式
+
+When invoked with `--yes` or specific options, skip interactive questions:
+
+```bash
+/init --yes              # Use defaults
+/init --level 2 --yes    # Specific level with defaults
+```
+
+## Options Reference | 選項參考
+
+| Option | Description | 說明 |
+|--------|-------------|------|
+| `--yes`, `-y` | Non-interactive mode | 非互動模式 |
+| `--level N` | Adoption level (1, 2, or 3) | 採用層級 |
+| `--skills-location` | marketplace, user, project, or none | Skills 位置 |
+| `--format` | ai, human, or both | 格式 |
+
+See `uds init --help` for all options.
+
+## Adoption Levels | 採用層級
+
+| Level | Name | Description | 說明 |
+|-------|------|-------------|------|
+| 1 | Essential | Minimum viable standards | 最基本的標準 |
+| 2 | Recommended | Professional quality for teams | 團隊專業品質標準 |
+| 3 | Enterprise | Comprehensive for regulated projects | 企業級完整標準 |
+
+## What Gets Installed | 安裝內容
+
+- `.standards/` directory with core standards
+- Integration files (`.cursorrules`, `CLAUDE.md`, etc.)
+- Skills (via Plugin Marketplace or local installation)
+- `manifest.json` for tracking installation
+
+## Reference | 參考
+
+- CLI documentation: `uds init --help`
+- Adoption guide: [ADOPTION-GUIDE.md](../../../adoption/ADOPTION-GUIDE.md)