universal-dev-standards 3.5.1-beta.10 → 3.5.1-beta.12

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

@@ -1,6 +1,6 @@
 ---
 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/*)
+allowed-tools: Read, Bash(uds update:*), Bash(uds check:*), Bash(uds configure:*), Bash(npx:*), Bash(cat .standards/*), Bash(ls .claude/*), Bash(ls .opencode/*), Bash(ls .github/*)
 argument-hint: "[--yes] [--offline] [--beta]"
 ---
 
@@ -42,34 +42,44 @@ uds update --yes
 uds update --beta --yes
 ```
 
-### Step 4: Check New Features | 步驟 4：檢查新功能
+### Step 4: Install Skills/Commands | 步驟 4：安裝 Skills/Commands
 
-After update completes, check if Skills/Commands need to be installed:
+The CLI automatically handles Skills/Commands installation in Step 4:
 
-更新完成後，檢查是否需要安裝 Skills/Commands：
+CLI 會自動處理 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)
+**With `--yes` flag (automatic):**
+- All missing Skills/Commands are installed automatically for configured AI tools
+- No additional action needed
 
-If `skills.installed` is `false` OR command directories are missing for supported tools, use AskUserQuestion:
+使用 `--yes` 時，會自動為所有設定的 AI 工具安裝缺少的 Skills/Commands。
 
-| 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 | 跳過 |
+**Without `--yes` (interactive):**
+- CLI shows a checkbox menu to select which AI tools to install for
+- All options are checked by default (opt-out behavior)
 
-**If Install All or Skills Only selected:**
-```bash
-uds update --skills
-```
+不使用 `--yes` 時，CLI 會顯示 checkbox 選單讓用戶選擇要安裝的 AI 工具。
 
-**If Install All or Commands Only selected:**
-```bash
-uds update --commands
+**Example checkbox interface:**
 ```
+? Select AI tools to install Skills for:
+❯◉ Claude Code
+ ◉ OpenCode
+ ◉ GitHub Copilot
+ ──────────────
+ ◯ Skip Skills installation
+```
+
+**If CLI cannot prompt (non-TTY environment):**
+
+Use AskUserQuestion and then run `uds configure`:
+
+| User Selection | Action |
+|----------------|--------|
+| **Install All** | `uds configure --type skills` then `uds configure --type commands` |
+| **Skills Only** | `uds configure --type skills` |
+| **Commands Only** | `uds configure --type commands` |
+| **Skip** | No action needed |
 
 Explain the results and any next steps to the user.
 

package/package.json

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

package/src/commands/check.js

@@ -17,9 +17,7 @@ import {
 import { downloadFromGitHub, getMarketplaceSkillsInfo } from '../utils/github.js';
 import {
   getInstalledSkillsInfoForAgent,
-  getInstalledCommandsForAgent,
-  installSkillsToMultipleAgents,
-  installCommandsToMultipleAgents
+  getInstalledCommandsForAgent
 } from '../utils/skills-installer.js';
 import {
   getAgentConfig,
@@ -261,10 +259,10 @@ export async function checkCommand(options = {}) {
     console.log(chalk.yellow(msg.issuesDetected));
   }
 
-  // Offer to install missing Skills/Commands if in interactive mode and TTY available
-  const canPrompt = !options.noInteractive && process.stdin.isTTY && process.stdout.isTTY;
-  if ((missingSkills.length > 0 || missingCommands.length > 0) && canPrompt) {
-    await promptSkillsCommandsInstallation(manifest, projectPath, missingSkills, missingCommands, msg);
+  // Show hint if Skills/Commands are missing (check is read-only, no installation)
+  if (missingSkills.length > 0 || missingCommands.length > 0) {
+    console.log();
+    console.log(chalk.cyan(msg.missingSkillsHint || 'Tip: Run `uds update` to install missing Skills/Commands'));
   }
 
   console.log();
@@ -789,171 +787,6 @@ function displaySkillsStatus(manifest, projectPath, msg) {
   return { missingSkills, missingCommands };
 }
 
-/**
- * Prompt user to install missing Skills/Commands discovered during check
- * @param {Object} manifest - The manifest object
- * @param {string} projectPath - Project path
- * @param {Array} missingSkills - Array of {agent, displayName, paths}
- * @param {Array} missingCommands - Array of {agent, displayName, path}
- * @param {Object} msg - i18n messages
- * @returns {Promise<boolean>} - Whether anything was installed
- */
-async function promptSkillsCommandsInstallation(manifest, projectPath, missingSkills, missingCommands, msg) {
-  const repoInfo = getRepositoryInfo();
-  let installedAnything = false;
-
-  // Handle missing Skills with checkbox selection
-  if (missingSkills.length > 0) {
-    console.log();
-    console.log(chalk.cyan('━'.repeat(50)));
-    console.log(chalk.cyan.bold(msg.offerSkillsInstallation || 'Skills Installation'));
-    console.log(chalk.cyan('━'.repeat(50)));
-    console.log();
-
-    // Build checkbox choices
-    const skillChoices = missingSkills.map(skill => ({
-      name: skill.displayName,
-      value: skill.agent,
-      checked: true  // Default checked for opt-out behavior
-    }));
-
-    // Add skip option
-    skillChoices.push(new inquirer.Separator());
-    skillChoices.push({
-      name: chalk.gray(msg.skipInstallation || 'Skip'),
-      value: '__skip__'
-    });
-
-    const { selectedSkillAgents } = await inquirer.prompt([{
-      type: 'checkbox',
-      name: 'selectedSkillAgents',
-      message: msg.selectSkillsToInstall || 'Select AI tools to install Skills for:',
-      choices: skillChoices,
-      validate: (answer) => {
-        if (answer.includes('__skip__') && answer.length > 1) {
-          return t().commands.update.skipValidationError || 'Cannot select Skip with other options';
-        }
-        return true;
-      }
-    }]);
-
-    const filteredSkillAgents = selectedSkillAgents.filter(a => a !== '__skip__');
-
-    if (filteredSkillAgents.length > 0) {
-      // Prompt for installation level
-      const { skillsLevel } = await inquirer.prompt([{
-        type: 'list',
-        name: 'skillsLevel',
-        message: t().commands.update.skillsLevelQuestion || 'Where should Skills be installed?',
-        choices: [
-          { name: `${t().commands.update.projectLevel || 'Project level'} (.claude/skills/, etc.)`, value: 'project' },
-          { name: `${t().commands.update.userLevel || 'User level'} (~/.claude/skills/, etc.)`, value: 'user' }
-        ],
-        default: 'project'
-      }]);
-
-      // Install Skills
-      const spinner = ora(t().commands.update.installingNewSkills || 'Installing Skills...').start();
-      const skillResult = await installSkillsToMultipleAgents(
-        filteredSkillAgents.map(agent => ({ agent, level: skillsLevel })),
-        null,
-        projectPath
-      );
-
-      // Update manifest
-      if (!manifest.skills) manifest.skills = {};
-      manifest.skills.installed = true;
-      manifest.skills.version = repoInfo.skills.version;
-      manifest.skills.installations = [
-        ...(manifest.skills.installations || []),
-        ...filteredSkillAgents.map(agent => ({ agent, level: skillsLevel }))
-      ];
-
-      if (skillResult.totalErrors === 0) {
-        spinner.succeed((msg.skillsInstalledSuccess || 'Installed Skills for {count} AI tools')
-          .replace('{count}', filteredSkillAgents.length));
-      } else {
-        spinner.warn((t().commands.update.newSkillsInstalledWithErrors || 'Installed Skills with {errors} errors')
-          .replace('{errors}', skillResult.totalErrors));
-      }
-
-      installedAnything = true;
-    }
-  }
-
-  // Handle missing Commands with checkbox selection
-  if (missingCommands.length > 0) {
-    console.log();
-    console.log(chalk.cyan('━'.repeat(50)));
-    console.log(chalk.cyan.bold(msg.offerCommandsInstallation || 'Commands Installation'));
-    console.log(chalk.cyan('━'.repeat(50)));
-    console.log();
-
-    // Build checkbox choices
-    const commandChoices = missingCommands.map(cmd => ({
-      name: `${cmd.displayName} ${chalk.gray(`(${cmd.path})`)}`,
-      value: cmd.agent,
-      checked: true  // Default checked for opt-out behavior
-    }));
-
-    // Add skip option
-    commandChoices.push(new inquirer.Separator());
-    commandChoices.push({
-      name: chalk.gray(msg.skipInstallation || 'Skip'),
-      value: '__skip__'
-    });
-
-    const { selectedCommandAgents } = await inquirer.prompt([{
-      type: 'checkbox',
-      name: 'selectedCommandAgents',
-      message: msg.selectCommandsToInstall || 'Select AI tools to install Commands for:',
-      choices: commandChoices,
-      validate: (answer) => {
-        if (answer.includes('__skip__') && answer.length > 1) {
-          return t().commands.update.skipValidationError || 'Cannot select Skip with other options';
-        }
-        return true;
-      }
-    }]);
-
-    const filteredCommandAgents = selectedCommandAgents.filter(a => a !== '__skip__');
-
-    if (filteredCommandAgents.length > 0) {
-      const spinner = ora(t().commands.update.installingNewCommands || 'Installing commands...').start();
-      const cmdResult = await installCommandsToMultipleAgents(
-        filteredCommandAgents,
-        null,
-        projectPath
-      );
-
-      // Update manifest
-      if (!manifest.commands) manifest.commands = {};
-      manifest.commands.installed = true;
-      manifest.commands.installations = [
-        ...(manifest.commands.installations || []),
-        ...filteredCommandAgents
-      ];
-
-      if (cmdResult.totalErrors === 0) {
-        spinner.succeed((msg.commandsInstalledSuccess || 'Installed commands for {count} AI tools')
-          .replace('{count}', filteredCommandAgents.length));
-      } else {
-        spinner.warn((t().commands.update.newCommandsInstalledWithErrors || 'Installed commands with {errors} errors')
-          .replace('{errors}', cmdResult.totalErrors));
-      }
-
-      installedAnything = true;
-    }
-  }
-
-  // Save manifest if anything was installed
-  if (installedAnything) {
-    writeManifest(manifest, projectPath);
-  }
-
-  return installedAnything;
-}
-
 /**
  * Display coverage report
  */

