universal-dev-standards 3.5.1-beta.18 → 3.5.1-beta.19

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

@@ -1,7 +1,7 @@
 ---
 description: Verify standards adoption status
 allowed-tools: Read, Bash(uds check:*), Bash(npx:*), Bash(ls:*)
-argument-hint: "[--offline | --restore]"
+argument-hint: "[--offline | --restore | --summary]"
 ---
 
 # Check Standards | 檢查標準
@@ -13,9 +13,12 @@ Verify the adoption status of Universal Development Standards in the current pro
 ## Quick Start | 快速開始
 
 ```bash
-# Basic check
+# Basic check (with interactive mode for issues)
 uds check
 
+# Compact summary for quick status
+uds check --summary
+
 # Check without network access
 uds check --offline
 
@@ -23,29 +26,18 @@ uds check --offline
 uds check --restore
 ```
 
-## Options | 選項
-
-| 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 | 還原所有修改和遺失的檔案 |
-| `--restore-missing` | Restore only missing files | 僅還原遺失的檔案 |
-| `--migrate` | Migrate legacy manifest to hash-based tracking | 遷移舊版 manifest |
-
-## Output Sections | 輸出區段
+## Output Modes | 輸出模式
 
 ### Summary Mode (--summary) | 摘要模式
 
-When using `--summary`, shows compact status for use by other commands:
+Shows compact status for quick overview:
 
-使用 `--summary` 時，顯示供其他命令使用的精簡狀態：
+顯示精簡狀態供快速瀏覽：
 
 ```
 UDS Status Summary
 ──────────────────────────────────────────────────
-  Version: 3.5.1-beta.16 ✓
+  Version: 3.5.1-beta.16 → 3.5.1-beta.18 ⚠
   Level: 2 - Recommended (推薦)
   Files: 12 ✓
   Skills: Claude Code ✓ | OpenCode ○
@@ -53,57 +45,127 @@ UDS Status Summary
 ──────────────────────────────────────────────────
 ```
 
