@guozhi-fe/skills 0.1.0 → 0.2.0

package/README.md

@@ -9,14 +9,36 @@
 
 ## 首次安装
 
-在 npm 发布前，可在本仓库运行 `npm pack`，通过 `npm i -g /绝对路径/guozhi-fe-skills-0.1.0.tgz` 安装 CLI。npm 发布后可用 `npm i -g @guozhi-fe/skills`，或通过 `npx --package=@guozhi-fe/skills gzfe-skills init` 直接接入。
+可用 `npm i -g @guozhi-fe/skills` 安装已发布的 CLI，或通过 `npx --package=@guozhi-fe/skills gzfe-skills init` 直接接入。试用本地修改时，在本仓库运行 `npm ci` 和 `npm pack`，再运行 `npm i -g /绝对路径/guozhi-fe-skills-0.2.0.tgz`。
 
 ```sh
-gzfe-skills init microfrontend-memory-assessment
+gzfe-skills init
 gzfe-skills list
 ```
 
-省略技能名会安装全部技能。文件和版本记录位于当前项目的 `.agents/skills/<技能名>/`，建议一起提交到项目 Git 仓库。重复 init 会保留已安装版本。
+从 0.2.0 开始，省略技能名会打开交互列表，逐项显示技能名及 `SKILL.md` 中的简介。使用上下键移动、空格勾选、回车确认；勾选一项安装一个技能，勾选多项批量安装。按 `a` 全选或取消全选，按 `Ctrl+C` 取消。未勾选任何技能时按回车会取消安装。
+
+直接指定技能名可以跳过交互。脚本中可使用 `--all` 安装全部技能，无终端时需要显式指定技能名或 `--all`。
+
+```sh
+gzfe-skills init microfrontend-memory-assessment
+gzfe-skills init microfrontend-memory-assessment microfrontend-memory-lifecycle
+gzfe-skills init --all
+```
+
+文件和版本记录位于当前项目的 `.agents/skills/<技能名>/`，建议一起提交到项目 Git 仓库。重复 init 会保留已安装版本，未勾选的已安装技能也会保留。
+
+## 卸载
+
+不带参数运行 `uninstall` 会列出本工具管理的已安装技能，使用与 init 相同的勾选方式。也可直接指定技能名，或使用 `--all` 批量卸载。
+
+```sh
+gzfe-skills uninstall
+gzfe-skills uninstall microfrontend-memory-assessment
+gzfe-skills uninstall --all
+```
+
+卸载会移除所选技能目录及其安装记录。如果检测到本地文件有改动，会列出文件并停止。全量卸载只处理本工具管理的技能。卸载后可再次运行 `gzfe-skills init` 安装。
 
 ## 更新
 

package/bin/gzfe-skills.js

@@ -3,6 +3,10 @@ import fs from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { createHash } from 'node:crypto'
+import checkbox from '@inquirer/checkbox'
+import { parse } from 'yaml'
+import colors from 'yoctocolors-cjs'
+import wrapAnsi from 'wrap-ansi'
 
 const root = fileURLToPath(new URL('../', import.meta.url))
 const source = path.join(root, 'skills')
@@ -51,15 +55,62 @@ function stage(name, dir) {
   fs.writeFileSync(path.join(dir, marker), JSON.stringify({ name, version, files: manifest(dir) }, null, 2) + '\n')
 }
 