package/src/i18n/messages.js

@@ -602,7 +602,9 @@ export const messages = {
         selectCommandsToInstall: 'Select AI tools to install Commands for:',
         skipInstallation: 'Skip',
         skillsInstalledSuccess: 'Installed Skills for {count} AI tools',
-        commandsInstalledSuccess: 'Installed commands for {count} AI tools'
+        commandsInstalledSuccess: 'Installed commands for {count} AI tools',
+        // Read-only hint
+        missingSkillsHint: 'Tip: Run `uds update` to install missing Skills/Commands'
       },
 
       // init command (commands/init.js)
@@ -1440,7 +1442,9 @@ export const messages = {
         selectCommandsToInstall: '選擇要安裝斜線命令的 AI 工具：',
         skipInstallation: '跳過',
         skillsInstalledSuccess: '已為 {count} 個 AI 工具安裝 Skills',
-        commandsInstalledSuccess: '已為 {count} 個 AI 工具安裝斜線命令'
+        commandsInstalledSuccess: '已為 {count} 個 AI 工具安裝斜線命令',
+        // Read-only hint
+        missingSkillsHint: '提示：執行 `uds update` 安裝缺少的 Skills/斜線命令'
       },
 
       // init command (commands/init.js)
@@ -2181,7 +2185,9 @@ export const messages = {
         selectCommandsToInstall: '选择要安装斜线命令的 AI 工具：',
         skipInstallation: '跳过',
         skillsInstalledSuccess: '已为 {count} 个 AI 工具安装 Skills',
-        commandsInstalledSuccess: '已为 {count} 个 AI 工具安装斜线命令'
+        commandsInstalledSuccess: '已为 {count} 个 AI 工具安装斜线命令',
+        // Read-only hint
+        missingSkillsHint: '提示：执行 `uds update` 安装缺少的 Skills/斜线命令'
       },
 
       // update command

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.5.1-beta.10",
+  "version": "3.5.1-beta.12",
   "lastUpdated": "2026-01-15",
   "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.10"
+      "version": "3.5.1-beta.12"
     },
     "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.10",
+      "version": "3.5.1-beta.12",
       "note": "Skills are now included in the main repository under skills/"
     }
   },