+### Full Mode (Default) | 完整模式
+
+Shows detailed information including:
+- Adoption status (level, version, install date)
+- File integrity (unchanged/modified/missing counts)
+- Skills integrity (if tracked in manifest)
+- Commands integrity (if tracked in manifest)
+- Integration blocks integrity
+- Reference sync status
+- AI tool integration files coverage
+- Coverage report
+
+## Interactive Mode | 互動模式
+
+When issues are detected (modified/missing files), CLI automatically enters interactive mode:
+
+當偵測到問題時，CLI 自動進入互動模式：
+
+```
+──────────────────────────────────────────────────
+⚠ Modified: .standards/commit-message-guide.md
+
+? What would you like to do?
+❯ View diff
+  Restore original
+  Keep current (update hash)
+  Skip
+```
+
+**Available actions:**
+
+| Action | Description |
+|--------|-------------|
+| **View diff** | Show differences between current and original |
+| **Restore original** | Replace with upstream version |
+| **Keep current** | Accept modifications and update hash |
+| **Skip** | Do nothing for this file |
+
+For missing files:
+
+| Action | Description |
+|--------|-------------|
+| **Restore** | Download and restore from upstream |
+| **Remove from tracking** | Remove from manifest |
+| **Skip** | Do nothing for this file |
+
+## Options | 選項
+
+| 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 | 還原所有修改和遺失的檔案 |
+| `--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
+- Update availability
 
 ### 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
+Shows status for each tracked file:
 
-### Skills Verification | Skills 驗證
+| Symbol | Meaning | 意義 |
+|--------|---------|------|
+| ✓ (green) | Unchanged | 未變更 |
+| ⚠ (yellow) | Modified | 已修改 |
+| ✗ (red) | Missing | 遺失 |
+| ? (gray) | Exists but no hash | 存在但無 hash |
 
-After displaying `uds check` results, verify Skills installation by checking actual paths.
+Summary format: `{unchanged} unchanged, {modified} modified, {missing} missing`
 
-顯示 `uds check` 結果後，透過檢查實際路徑來驗證 Skills 安裝。
+### Skills Integrity (v3.3.0+) | Skills 完整性
 
-**For each AI tool showing "✓ installed", run diagnostic commands:**
+If `skillHashes` exist in manifest, checks:
+- File existence at expected paths
+- Hash comparison for modifications
 
-針對每個顯示「✓ 已安裝」的 AI 工具，執行診斷命令：
+### Commands Integrity (v3.3.0+) | Commands 完整性
 
-| AI Tool | Skills Path | Diagnostic Command |
-|---------|-------------|-------------------|
-| Claude Code | `.claude/skills/` | `ls -la .claude/skills/ 2>/dev/null \|\| echo "Not found"` |
-| OpenCode | `.opencode/skill/` | `ls -la .opencode/skill/ 2>/dev/null \|\| echo "Not found"` |
-| GitHub Copilot | `.github/skills/` | `ls -la .github/skills/ 2>/dev/null \|\| echo "Not found"` |
-| Cursor | `.cursor/skills/` | `ls -la .cursor/skills/ 2>/dev/null \|\| echo "Not found"` |
+If `commandHashes` exist in manifest, checks:
+- File existence at expected paths
+- Hash comparison for modifications
 
-**Expected output for valid installation:**
-- Should see skill directories (e.g., `commit-standards/`, `testing-guide/`)
-- Each skill directory should contain `SKILL.md`
+### Integration Blocks Integrity (v3.3.0+) | 整合區塊完整性
 
-**有效安裝的預期輸出：**
-- 應看到 skill 目錄（如 `commit-standards/`、`testing-guide/`）
-- 每個 skill 目錄應包含 `SKILL.md`
+If `integrationBlockHashes` exist in manifest, checks:
+- UDS marker block presence
+- Block content hash (user customizations outside blocks are preserved)
 
-**If directory is empty or not found:**
-- Skills are NOT actually installed
-- Run `/update` and select "Install All" to install
+### Skills Status | Skills 狀態
 
-**如果目錄為空或不存在：**
-- Skills 實際上未安裝
-- 執行 `/update` 並選擇「全部安裝」
+Shows installation status for each configured AI tool:
+
+```
+Skills Status
+  Claude Code:
+    ✓ Skills installed:
+      - User level: ~/.claude/skills/
+        Version: 3.5.1
+    ✓ Commands: 7 installed
+      Path: .opencode/commands/
+```
+
+Status indicators:
+- ✓ installed (green) - Skills/Commands are installed
+- ○ not installed (gray) - Not installed
 
 ### Coverage Summary | 覆蓋率摘要
-- Required standards count for current level
-- Skills vs reference document coverage
+
+Shows standards coverage:
+- Required standards for current level
+- Standards covered by Skills
+- Standards covered by reference documents
 
 ## Status Indicators | 狀態指示
 
@@ -112,6 +174,7 @@ After displaying `uds check` results, verify Skills installation by checking act
 | ✓ (green) | All good | 一切正常 |
 | ⚠ (yellow) | Warning, action recommended | 警告，建議採取行動 |
 | ✗ (red) | Error, action required | 錯誤，需要採取行動 |
+| ○ (gray) | Not installed/configured | 未安裝/配置 |
 
 ## Common Issues | 常見問題
 
@@ -127,16 +190,29 @@ After displaying `uds check` results, verify Skills installation by checking act
 **"Modified files detected"**
 - Run `/check --diff` to see changes
 - Run `/check --restore` to reset to original
+- Or use interactive mode to handle each file
+
+**"Skills not installed"**
+- Run `/update` to install missing Skills
+- Or run `/config skills` to manage Skills
+
+**"Legacy manifest detected"**
+- Run `uds check --migrate` to upgrade to hash-based tracking
 
 ## Usage | 使用方式
 
-- `/check` - Check current adoption status
-- `/check --offline` - Check without network access
-- `/check --restore` - Restore modified/missing files
-- `/check --diff` - Show file differences
+```bash
+/check                  # Full check with interactive mode
+/check --summary        # Quick status overview
+/check --offline        # Check without network access
+/check --restore        # Restore modified/missing files
+/check --diff           # Show file differences
+/check --migrate        # Upgrade manifest format
+```
 
 ## Reference | 參考
 
 - CLI documentation: `uds check --help`
 - Init command: [/init](./init.md)
 - Update command: [/update](./update.md)
+- Config command: [/config](./config.md)

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

@@ -1,7 +1,7 @@
 ---
 description: Configure project development standards
-allowed-tools: Read, Bash(uds config:*), Bash(uds configure:*)
-argument-hint: "[type]"
+allowed-tools: Read, Bash(uds config:*), Bash(uds configure:*), Bash(uds check:*)
+argument-hint: "[type] [--ai-tool <tool>]"
 ---
 
 # Config Standards | 設定標準
@@ -34,50 +34,75 @@ This helps users understand what's currently configured before making changes.
 
 Use AskUserQuestion with these options:
 
-| Option | Description |
-|--------|-------------|
+| Category | Options |
+|----------|---------|
+| **Basic Options** | Format, Git Workflow, Merge Strategy, Commit Language, Test Levels |
 | **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. |
+| **Skills** | Manage Skills installations (install/update/reinstall declined) |
+| **Commands** | Manage Commands installations |
+| **Advanced** | Adoption Level, Content Mode |
+| **All** | Configure all options |
 
 ### Step 2: Execute Based on Selection | 步驟 2：根據選擇執行
 
 **If AI Tools selected:**
 ```bash
