create-dwy 0.15.0 → 0.16.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # create-dwy
 
+## 0.16.1
+
+### Patch Changes
+
+- 交互同步每一步选项支持关键字搜索（Skills / Rules / Commands / Hooks、平台选择、陈旧项删除、导航与汇总确认）。
+- 选项说明改为列表下方固定「说明」公共区展示当前聚焦项完整描述，不再跟在选项行尾导致截断错乱。
+- 新增 `src/searchable-select.js`（基于 `@clack/core` AutocompletePrompt 自定义 render）；`@clack/prompts` 下限抬至 `^1.7.0`，显式依赖 `@clack/core`。
+
+## 0.16.0
+
+### Minor Changes
+
+- `dwy` 开头自动检测更新全局外部 skill：未装 / 清单变更（cli 加了 skill 或改了 tag）才联网重装，已装且清单一致零开销；失败不阻塞 sync。用户无需再另记 `dwy skills install`。
+- 新增 `dwy-commercial` 商业分析 skill（立项阶段 validate 之后、poc 之前）：商业模式 / 变现路径 / 定价 / 单位经济（CAC/LTV/毛利/回本）/ GTM 获客 + 商业可行性结论；startup 模式为硬闸门、builder 模式跳过。包装 pm-skills 的 `business-model` / `monetization-strategy` / `pricing-strategy` / `startup-canvas` / `porters-five-forces` + `gtm-strategy`。
+- `dwy skills install` 降级为隐藏的强制刷新兜底（向后兼容保留，日常无需手动）；`printHelp` 只露 `dwy` 主入口，`dwy sync` 为别名。
+
 ## 0.15.0
 
 ### Minor Changes

package/bin/index.js