-function run([command, ...args]) {
+async function selectSkills(command, names) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw Error(`交互选择需要终端，请指定技能名，或使用 gzfe-skills ${command} --all。`)
+  }
+  const choices = names.map(name => {
+    const file = path.join(source, name, 'SKILL.md')
+    const frontmatter = fs.readFileSync(file, 'utf8').match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)
+    const metadata = frontmatter && parse(frontmatter[1])
+    if (typeof metadata?.description !== 'string' || !metadata.description.trim()) {
+      throw Error('技能缺少有效简介：' + file)
+    }
+    const description = metadata.description.replace(/\s+/g, ' ').trim()
+    const summary = description.match(/^[^。！？]+[。！？]?/u)?.[0] || description
+    const width = Math.max(16, Math.min(88, (process.stdout.columns || 80) - 4))
+    const lines = wrapAnsi(summary, width, { hard: true }).split('\n')
+    const detail = lines.map(line => '    ' + colors.dim(line)).join('\n')
+    return { name: `${colors.bold(name)}\n${detail}\n`, short: name, value: name }
+  })
+  return checkbox({
+    message: `选择要${command === 'init' ? '安装' : '卸载'}的技能（可单选或多选）`,
+    choices,
+    pageSize: 12,
+    theme: {
+      style: {
+        highlight: text => {
+          const [title, ...detail] = text.split('\n')
+          return [colors.cyan(title), ...detail].join('\n')
+        },
+        keysHelpTip: () => '↑↓ 移动 · 空格 勾选 · a 全选/取消全选 · 回车 确认 · Ctrl+C 取消',
+      },
+    },
+  })
+}
+
+async function run([command, ...args]) {
   if (!command || ['--help', '-h'].includes(command)) {
-    console.log('gzfe-skills init [技能名 ...] | list | update [技能名 ...] [--dry-run]\n' + catalog.join('\n'))
+    console.log([
+      'gzfe-skills init                    交互选择技能，支持单选和多选',
+      'gzfe-skills init <技能名 ...>       直接安装指定技能',
+      'gzfe-skills init --all              安装全部技能，可用于脚本',
+      'gzfe-skills list                    查看项目安装状态',
+      'gzfe-skills update [技能名 ...] [--dry-run]',
+      'gzfe-skills uninstall               交互选择要卸载的已安装技能',
+      'gzfe-skills uninstall <技能名 ...>  卸载指定技能',
+      'gzfe-skills uninstall --all         卸载本工具管理的全部技能',
+      '',
+      ...catalog,
+    ].join('\n'))
     return
   }
   if (command === '--version') return console.log(version)
-  if (!['init', 'update', 'list'].includes(command)) throw Error('未知命令：' + command)
+  if (!['init', 'update', 'list', 'uninstall'].includes(command)) throw Error('未知命令：' + command)
   const dry = command === 'update' && args.includes('--dry-run')
-  const names = [...new Set(dry ? args.filter(x => x !== '--dry-run') : args)]
+  const all = ['init', 'uninstall'].includes(command) && args.includes('--all')
+  let names = [...new Set(args.filter(x => !(dry && x === '--dry-run') && !(all && x === '--all')))]
+  if (all && names.length) throw Error('--all 不能与技能名同时使用')
   if (names.some(x => !catalog.includes(x)) || (command === 'list' && names.length)) throw Error('参数无效，请查看 --help')
   for (const dir of [path.dirname(dest), dest]) {
     const entry = fs.lstatSync(dir, { throwIfNoEntry: false })
@@ -69,12 +120,18 @@ function run([command, ...args]) {
     for (const name of catalog) console.log(name, status(name).label)
     return
   }
+  if (['init', 'uninstall'].includes(command) && !names.length) {
+    const available = command === 'uninstall' ? catalog.filter(name => status(name).saved) : catalog
+    if (!available.length) return console.log('当前项目没有由 gzfe-skills 管理的已安装技能')
+    names = all ? available : await selectSkills(command, available)
+    if (!names.length) return console.log('未选择技能，操作已取消')
+  }
   const plan = () => (names.length ? names : catalog).filter(name => {
     const state = status(name)
     if (command === 'update' && !names.length && !state.saved) return false
-    if (!state.saved && (command === 'update' || state.label !== '未安装')) throw Error(name + '：' + state.label)
+    if (!state.saved && (command !== 'init' || state.label !== '未安装')) throw Error(name + '：' + state.label)
     if (state.changes?.length) throw Error(name + ' 有本地修改：\n' + state.changes.join('\n'))
-    return !state.saved || (command === 'update' && state.saved.version !== version)
+    return command === 'uninstall' || !state.saved || (command === 'update' && state.saved.version !== version)
   })
   if (dry) {
     const selected = plan()
@@ -87,17 +144,21 @@ function run([command, ...args]) {
   let cleanup = true
   try {
     const selected = plan()
-    for (const name of selected) stage(name, path.join(work, name))
+    if (command !== 'uninstall') {
+      for (const name of selected) stage(name, path.join(work, name))
+    }
     for (const name of selected) {
       const target = path.join(dest, name)
       const backup = path.join(work, name + '.old')
       const existed = fs.existsSync(target)
       if (existed) fs.renameSync(target, backup)
       applied.push({ target, backup, existed, installed: false })
+      if (command === 'uninstall') continue
       fs.renameSync(path.join(work, name), target)
       applied.at(-1).installed = true
     }
-    console.log(selected.length ? selected.join(', ') + ' → ' + version : '无需变更')
+    const result = command === 'uninstall' ? '已卸载：' + selected.join(', ') : selected.join(', ') + ' → ' + version
+    console.log(selected.length ? result : '无需变更')
   } catch (error) {
     cleanup = false
     for (const item of applied.reverse()) {
@@ -110,7 +171,12 @@ function run([command, ...args]) {
     if (cleanup) fs.rmSync(work, { recursive: true })
   }
 }
-try { run(process.argv.slice(2)) } catch (error) {
-  console.error(error.message)
-  process.exitCode = 1
+try { await run(process.argv.slice(2)) } catch (error) {
+  if (error.name === 'ExitPromptError') {
+    console.log('操作已取消')
+    process.exitCode = 130
+  } else {
+    console.error(error.message)
+    process.exitCode = 1
+  }
 }

package/package.json

@@ -1,10 +1,26 @@
 {
   "name": "@guozhi-fe/skills",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "国智前端项目级 Codex 技能集",
   "type": "module",
-  "bin": { "gzfe-skills": "bin/gzfe-skills.js" },
-  "files": ["bin", "skills"],
-  "engines": { "node": ">=18" },
-  "repository": "github:soleilLulu/gz-fe-skills"
+  "bin": {
+    "gzfe-skills": "bin/gzfe-skills.js"
+  },
+  "files": [
+    "bin",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": "github:soleilLulu/gz-fe-skills",
+  "scripts": {
+    "test": "node --test"
+  },
+  "dependencies": {
+    "@inquirer/checkbox": "^4.3.2",
+    "wrap-ansi": "^6.2.0",
+    "yaml": "^2.9.1",
+    "yoctocolors-cjs": "^2.1.3"
+  }
 }