-uds config --type ai_tools
+uds configure --type ai_tools
+```
+
+**If Skills selected:**
+```bash
+uds configure --type skills
+```
+
+**If Commands selected:**
+```bash
+uds configure --type commands
 ```
 
 **If Adoption Level selected:**
-Ask which level (1/2/3), then:
 ```bash
-uds config --type level
+uds configure --type level
 ```
 
 **If Content Mode selected:**
-Ask which mode (full/index/minimal), then:
 ```bash
-uds config --type content_mode
+uds configure --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 skills        # Directly manage Skills
+/config commands      # Directly manage Commands
 /config level         # Directly configure adoption level
 /config content_mode  # Directly configure content mode
 ```
 
+### Non-Interactive Installation | 非互動式安裝
+
+Use `--ai-tool` option to install Skills/Commands for a specific tool without prompts:
+
+使用 `--ai-tool` 選項為特定工具安裝 Skills/Commands，無需提示：
+
+```bash
+# Install Skills for specific tool
+uds configure --type skills --ai-tool opencode
+
+# Install Commands for specific tool
+uds configure --type commands --ai-tool copilot
+```
+
 ## Configuration Types | 設定類型
 
 | Type | Description | 說明 |
 |------|-------------|------|
 | `ai_tools` | AI tool integrations | AI 工具整合 |
+| `skills` | Skills installations | Skills 安裝管理 |
+| `commands` | Commands installations | Commands 安裝管理 |
 | `level` | Adoption level (1/2/3) | 採用等級 |
 | `content_mode` | Integration file content mode | 整合檔案內容模式 |
 | `format` | AI/Human documentation format | AI/人類文件格式 |
@@ -85,8 +110,48 @@ When invoked with a specific type, skip interactive questions:
 | `merge_strategy` | Merge strategy | 合併策略 |
 | `commit_language` | Commit message language | 提交訊息語言 |
 | `test_levels` | Test levels to include | 測試層級 |
+| `methodology` | Development methodology (experimental, requires -E) | 開發方法論（實驗性） |
 | `all` | Configure all options | 設定所有選項 |
 
+## Skills Configuration | Skills 配置
+
+When selecting `skills` type, CLI shows:
+
+1. **Current Status** - Shows installed Skills for each AI tool
+2. **Declined Status** - Shows tools where user previously declined Skills
+3. **Action Menu**:
+   - Install/Update Skills
+   - Reinstall declined Skills
+   - View status only
+
+```
+Current Skills status:
+  ✓ Claude Code:
+    - User: v3.5.1
+  ○ OpenCode: Not installed
+  ⊘ Copilot: Previously declined
+
+? What would you like to do?
+❯ Install/Update Skills
+  Reinstall declined Skills
+  View status only
+  Cancel
+```
+
+## Commands Configuration | Commands 配置
+
+When selecting `commands` type, CLI shows:
+
+1. **Current Status** - Shows installed Commands for each supported tool
+2. **Declined Status** - Shows tools where user previously declined Commands
+3. **Action Menu** similar to Skills
+
+Supported tools for Commands:
+- OpenCode (`.opencode/commands/`)
+- GitHub Copilot (`.github/commands/`)
+- Gemini CLI (`.gemini/commands/`)
+- Roo Code (`.roo-code/commands/`)
+
 ## Content Mode Options | 內容模式選項
 
 | Mode | Description | 說明 |
@@ -101,11 +166,35 @@ When invoked with a specific type, skip interactive questions:
 |---------------|--------|------|
 | AI Tools (add) | Generates new integration files | 產生新的整合檔案 |
 | AI Tools (remove) | Deletes integration files | 刪除整合檔案 |
+| Skills | Installs/updates Skills to configured paths | 安裝/更新 Skills |
+| Commands | Installs/updates Commands to configured paths | 安裝/更新 Commands |
 | Level | Updates standards, regenerates integrations | 更新標準，重新產生整合 |
 | Content Mode | Regenerates all integration files | 重新產生所有整合檔案 |
 
+## Declined Features | 拒絕的功能
+
+The CLI tracks declined Skills/Commands in `manifest.declinedFeatures`:
+
+CLI 在 `manifest.declinedFeatures` 中追蹤拒絕的 Skills/Commands：
+
+- Previously declined tools won't appear in `/update` prompts
+- Use `/config skills` or `/config commands` to reinstall declined features
+- Select "Reinstall declined Skills/Commands" from the menu
+
+之前拒絕的工具不會在 `/update` 提示中出現。使用 `/config skills` 或 `/config commands` 重新安裝。
+
+## Options Reference | 選項參考
+
+| Option | Description | 說明 |
+|--------|-------------|------|
+| `--type <type>` | Configuration type | 配置類型 |
+| `--ai-tool <tool>` | Specific AI tool (non-interactive) | 特定 AI 工具（非互動式）|
+| `--yes`, `-y` | Skip confirmation prompt | 跳過確認提示 |
+| `-E`, `--experimental` | Enable experimental features | 啟用實驗性功能 |
+
 ## Reference | 參考
 
-- CLI documentation: `uds config --help`
+- CLI documentation: `uds configure --help`
 - Init command: [/init](./init.md)
 - Check command: [/check](./check.md)
+- Update command: [/update](./update.md)

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

@@ -16,70 +16,154 @@ When invoked without `--yes`, use AskUserQuestion to gather user preferences bef
 
 當不帶 `--yes` 執行時，使用 AskUserQuestion 詢問用戶偏好後再執行。
 
-### Step 1: Ask Adoption Level | 步驟 1：詢問採用層級
+### Step 1: Detect Project | 步驟 1：偵測專案
 
-Use AskUserQuestion with these options:
+First, CLI automatically detects project characteristics:
+- Languages (JavaScript, TypeScript, Python, Go, etc.)
+- Frameworks (React, Vue, Express, etc.)
+- AI Tools (Claude Code, Cursor, Copilot, etc.)
+
+首先，CLI 會自動偵測專案特性。
+
+### Step 2: Ask AI Tools Selection | 步驟 2：詢問 AI 工具選擇
+
+Use AskUserQuestion with multiSelect to ask which AI tools to configure:
+
+使用 AskUserQuestion（多選）詢問要配置哪些 AI 工具：
+
+| AI Tool | Integration File | Skills Support | Commands Support |
+|---------|-----------------|----------------|------------------|
+| **Claude Code** | `CLAUDE.md` | ✅ | ❌ |
+| **Cursor** | `.cursorrules` | ✅ | ❌ |
+| **Windsurf** | `.windsurfrules` | ✅ | ❌ |
+| **Cline** | `.clinerules` | ✅ | ❌ |
+| **GitHub Copilot** | `.github/copilot-instructions.md` | ✅ | ✅ |
+| **OpenCode** | `AGENTS.md` | ✅ | ✅ |
+| **Gemini CLI** | `GEMINI.md` | ✅ | ✅ |
+| **Codex** | `AGENTS.md` | ✅ | ❌ |
+| **Antigravity** | `INSTRUCTIONS.md` | ✅ | ❌ |
+
+Pre-select tools detected in the environment. Note: Codex and OpenCode share `AGENTS.md`.
+
+預選環境中偵測到的工具。注意：Codex 和 OpenCode 共用 `AGENTS.md`。
+
+### Step 3: Ask Skills Installation | 步驟 3：詢問 Skills 安裝
+
+For tools that support Skills, use AskUserQuestion:
+
+對於支援 Skills 的工具，使用 AskUserQuestion：
+
+| Option | Description |
+|--------|-------------|
+| **Plugin Marketplace** | Auto-updates, recommended for Claude Code |
+| **Project Level** | Install to `.claude/skills/`, `.opencode/skill/`, etc. |
+| **User Level** | Install to `~/.claude/skills/`, `~/.opencode/skill/`, etc. |
+| **Skip** | Don't install Skills |
+
+### Step 4: Ask Commands Installation | 步驟 4：詢問 Commands 安裝
+
+For tools that support Commands (OpenCode, Copilot, Gemini CLI, Roo Code), use AskUserQuestion with multiSelect:
+
+對於支援 Commands 的工具，使用多選介面：
+
+```
+? Select AI tools to install slash commands for:
+❯ ◉ OpenCode (.opencode/commands/)
+  ◉ GitHub Copilot (.github/commands/)
+  ◉ Gemini CLI (.gemini/commands/)
+  ──────────────
+  ◯ Skip Commands installation
+```
+
+### Step 5: Ask Standards Scope | 步驟 5：詢問標準範圍
+
+Use AskUserQuestion:
+
+| Option | Description |
+|--------|-------------|
+| **Minimal (Recommended with Skills)** | Reference-only standards; Skills handle the rest |
+| **Full** | Include all standards as local files |
+
+### Step 6: Ask Adoption Level | 步驟 6：詢問採用層級
+
+Use AskUserQuestion:
 
 | Option | Description |
 |--------|-------------|
-| **Recommended (Level 2)** | Professional quality for teams (Recommended) |
 | **Essential (Level 1)** | Minimum viable standards for small projects |
+| **Recommended (Level 2)** | Professional quality for teams (Recommended) |
 | **Enterprise (Level 3)** | Comprehensive for regulated/enterprise projects |
 
-### Step 2: Ask Skills Location | 步驟 2：詢問 Skills 安裝位置
+### Step 7: Ask Standards Format | 步驟 7：詢問標準格式
 
-Use AskUserQuestion with these options:
+Use AskUserQuestion:
 
 | 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 |
+| **AI (Compact)** | Optimized for AI consumption (Recommended) |
+| **Human (Detailed)** | Readable format for humans |
+| **Both** | Generate both formats |
+
+### Step 8: Ask Standard Options | 步驟 8：詢問標準選項
+
+Based on adoption level, ask for:
+- **Git Workflow**: github-flow, gitflow, trunk-based
+- **Merge Strategy**: squash, merge, rebase
+- **Commit Language**: english, traditional-chinese, bilingual
+- **Test Levels**: unit-testing, integration-testing, e2e-testing
 
-### Step 3: Ask AI Tools Selection | 步驟 3：詢問 AI 工具選擇
+### Step 9: Ask Language Extensions | 步驟 9：詢問語言擴展
 
-Use AskUserQuestion with multiSelect to ask which AI tools to install Skills/Commands for:
+If languages detected, ask whether to include language-specific standards:
+- C# Style Guide
+- PHP Style Guide
+- etc.
 
-使用 AskUserQuestion（多選）詢問要為哪些 AI 工具安裝 Skills/Commands：
+### Step 10: Ask Framework Extensions | 步驟 10：詢問框架擴展
+
+If frameworks detected, ask whether to include framework-specific patterns:
+- Fat-Free Patterns
+- etc.
+
+### Step 11: Ask Locale | 步驟 11：詢問地區設定
+
+Use AskUserQuestion:
 
 | Option | Description |
 |--------|-------------|
-| **Claude Code** | Install Skills for Claude Code |
-| **OpenCode** | Install Skills + Commands for OpenCode |
-| **GitHub Copilot** | Install Skills + Commands for Copilot |
-| **Gemini CLI** | Install Skills + Commands for Gemini CLI |
-| **Skip** | Don't install for any tool |
+| **English (Default)** | English documentation |
+| **Traditional Chinese** | 繁體中文文件 |
 
-Note: Only show options for tools that are detected in the environment or commonly used.
+### Step 12: Ask Content Mode | 步驟 12：詢問內容模式
 
-### Step 4: Execute | 步驟 4：執行
+Use AskUserQuestion for integration file content:
 
-After collecting answers, execute initialization and tool-specific installations:
-
-收集答案後，執行初始化和工具特定的安裝：
+| Option | Description |
+|--------|-------------|
+| **Index (Recommended)** | Standards index with compliance instructions |
+| **Full** | Embed all standards in integration files |
+| **Minimal** | Only core rules embedded |
 
-**Initialize standards:**
-```bash
-uds init --level <level> --skills-location <location> --yes
-```
+### Step 13: Confirm and Execute | 步驟 13：確認並執行
 
-**Install for selected AI tools:**
-```bash
-# For each selected tool
-uds configure --type skills --ai-tool <tool>
-uds configure --type commands --ai-tool <tool>  # if tool supports commands
-```
+Show configuration summary and confirm before executing.
 
-Explain the results and next steps to the user.
+After confirmation, CLI executes all installations in one operation:
+- Copies standards to `.standards/`
+- Generates integration files
+- Installs Skills (if selected)
+- Installs Commands (if selected)
+- Creates `manifest.json`
 
 ## 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
+/init --yes                    # Use all defaults
+/init --level 2 --yes          # Specific level with defaults
+/init --skills-location none   # No Skills installation
+/init --content-mode index     # Specific content mode
 ```
 
 ## Options Reference | 選項參考