@@ -15,14 +15,16 @@ function printHelp() {
     `dwy ${pkg.version}`,
     '',
     'Usage:',
-    '  dwy               运行交互式同步',
-    '  dwy sync          运行交互式同步',
-    '  dwy skills install  安装/更新全局外部 skill 到 ~/.dwy/skills/',
+    '  dwy               运行交互式同步（自动更新全局外部 skill）',
     '  dwy --help        显示本说明',
     '  dwy -h            显示本说明',
     '  dwy --version     显示当前版本',
     '  dwy -V            显示当前版本',
     '',
+    '以下为隐藏命令（向后兼容保留，日常无需手动调用）：',
+    '  dwy sync          同上的别名',
+    '  dwy skills install  强制刷新全局外部 skill',
+    '',
   ]
   console.log(lines.join('\n'))
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "项目脚手架与多平台 AI 配置同步工具",
   "type": "module",
   "bin": {
@@ -28,7 +28,8 @@
   "license": "MIT",
   "author": "dwydev",
   "dependencies": {
-    "@clack/prompts": "^1.5.1",
+    "@clack/core": "^1.4.3",
+    "@clack/prompts": "^1.7.0",
     "handlebars": "^4.7.0",
     "fs-extra": "^11.0.0",
     "chalk": "^5.0.0"

package/src/searchable-select.js

@@ -0,0 +1,419 @@
+/**
+ * 可搜索选择器：列表不展示 hint，底部固定「说明」公共区展示当前聚焦项描述。
+ *
+ * 基于 @clack/core AutocompletePrompt 自定义 render，绕过 prompts 默认「hint 跟在聚焦行后」行为。
+ */
+
+import { AutocompletePrompt, getColumns, settings } from '@clack/core'
+import { limitOptions } from '@clack/prompts'
+import { styleText } from 'node:util'
+import process from 'node:process'
+
+/** 是否支持 unicode 符号（与 clack prompts 判定一致） */
+function isUnicodeSupported() {
+  if (process.platform !== 'win32') {
+    return process.env.TERM !== 'linux'
+  }
+  return Boolean(process.env.CI)
+    || Boolean(process.env.WT_SESSION)
+    || Boolean(process.env.TERMINUS_SUBLIME)
+    || process.env.ConEmuTask === '{cmd::Cmder}'
+    || process.env.TERM_PROGRAM === 'Terminus-Sublime'
+    || process.env.TERM_PROGRAM === 'vscode'
+    || process.env.TERM === 'xterm-256color'
+    || process.env.TERM === 'alacritty'
+    || process.env.TERMINAL_EMULATOR === 'JetBrains-JediTerm'
+}
+
+const unicode = isUnicodeSupported()
+const unicodeOr = (c, fallback) => (unicode ? c : fallback)
+
+const S_STEP_ACTIVE = unicodeOr('◆', '*')
+const S_STEP_CANCEL = unicodeOr('■', 'x')
+const S_STEP_ERROR = unicodeOr('▲', 'x')
+const S_STEP_SUBMIT = unicodeOr('◇', 'o')
+const S_BAR = unicodeOr('│', '|')
+const S_BAR_END = unicodeOr('└', '—')
+const S_RADIO_ACTIVE = unicodeOr('●', '>')
+const S_RADIO_INACTIVE = unicodeOr('○', ' ')
+const S_CHECKBOX_SELECTED = unicodeOr('◼', '[+]')
+const S_CHECKBOX_INACTIVE = unicodeOr('◻', '[ ]')
+
+/** 底部说明区固定行数，避免列表高度随描述长短跳动 */
+const DESC_PANEL_LINES = 3
+
+/** 搜索框默认 placeholder */
+export const SEARCH_PLACEHOLDER = '输入关键字筛选…'
+
+/**
+ * 按状态返回步骤符号。
+ * @param {string} state
+ */
+function symbol(state) {
+  switch (state) {
+    case 'cancel':
+      return styleText('red', S_STEP_CANCEL)
+    case 'error':
+      return styleText('yellow', S_STEP_ERROR)
+    case 'submit':
+      return styleText('green', S_STEP_SUBMIT)
+    default:
+      return styleText('cyan', S_STEP_ACTIVE)
+  }
+}
+
+/**
+ * 默认过滤：匹配 label / value / description。
+ * @param {string} search
+ * @param {{ value: unknown, label?: string, description?: string, hint?: string }} opt
+ */
+function defaultFilter(search, opt) {
+  if (!search) return true
+  const q = search.toLowerCase()
+  const label = (opt.label ?? String(opt.value ?? '')).toLowerCase()
+  const desc = (opt.description ?? opt.hint ?? '').toLowerCase()
+  const value = String(opt.value ?? '').toLowerCase()
+  return label.includes(q) || desc.includes(q) || value.includes(q)
+}
+
+/**
+ * 取选项展示文案。
+ * @param {{ label?: string, value?: unknown }} opt
+ */
+function optionLabel(opt) {
+  return opt.label ?? String(opt.value ?? '')
+}
+
+/**
+ * 按终端宽度硬换行（中日文按字符计，足够 CLI 展示）。
+ * @param {string} text
+ * @param {number} width
+ * @returns {string[]}
+ */
+function wrapHard(text, width) {
+  if (!text) return []
+  const w = Math.max(width, 8)
+  const lines = []
+  let row = ''
+  for (const ch of text) {
+    if (ch === '\n') {
+      lines.push(row)
+      row = ''
+      continue
+    }
+    if (row.length >= w) {
+      lines.push(row)
+      row = ch
+    } else {
+      row += ch
+    }
+  }
+  if (row) lines.push(row)
+  return lines
+}
+
+/**
+ * 构建底部固定高度说明区。
+ * 无描述时用占位，保证行数恒定。
+ *
+ * @param {string | undefined} description 当前聚焦项完整描述
+ * @param {string} barPrefix 左侧竖线前缀（含颜色）
+ * @param {number} contentWidth 可写字符宽
+ * @returns {string[]}
+ */
+function buildDescPanel(description, barPrefix, contentWidth) {
+  const raw = (description && description.trim()) ? description.trim() : '（无说明）'
+  const wrapped = wrapHard(raw, contentWidth)
+  // 固定 DESC_PANEL_LINES 行：超出截断末行加省略，不足补空
+  const lines = []
+  for (let i = 0; i < DESC_PANEL_LINES; i++) {
+    let part = wrapped[i] ?? ''
+    if (i === DESC_PANEL_LINES - 1 && wrapped.length > DESC_PANEL_LINES) {
+      const ellipsis = '…'
+      part = (wrapped[i] ?? '').slice(0, Math.max(contentWidth - ellipsis.length, 0)) + ellipsis
+    }
+    if (i === 0) {
+      lines.push(`${barPrefix}${styleText('dim', '说明：')}${styleText('dim', part)}`)
+    } else {
+      // 续行缩进对齐「说明：」四字宽
+      lines.push(`${barPrefix}${styleText('dim', '      ')}${styleText('dim', part)}`)
+    }
+  }
+  return lines
+}
+
+/**
+ * 从 options 中取 focusedValue 对应项的 description。
+ * @param {Array<{ value: unknown, description?: string, hint?: string }>} options
+ * @param {unknown} focusedValue
+ */
+function resolveDescription(options, focusedValue) {
+  if (focusedValue === undefined) return undefined
+  const hit = options.find(o => o.value === focusedValue)
+  return hit?.description ?? hit?.hint
+}
+
+/**
+ * 可搜索多选：列表无行内 hint，底部公共区展示当前项说明。
+ *
+ * @param {object} opts
+ * @param {string} opts.message
+ * @param {Array<{ value: unknown, label?: string, description?: string, disabled?: boolean }>} opts.options
+ * @param {unknown[]} [opts.initialValues]
+ * @param {boolean} [opts.required]
+ * @param {number} [opts.maxItems]
+ * @param {string} [opts.placeholder]
+ * @param {(search: string, opt: object) => boolean} [opts.filter]
+ * @returns {Promise<unknown[] | symbol>}
+ */
+export function searchableMultiselect(opts) {
+  const withGuide = opts.withGuide ?? settings.withGuide
+  const placeholder = opts.placeholder ?? SEARCH_PLACEHOLDER
+  const filter = opts.filter ?? defaultFilter
+
+  const prompt = new AutocompletePrompt({
+    options: opts.options,
+    multiple: true,
+    placeholder,
+    filter,
+    initialValue: opts.initialValues,
+    signal: opts.signal,
+    input: opts.input,
+    output: opts.output,
+    validate: () => {
+      if (opts.required && prompt.selectedValues.length === 0) {
+        return '请至少选择一项'
+      }
+    },
+    render() {
+      const msgLine = `${withGuide ? `${styleText('gray', S_BAR)}\n` : ''}${symbol(this.state)}  ${opts.message}\n`
+      const userInput = this.userInput
+      const isPlaceholder = userInput === '' && placeholder !== undefined
+      const searchDisplay = this.isNavigating || isPlaceholder
+        ? styleText('dim', isPlaceholder ? placeholder : userInput)
+        : this.userInputWithCursor
+      const matchHint = this.filteredOptions.length !== this.options.length
+        ? styleText('dim', ` (${this.filteredOptions.length} match${this.filteredOptions.length === 1 ? '' : 'es'})`)
+        : ''
+
+      if (this.state === 'submit') {
+        return `${msgLine}${withGuide ? `${styleText('gray', S_BAR)}  ` : ''}${styleText(
+          'dim',
+          `已选 ${this.selectedValues.length} 项`,
+        )}`
+      }
+      if (this.state === 'cancel') {
+        return `${msgLine}${withGuide ? `${styleText('gray', S_BAR)}  ` : ''}${styleText(
+          ['strikethrough', 'dim'],
+          userInput,
+        )}`
+      }
+
+      const barColor = this.state === 'error' ? 'yellow' : 'cyan'
+      const bar = withGuide ? `${styleText(barColor, S_BAR)}  ` : ''
+      const barEnd = withGuide ? styleText(barColor, S_BAR_END) : ''
+      const noMatch = this.filteredOptions.length === 0 && userInput
+        ? [`${bar}${styleText('yellow', '无匹配项')}`]
+        : []
+      const errLines = this.state === 'error'
+        ? [`${bar}${styleText('yellow', this.error)}`]
+        : []
+
+      const header = [
+        ...`${msgLine}${withGuide ? styleText(barColor, S_BAR) : ''}`.split('\n'),
+        `${bar}${styleText('dim', 'Search:')} ${searchDisplay}${matchHint}`,
+        ...noMatch,
+        ...errLines,
+      ]
+
+      // 底部：说明区 + 快捷键（说明区行数固定，计入 rowPadding）
+      const cols = getColumns(opts.output ?? process.stdout)
+      const contentWidth = Math.max(cols - (withGuide ? 10 : 6), 20)
+      const descPanel = buildDescPanel(
+        resolveDescription(this.filteredOptions, this.focusedValue),
+        bar,
+        contentWidth,
+      )
+      const instructions = [
+        `${styleText('dim', '↑/↓')} to navigate`,
+        `${styleText('dim', this.isNavigating ? 'Space/Tab:' : 'Tab:')} select`,
+        `${styleText('dim', 'Enter:')} confirm`,
+        `${styleText('dim', 'Type:')} to search`,
+      ]
+      const footer = [
+        `${bar}${styleText('dim', S_BAR_H())}`,
+        ...descPanel,
+        `${bar}${instructions.join(' · ')}`,
+        barEnd,
+      ].filter(Boolean)
+
+      const listLines = this.filteredOptions.length === 0
+        ? []
+        : limitOptions({
+          cursor: this.cursor,
+          options: this.filteredOptions,
+          maxItems: opts.maxItems,
+          output: opts.output,
+          rowPadding: header.length + footer.length,
+          style: (opt, active) => {
+            const selected = this.selectedValues.includes(opt.value)
+            const label = optionLabel(opt)
+            const box = selected
+              ? styleText('green', S_CHECKBOX_SELECTED)
+              : styleText('dim', S_CHECKBOX_INACTIVE)
+            if (opt.disabled) {
+              return `${styleText('gray', S_CHECKBOX_INACTIVE)} ${styleText(['strikethrough', 'gray'], label)}`
+            }
+            // 聚焦也不拼 hint，描述只在底部公共区
+            if (active) {
+              return `${box} ${label}`
+            }
+            return `${box} ${styleText('dim', label)}`
+          },
+        })
+
+      return [
+        ...header,
+        ...listLines.map(line => `${bar}${line}`),
+        ...footer,
+      ].join('\n')
+    },
+  })
+
+  return prompt.prompt()
+}
+
+/** 横线字符（与 clack 一致） */
+function S_BAR_H() {
+  return unicodeOr('─', '-')
+}
+
+/**
+ * 可搜索单选：列表无行内 hint，底部公共区展示当前项说明。
+ *
+ * @param {object} opts
+ * @param {string} opts.message
+ * @param {Array<{ value: unknown, label?: string, description?: string, disabled?: boolean }>} opts.options
+ * @param {unknown} [opts.initialValue]
+ * @param {number} [opts.maxItems]
+ * @param {string} [opts.placeholder]
+ * @param {(search: string, opt: object) => boolean} [opts.filter]
+ * @returns {Promise<unknown | symbol>}
+ */
+export function searchableSelect(opts) {
+  const withGuide = opts.withGuide ?? settings.withGuide
+  const placeholder = opts.placeholder ?? SEARCH_PLACEHOLDER
+  const filter = opts.filter ?? defaultFilter
+
+  const prompt = new AutocompletePrompt({
+    options: opts.options,
+    multiple: false,
+    placeholder,
+    filter,
+    initialValue: opts.initialValue !== undefined ? [opts.initialValue] : undefined,
+    signal: opts.signal,
+    input: opts.input,
+    output: opts.output,
+    validate: opts.validate,
+    render() {
+      const headerBase = withGuide
+        ? [`${styleText('gray', S_BAR)}`, `${symbol(this.state)}  ${opts.message}`]
+        : [`${symbol(this.state)}  ${opts.message}`]
+      const userInput = this.userInput
+      const isPlaceholder = userInput === '' && placeholder !== undefined
+      let searchDisplay = ''
+      if (this.isNavigating || isPlaceholder) {
+        const d = isPlaceholder ? placeholder : userInput
+        searchDisplay = d !== '' ? ` ${styleText('dim', d)}` : ''
+      } else {
+        searchDisplay = ` ${this.userInputWithCursor}`
+      }
+      const matchHint = this.filteredOptions.length !== this.options.length
+        ? styleText(
+          'dim',
+          ` (${this.filteredOptions.length} match${this.filteredOptions.length === 1 ? '' : 'es'})`,
+        )
+        : ''
+
+      if (this.state === 'submit') {
+        const selected = this.filteredOptions.find(o => o.value === this.focusedValue)
+          ?? opts.options.find(o => o.value === this.focusedValue)
+        const text = selected ? optionLabel(selected) : ''
+        const body = text ? `  ${styleText('dim', text)}` : ''
+        const bar = withGuide ? styleText('gray', S_BAR) : ''
+        return `${headerBase.join('\n')}\n${bar}${body}`
+      }
+      if (this.state === 'cancel') {
+        const body = userInput ? `  ${styleText(['strikethrough', 'dim'], userInput)}` : ''
+        const bar = withGuide ? styleText('gray', S_BAR) : ''
+        return `${headerBase.join('\n')}\n${bar}${body}`
+      }
+
+      const barColor = this.state === 'error' ? 'yellow' : 'cyan'
+      const bar = withGuide ? `${styleText(barColor, S_BAR)}  ` : ''
+      const barEnd = withGuide ? styleText(barColor, S_BAR_END) : ''
+      const noMatch = this.filteredOptions.length === 0 && userInput
+        ? [`${bar}${styleText('yellow', '无匹配项')}`]
+        : []
+      const errLines = this.state === 'error'
+        ? [`${bar}${styleText('yellow', this.error)}`]
+        : []
+
+      const header = [...headerBase]
+      if (withGuide) header.push(`${bar.trimEnd()}`)
+      header.push(
+        `${bar}${styleText('dim', 'Search:')}${searchDisplay}${matchHint}`,
+        ...noMatch,
+        ...errLines,
+      )
+
+      const cols = getColumns(opts.output ?? process.stdout)
+      const contentWidth = Math.max(cols - (withGuide ? 10 : 6), 20)
+      const descPanel = buildDescPanel(
+        resolveDescription(this.filteredOptions, this.focusedValue),
+        bar,
+        contentWidth,
+      )
+      const instructions = [
+        `${styleText('dim', '↑/↓')} to select`,
+        `${styleText('dim', 'Enter:')} confirm`,
+        `${styleText('dim', 'Type:')} to search`,
+      ]
+      const footer = [
+        `${bar}${styleText('dim', S_BAR_H())}`,
+        ...descPanel,
+        `${bar}${instructions.join(' · ')}`,
+        barEnd,
+      ].filter(Boolean)
+
+      const listLines = this.filteredOptions.length === 0
+        ? []
+        : limitOptions({
+          cursor: this.cursor,
+          options: this.filteredOptions,
+          maxItems: opts.maxItems,
+          output: opts.output,
+          columnPadding: withGuide ? 3 : 0,
+          rowPadding: header.length + footer.length,
+          style: (opt, active) => {
+            const label = optionLabel(opt)
+            if (opt.disabled) {
+              return `${styleText('gray', S_RADIO_INACTIVE)} ${styleText(['strikethrough', 'gray'], label)}`
+            }
+            if (active) {
+              return `${styleText('green', S_RADIO_ACTIVE)} ${label}`
+            }
+            return `${styleText('dim', S_RADIO_INACTIVE)} ${styleText('dim', label)}`
+          },
+        })
+
+      return [
+        ...header,
+        ...listLines.map(line => `${bar}${line}`),
+        ...footer,
+      ].join('\n')
+    },
+  })
+
+  return prompt.prompt()
+}

package/src/skills-install.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra'
 import path from 'path'
 import os from 'node:os'
+import { createHash } from 'node:crypto'
 import { getDwyHomeDir, runGit, chalk } from './utils.js'
 
 function logAction(label) {
@@ -29,6 +30,12 @@ const SKILL_SOURCES = {
       'test-scenarios': 'pm-execution/skills/test-scenarios',
       'release-notes': 'pm-execution/skills/release-notes',
       'gtm-strategy': 'pm-go-to-market/skills/gtm-strategy',
+      // 商业分析（dwy-commercial 依赖）：商业模式 / 变现 / 定价 / 创业画布 / 赛道五力
+      'business-model': 'pm-product-strategy/skills/business-model',
+      'monetization-strategy': 'pm-product-strategy/skills/monetization-strategy',
+      'pricing-strategy': 'pm-product-strategy/skills/pricing-strategy',
+      'startup-canvas': 'pm-product-strategy/skills/startup-canvas',
+      'porters-five-forces': 'pm-product-strategy/skills/porters-five-forces',
       'intended-vs-implemented': 'pm-ai-shipping/skills/intended-vs-implemented',
       'north-star-metric': 'pm-marketing-growth/skills/north-star-metric',
     },
@@ -47,6 +54,13 @@ const SKILL_SOURCES = {
   },
 }
 
+// 计算 SKILL_SOURCES 清单的内容指纹，用于检测「cli 加了 skill / 改了 tag」→ 需重装。
+// SKILL_SOURCES 是源码内固定字面量，JSON.stringify 稳定（插入顺序固定）。
+// 取 sha256 前 12 位，足以区分任意清单变更，无碰撞风险。
+function computeManifestHash() {
+  return createHash('sha256').update(JSON.stringify(SKILL_SOURCES)).digest('hex').slice(0, 12)
+}
+
 // 全局外部 skill 安装目录：~/.dwy/skills/
 function getGlobalSkillsDir() {
   return path.join(getDwyHomeDir(), 'skills')
@@ -92,22 +106,49 @@ export async function installSkills() {
       }
     }
 
-    // 写版本清单，供查看与后续更新比对
-    await fs.writeJson(path.join(targetDir, 'VERSIONS.json'), versions, { spaces: 2 })
+    // 写版本清单 + 清单指纹，供查看与后续更新比对。
+    // manifest_hash 变化（cli 加了 skill / 改了 tag）→ 下次 ensureSkillsInstalled 触发重装。
+    await fs.writeJson(
+      path.join(targetDir, 'VERSIONS.json'),
+      { manifest_hash: computeManifestHash(), versions },
+      { spaces: 2 },
+    )
     console.log(chalk.green(`\n✓ 外部 skill 已安装到 ${targetDir}`))
   } finally {
     await fs.remove(tmpRoot)
   }
 }
 