@@ -89,26 +173,31 @@ When invoked with `--yes` or specific options, skip interactive questions:
 | `--yes`, `-y` | Non-interactive mode | 非互動模式 |
 | `--level N` | Adoption level (1, 2, or 3) | 採用層級 |
 | `--skills-location` | marketplace, user, project, or none | Skills 位置 |
+| `--content-mode` | full, index, or minimal | 內容模式 |
 | `--format` | ai, human, or both | 格式 |
+| `-E`, `--experimental` | Enable experimental features (methodology) | 啟用實驗性功能 |
 
 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 | 企業級完整標準 |
+| Level | Name | Standards Count | Description | 說明 |
+|-------|------|-----------------|-------------|------|
+| 1 | Essential | 8 | Minimum viable standards | 最基本的標準 |
+| 2 | Recommended | 12 | Professional quality for teams | 團隊專業品質標準 |
+| 3 | Enterprise | 16 | Comprehensive for regulated projects | 企業級完整標準 |
 
 ## What Gets Installed | 安裝內容
 
 - `.standards/` directory with core standards
-- Integration files (`.cursorrules`, `CLAUDE.md`, etc.)
+- Integration files (`CLAUDE.md`, `.cursorrules`, etc.)
 - Skills (via Plugin Marketplace or local installation)
+- Commands (for supported AI tools)
 - `manifest.json` for tracking installation
 
 ## Reference | 參考
 
 - CLI documentation: `uds init --help`
 - Adoption guide: [ADOPTION-GUIDE.md](../../../adoption/ADOPTION-GUIDE.md)
+- Check command: [/check](./check.md)
+- Update command: [/update](./update.md)

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

@@ -77,7 +77,7 @@ Always include **Skip** option: Don't update at this time.
 - Option 1: "更新至 Beta (建議)" - "更新標準至 3.5.1-beta.15 版本（🟡 功能大致完成）"
 - Option 2: "暫時跳過" - "目前不進行更新，維持現有版本"
 
-### Step 3: Execute | 步驟 3：執行
+### Step 3: Execute Update | 步驟 3：執行更新
 
 **If Update Now selected:**
 ```bash
@@ -89,39 +89,93 @@ uds update --yes
 uds update --beta --yes
 ```
 
-### Step 4: Install Skills/Commands | 步驟 4：安裝 Skills/Commands
+### Step 4: Check Skills/Commands Status | 步驟 4：檢查 Skills/Commands 狀態
 
-After update completes, check if Skills/Commands need installation.
+After update completes, the CLI automatically detects missing or outdated Skills/Commands.
 
-更新完成後，檢查是否需要安裝 Skills/Commands。
+更新完成後，CLI 會自動偵測缺少或過時的 Skills/Commands。
 