-// 全局 skill 是否已就绪（供 sync 自检：缺则自动装）。
+// 全局 skill 是否已就绪（VERSIONS.json 存在）。
 export async function skillsInstalled() {
   return fs.pathExists(path.join(getGlobalSkillsDir(), 'VERSIONS.json'))
 }
 
+// 确保 ~/.dwy/skills/ 与 cli 当前 SKILL_SOURCES 清单一致：未装 / 清单变更 → 自动重装。
+// hash 一致 → 零开销跳过；失败 → warn 一行不阻塞主流程（离线/网络故障不挡 sync）。
+// 返回 true = 本次执行了安装，false = 跳过。
 export async function ensureSkillsInstalled() {
-  if (await skillsInstalled()) return false
-  console.log(chalk.gray('未检测到全局外部 skill，自动安装...'))
-  await installSkills()
-  return true
+  const versionsFile = path.join(getGlobalSkillsDir(), 'VERSIONS.json')
+  // 已装：读 manifest_hash 比对，一致即跳过，不联网
+  if (await fs.pathExists(versionsFile)) {
+    let stored
+    try {
+      stored = await fs.readJson(versionsFile)
+    } catch {
+      stored = {}
+    }
+    // 兼容老格式（无 manifest_hash）→ 视为不一致，触发一次重装补上指纹
+    if (stored.manifest_hash === computeManifestHash()) return false
+    console.log(chalk.gray('全局外部 skill 清单已更新，重新拉取...'))
+  } else {
+    console.log(chalk.gray('未检测到全局外部 skill，自动安装...'))
+  }
+  try {
+    await installSkills()
+    return true
+  } catch (error) {
+    // 离线/网络故障：不阻塞主流程，下次再来
+    console.log(chalk.yellow(`外部 skill 自动更新失败：${error.message}`))
+    return false
+  }
 }