-**Check installation status:**
+**Important:** The CLI uses file-based detection (`getInstalledSkillsInfoForAgent`) to check actual installation status, not just manifest records.
 
-1. Read `.standards/manifest.json` to get `aiTools` list and `skills.installed` status
-2. Check if Skills are installed for each configured AI tool
-3. Check if Commands are installed for tools that support them (opencode, copilot, gemini-cli, roo-code)
+**重要：** CLI 使用檔案實際存在檢測，而非僅讀取 manifest 記錄。
 
-**If missing Skills/Commands detected**, use AskUserQuestion:
+#### Handling Missing Skills | 處理缺少的 Skills
+
+If missing Skills are detected for configured AI tools, CLI shows checkbox selection:
+
+如果偵測到已配置 AI 工具缺少 Skills，CLI 會顯示多選介面：
+
+```
+Skills not yet installed for these AI tools:
+  • Claude Code
+  • OpenCode
+
+? Select AI tools to install Skills for: (Press <space> to select)
+❯ ◯ Claude Code
+  ◯ OpenCode
+  ──────────────
+  ◯ Skip Skills installation
+```
+
+**After tool selection, prompt for installation level:**
 
 | Option | Description |
 |--------|-------------|
-| **Install All (Recommended)** | Install Skills + Commands for all configured tools |
-| **Skills Only** | Install only Skills |
-| **Commands Only** | Install only Commands |
-| **Skip** | Don't install at this time |
+| **Project level** | Install to `.claude/skills/`, `.opencode/skill/`, etc. |
+| **User level** | Install to `~/.claude/skills/`, `~/.opencode/skill/`, etc. |
+
+#### Handling Outdated Skills | 處理過時的 Skills
+
+If installed Skills have older version than latest, CLI shows update prompt:
+
+如果已安裝的 Skills 版本比最新版本舊，CLI 會顯示更新提示：
+
+```
+Skills updates available for these AI tools:
+  • Claude Code (project: .claude/skills/)
+      3.4.0 → 3.5.1
+
+? Select AI tools to update Skills for: (Press <space> to select)
+❯ ◉ Claude Code (project) 3.4.0 → 3.5.1
+  ──────────────
+  ◯ Skip Skills update
+```
+
+#### Handling Missing Commands | 處理缺少的 Commands
+
+Similar checkbox selection for Commands:
+
+```
+Slash commands not yet installed for these AI tools:
+  • OpenCode → .opencode/commands/
+  • GitHub Copilot → .github/commands/
+
+? Select AI tools to install Commands for: (Press <space> to select)
+❯ ◉ OpenCode (.opencode/commands/)
+  ◉ GitHub Copilot (.github/commands/)
+  ──────────────
+  ◯ Skip Commands installation
+```
 
-**Based on user selection, execute:**
+#### Declined Features Handling | 拒絕功能處理
 
-| Selection | Command |
-|-----------|---------|
-| Install All | `uds configure --type skills --ai-tool <tool>` for each tool, then `uds configure --type commands --ai-tool <tool>` |
-| Skills Only | `uds configure --type skills --ai-tool <tool>` for each tool |
-| Commands Only | `uds configure --type commands --ai-tool <tool>` for each tool |
-| Skip | No action needed |
+**Important:** The CLI tracks user's declined choices in `manifest.declinedFeatures`.
 
-**Note**: The `--ai-tool` option allows non-interactive installation for specific tools.
+**重要：** CLI 會在 `manifest.declinedFeatures` 中追蹤用戶拒絕的選項。
 
-Explain the results and any next steps to the user.
+- Tools that user previously declined will NOT be shown in subsequent prompts
+- Users can reinstall declined features via `/config skills` or `/config commands`
+- Declining is remembered per-tool (e.g., declining Skills for OpenCode doesn't affect Claude Code)
+
+用戶之前拒絕的工具不會在後續提示中顯示。可透過 `/config skills` 或 `/config commands` 重新安裝。
+
+### Step 5: Explain Results | 步驟 5：說明結果
+
+After all operations complete, explain:
+1. What was updated (standards version, file count)
+2. Skills/Commands installation results
+3. Any errors encountered
+4. Next steps (restart AI tool if Skills were installed)
 
 ## Quick Mode | 快速模式
 
@@ -131,8 +185,12 @@ When invoked with `--yes` or specific options, skip interactive questions:
 /update --yes           # Update without confirmation
 /update --beta --yes    # Update to beta version
 /update --offline       # Skip npm registry check
+/update --skills        # Update Skills only
+/update --commands      # Update Commands only
 ```
 
+**Note:** In `--yes` mode, CLI shows hints about available Skills/Commands but does NOT auto-install them (conservative behavior).
+
 ## Options Reference | 選項參考
 
 | Option | Description | 說明 |
@@ -140,12 +198,17 @@ When invoked with `--yes` or specific options, skip interactive questions:
 | `--yes`, `-y` | Skip confirmation prompt | 跳過確認提示 |
 | `--offline` | Skip npm registry check | 跳過 npm registry 檢查 |
 | `--beta` | Check for beta version updates | 檢查 beta 版本更新 |
+| `--skills` | Update Skills only | 僅更新 Skills |
+| `--commands` | Update Commands only | 僅更新 Commands |
+| `--integrations-only` | Regenerate integration files only | 僅重新產生整合檔案 |
+| `--sync-refs` | Sync integration file references | 同步整合檔案參考 |
+| `--standards-only` | Update standards without integrations | 僅更新標準，不更新整合 |
 
 ## What Gets Updated | 更新內容
 
 - Standard files in `.standards/` directory
 - Extension files (language, framework, locale)
-- Integration files (`.cursorrules`, etc.)
+- Integration files (`.cursorrules`, `CLAUDE.md`, etc.)
 - Version info in `manifest.json`
 
 ## Skills Update | Skills 更新
@@ -166,7 +229,11 @@ Skills are managed separately:
 **"Already up to date"**
 - No action needed; standards are current
 
+**"Skills previously declined"**
+- Run `/config skills` to reinstall declined Skills
+
 ## Reference | 參考
 
 - CLI documentation: `uds update --help`
 - Check command: [/check](./check.md)
+- Config command: [/config](./config.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "3.5.1-beta.18",
+  "version": "3.5.1-beta.19",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.5.1-beta.18",
+  "version": "3.5.1-beta.19",
   "lastUpdated": "2026-01-19",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -48,14 +48,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "3.5.1-beta.18"
+      "version": "3.5.1-beta.19"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills/claude-code",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code",
-      "version": "3.5.1-beta.18",
+      "version": "3.5.1-beta.19",
       "note": "Skills are now included in the main repository under skills/"
     }
   },