package/src/sync-all.js

@@ -1,6 +1,7 @@
 import fs from 'fs-extra'
 import path from 'path'
-import { confirm, isCancel, multiselect } from '@clack/prompts'
+import { confirm, isCancel } from '@clack/prompts'
+import { SEARCH_PLACEHOLDER, searchableMultiselect } from './searchable-select.js'
 import { chalk } from './utils.js'
 import {
   interactiveSelect,
@@ -26,18 +27,11 @@ import { scanExistingCursorRules, syncCursor } from './sync-cursor.js'
 import { syncOpenCode } from './sync-opencode.js'
 import { ensureSkillsInstalled } from './skills-install.js'
 
-// 产品 0→1 流程里依赖全局外部 skill 的包装型原子 skill。
-// 同步选中其中任一个时，触发全局外部 skill 自检安装。
-const WRAPPER_SKILL_NAMES = new Set([
-  'dwy-ideate', 'dwy-competitor', 'dwy-validate', 'dwy-mvp', 'dwy-prd',
-  'dwy-version', 'dwy-tasks', 'dwy-tdd-dev', 'dwy-acceptance', 'dwy-release',
-])
-
 const PLATFORM_OPTIONS = [
-  { value: 'claude', label: 'Claude Code', hint: '支持 rules / skills / commands / hooks' },
-  { value: 'codex', label: 'Codex', hint: '支持 rules / skills / hooks' },
-  { value: 'cursor', label: 'Cursor', hint: '支持 rules' },
-  { value: 'opencode', label: 'OpenCode', hint: '支持 rules / skills / commands' },
+  { value: 'claude', label: 'Claude Code', description: '支持 rules / skills / commands / hooks' },
+  { value: 'codex', label: 'Codex', description: '支持 rules / skills / hooks' },
+  { value: 'cursor', label: 'Cursor', description: '支持 rules' },
+  { value: 'opencode', label: 'OpenCode', description: '支持 rules / skills / commands' },
 ]
 
 const CURSOR_BASELINE_RULE_NAME = '00-dwy-global.mdc'
@@ -159,12 +153,14 @@ async function selectPlatforms(projectDir) {
   console.log(chalk.gray('  Cursor      → rules'))
   console.log(chalk.gray('  OpenCode    → rules / skills / commands\n'))
 
-  const result = await multiselect({
+  // 可搜索多选 + 底部说明区
+  const result = await searchableMultiselect({
     message: '选择要同步的平台',
     options: PLATFORM_OPTIONS,
     initialValues,
     required: true,
     maxItems: 6,
+    placeholder: SEARCH_PLACEHOLDER,
   })
   if (isCancel(result)) return null
   return result
@@ -317,11 +313,12 @@ async function promptStaleRemovals(staleEntries) {
         console.log(chalk.gray(`  - ${name}`))
       }
 
-      const selected = await multiselect({
+      const selected = await searchableMultiselect({
         message: `选择要删除的 ${PLATFORM_LABELS[platform]} ${TYPE_LABELS[type]}`,
         options: names.map(name => ({ value: name, label: name })),
         initialValues: names,
         required: false,
+        placeholder: SEARCH_PLACEHOLDER,
       })
       if (isCancel(selected)) return null
       approvals[platform][type] = new Set(selected)
@@ -567,6 +564,12 @@ export async function syncAll({
 
   const projectDir = projectDirOverride || process.cwd()
 
+  // 开头无条件自检全局外部 skill：未装 / 清单变更（cli 加了 skill 或改了 tag）则自动更新，
+  // 已装且清单一致则零开销跳过。失败不阻塞 sync（离线/网络故障，下次再来）。
+  // 这样用户跑一次 `dwy` 就把 skill 更新到位，无需另记 `dwy skills install`。
+  console.log(chalk.gray('检查全局外部 skill 更新...'))
+  await ensureSkillsInstalled()
+
   console.log(chalk.blue('\nScanning available Claude Code/Codex configuration...\n'))
   const scans = {
     skills: await scanSkills(sourceDir),
@@ -698,17 +701,6 @@ export async function syncAll({
   }
   await saveSyncState(projectDir, syncState)
 
-  // 产品 0→1 流程的包装型原子 skill 依赖全局外部 skill（~/.dwy/skills/）。
-  // 若本次同步选中了这些 skill 且全局未安装，自动装一次（缺则装、有则跳过）。
-  if (selected.skills?.some((s) => WRAPPER_SKILL_NAMES.has(s.name))) {
-    try {
-      await ensureSkillsInstalled()
-    } catch (error) {
-      console.log(chalk.yellow(`\n外部 skill 自动安装失败：${error.message}`))
-      console.log(chalk.gray('可稍后手动运行 `dwy skills install` 重试。'))
-    }
-  }
-
   if (!syncedAnySupportedPlatform) {
     console.log(chalk.yellow('未选择已接入平台，本次未执行同步。'))
   }