skill-atlas-cli 0.1.26 → 0.1.28

package/README.md

@@ -25,22 +25,31 @@ npm install -g skill-atlas
 skill-atlas search deploy
 ```
 
+### `update`
+
+快速升级 CLI 到最新版本。
+
+```bash
+npx skill-atlas-cli update
+npx skill-atlas-cli update -y   # 非交互模式，跳过确认直接升级
+```
+
 ### `install [name]`
 
 从 SkillAtlas 安装 skill。支持指定 skill 名称（slug），或进入交互式输入。
 
 ```bash
 # 直接指定 skill 安装
-skill-atlas install [name]
+npx skill-atlas-cli install [name]
 
 # 交互式输入（无参数时）
-skill-atlas install
+npx skill-atlas-cli install
 
 # 非交互模式，默认安装到全局（跳过 Agent 与范围选择）
-skill-atlas install [name] -y
+npx skill-atlas-cli install [name] -y
 
 # 显式安装到全局目录
-skill-atlas install [name] --global
+npx skill-atlas-cli install [name] --global
 ```
 
 **选项：**

package/SKILL.md

@@ -0,0 +1,205 @@
+---
+name: SkillAtlas
+displayName: SkillAtlas
+description: 帮助用户从 SkillAtlas（ai.skillatlas.cn）技能市场中发现合适的 skills。当用户在寻找某种可能以 skill 形式存在的能力时，应使用此 skill。
+version: 1.0.0
+---
+
+# Find Skills
+
+这个 skill 用于帮助你从 SkillAtlas 技能市场（ai.skillatlas.cn）中发现合适的 skills。
+
+## 何时使用这个 Skill
+
+当用户出现以下情况时，使用这个 skill：
+
+- 询问「我怎么做 X」，而 X 可能是已有 skill 支持的常见任务
+- 说「帮我找个做 X 的 skill」或「有没有做 X 的 skill」
+- 询问「你能做 X 吗」，其中 X 是某种专门能力
+- 表达想扩展 agent 能力的意图
+- 想搜索工具、模板或工作流
+- 提到他们需要某个特定场景下的帮助
+- 提到某个平台生态，例如飞书、小红书、抖音、微信等
+
+## 什么是 SkillAtlas CLI？
+
+SkillAtlas CLI（`skill-atlas` 或 `npx skill-atlas-cli`）是虾小宝命令行工具，用于从 [ai.skillatlas.cn](https://ai.skillatlas.cn) 搜索并安装 skill 到各类 AI 编程助手（Cursor、OpenClaw、Claude Code、Cline 等）。
+
+### 核心命令
+
+- `npx skill-atlas-cli search <关键词>`：按关键词搜索 skills
+- `npx skill-atlas-cli install [name]`：安装 skill（交互式选择目标 agent 和安装范围）
+- `npx skill-atlas-cli install [name] -y`：非交互安装，按默认配置（全局、默认 agents）
+- `npx skill-atlas-cli install [name] -y --agent <agent>`：非交互安装到指定 agent（如 Cursor、OpenClaw）
+
+**常用选项：**
+
+| 选项                     | 说明                                                     |
+| ------------------------ | -------------------------------------------------------- |
+| `-y, --yes`              | 非交互模式，跳过所有选择                                 |
+| `-g, --global`           | 安装到全局目录                                           |
+| `-a, --agent <agent...>` | 指定目标 agent（非 TTY 时推荐传入，如 `--agent cursor`） |
+
+**非 TTY 场景（Agent 调用、CI、管道）：** 建议传入 `--agent <当前 agent 名>` 以安装到正确目录，例如 Cursor 调用时使用 `--agent cursor`。
+
+浏览 skills：<https://skillatlas.cn>
+
+### 支持的 Agent
+
+| Agent       | 项目目录         | 全局目录                   |
+| ----------- | ---------------- | -------------------------- |
+| Cursor      | `.agents/skills` | `~/.cursor/skills`         |
+| OpenClaw    | `skills`         | `~/.openclaw/skills`       |
+| Claude Code | `.claude/skills` | `~/.claude/skills`         |
+| Cline       | `.cline/skills`  | `~/.cline/skills`          |
+| Qoder       | `.qoder/skills`  | `~/.qoder/skills`          |
+| 更多...     | 见 README        | skill-atlas 支持多种 Agent |
+
+## 如何帮助用户查找 Skills
+
+### 第 1 步：理解用户需求
+
+当用户请求帮助时，识别以下内容：
+
+1. 具体任务是什么，例如会议纪要、内容选题、财报分析、店铺运营、代码辅助
+2. 用户是否提到了明确的使用场景
+3. 用户是否提到了特定平台生态，例如飞书、小红书、抖音、微信
+4. 是否适合将这些信息组合起来搜索相关 skill
+
+### 第 2 步：搜索 Skills
+
+使用相关关键词进行搜索：
+
+```bash
+skill-atlas search <关键词>
+```
+
+或使用 npx：
+
+```bash
+npx skill-atlas-cli search <关键词>
+```
+
+示例：
+
+- 用户问「怎么在飞书里自动整理会议纪要？」
+  - 搜索词：`会议纪要 飞书`
+
+- 用户问「我想做小红书选题和内容规划」
+  - 搜索词：`内容规划 小红书`
+
+- 用户问「我需要一个财报分析助手」
+  - 搜索词：`财报分析`
+
+- 用户问「怎么提升抖音短视频运营效率？」
+  - 搜索词：`短视频运营 抖音`
+
+- 用户问「能帮我做微信私域运营吗？」
+  - 搜索词：`私域运营 微信`
+
+- 用户问「我想找一个代码开发辅助 skill」
+  - 搜索词：`代码助手`
+
+- 用户问「我想让 agent 自己优化工作流」
+  - 搜索词：`工作流优化`
+
+如果组合关键词没有结果，则按以下顺序逐步简化查询：
+
+1. 只保留任务关键词
+2. 使用更短、更常见的任务表述
+3. 任务关键词加上平台名或场景词再次尝试
+
+搜索结果可能返回类似信息：
+
+```
+Install: npx skill-atlas-cli install <skillName>
+
+feishu-office-assistant  飞书办公助手  v1.0.0
+```
+
+### 第 3 步：向用户呈现结果
+
+当找到相关 skill 时，应向用户提供：
+
+1. skill 名称及其作用
+2. 用户可直接执行的安装命令
+3. 在 ai.skillatlas.cn 上查看更多信息的链接
+4. 一句简短说明，说明它为什么匹配当前任务
+5. 该 skill 的标签值信息（如有）
+6. 该 skill 的安全等级（如有）
+
+安全等级可使用以下表述：
+
+- 已通过完整认证（非常推荐）
+- 已通过重点审查（推荐使用）
+- 已通过基础审核（推荐使用）
+
+示例回复：
+
+```
+我找到了一个可能适合的 skill。`feishu-office-assistant` 适用于飞书办公场景下的常见任务，例如会议纪要整理、任务跟进和文档协作。
+
+标签值：企业办公、飞书
+安全等级：已通过完整认证（非常推荐）
+
+安装命令：`skill-atlas install feishu-office-assistant`
+
+了解更多：https://ai.skillatlas.cn
+```
+
+### 第 4 步：安装（可选）
+
+如果用户希望安装，可提示用户执行：
+
+```bash
+npx skill-atlas-cli install <skillName>
+```
+
+非交互模式（默认安装到全局、默认 agents）：
+
+```bash
+npx skill-atlas-cli install <skillName> -y
+```
+
+**Agent 调用时**（如 Cursor、OpenClaw 内执行）：传入 `--agent` 以安装到当前 agent 目录：
+
+```bash
+npx skill-atlas-cli install <skillName> -y --agent cursor
+```
+
+## 高效搜索建议
+
+1. 优先使用更具体的任务关键词：`会议纪要` 比 `办公` 更有效
+2. 优先保留用户原话中的关键名词：例如平台名、工作对象、产出物
+3. 尝试不同任务表述：例如 `内容规划`、`选题策划`、`发布流程` 可能返回不同结果
+4. 没有结果时逐步回退：先搜较长组合，再退回到更短、更通用的关键词
+
+## 常见 Skill 类别
+
+| 类别     | 示例搜索词                   |
+| -------- | ---------------------------- |
+| 企业办公 | 会议纪要、飞书、任务跟进     |
+| 内容创作 | 小红书、抖音、选题、内容规划 |
+| 数据分析 | 财报分析、数据透视           |
+| 代码开发 | 代码助手、调试、测试         |
+| 部署运维 | deploy、docker、ci-cd        |
+| 私域运营 | 微信、私域、社群             |
+
+## 当没有找到 Skill 时
+
+如果没有找到相关 skill：
+
+1. 明确说明当前没有发现现成的 skill
+2. 表示仍然可以直接帮助处理该任务，或提供通用建议
+3. 不要承诺创建、安装或代为配置 skill
+
+示例：
+
+```
+我搜索了与「微信私域运营」相关的 skills，但没有找到匹配项。
+不过我仍然可以直接帮你梳理这个任务的通用做法，或帮你缩小搜索范围。
+```
+
+## 能力边界
+
+这个 skill 只负责发现和推荐，不负责代安装、代创建、代配置。

package/bin/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
 import { cac } from "cac";
-import { checkForUpdate, install, logger, runSearch } from "../lib/index.js";
+import { checkForUpdate, install, logger, runSearch, runUpdate } from "../lib/index.js";
 //#region src/bin/cli.ts
 function getPackageJson() {
 	try {
@@ -41,6 +41,13 @@ async function main() {
 		}
 		await runSearch({ keyword: keyword.trim() });
 	});
+	cli.command("update", "快速升级 CLI 到最新版本").option("-y, --yes", "非交互模式，跳过确认直接升级").action(async (options) => {
+		await runUpdate({
+			pkgName: PKG.name,
+			currentVersion: PKG.version,
+			yes: options.yes
+		});
+	});
 	cli.command("install [name]", "安装 skill（支持 skill 名称）").option("-y, --yes", "非交互模式，默认安装到全局").option("-g, --global", "安装到全局目录").option("-p, --path <dir>", "安装到自定义路径（目录），如 -p /path/to/skills 或 -p .qoder/skills").option("-a, --agent <agent...>", "非 TTY 模式下指定目标 agent（如 cursor、openclaw），可传多个").action(async (name, options) => {
 		await install.run(name ? [name] : [], {
 			yes: options.yes,

package/lib/index.d.ts

@@ -35,6 +35,17 @@ interface SearchOptions {
 }
 declare function runSearch(options: SearchOptions): Promise<void>;
 //#endregion
+//#region src/commands/update.d.ts
+interface UpdateOptions {
+  /** 包名 */
+  pkgName: string;
+  /** 当前版本 */
+  currentVersion: string;
+  /** 非交互模式，跳过确认 */
+  yes?: boolean;
+}
+declare function runUpdate(options: UpdateOptions): Promise<void>;
+//#endregion
 //#region src/core/logger.d.ts
 /**
  * 设置 verbose 模式（启用 debug 输出）
@@ -62,4 +73,4 @@ declare const _default$1: {
   log: LogFn;
 };
 //#endregion
-export { checkForUpdate, _default as install, _default$1 as logger, runSearch };
+export { checkForUpdate, _default as install, _default$1 as logger, runSearch, runUpdate };

package/lib/index.js

@@ -13,6 +13,7 @@ import { Writable } from "stream";
 import { cp, lstat, mkdir, readdir, readlink, realpath, rename, rm, stat, symlink, unlink, writeFile } from "fs/promises";
 import { execSync } from "child_process";
 import { info } from "console";
+import { spawn } from "node:child_process";
 import { createConsola } from "consola";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -199,7 +200,7 @@ var config_default = {
 const CACHE_DIR = config_default.CONFIG_DIR;
 const CACHE_FILE = join(CACHE_DIR, "update-check.json");
 const CHECK_INTERVAL = 1e3 * 60 * 60;
-async function fetchLatestVersion(pkgName) {
+async function fetchLatestVersion$1(pkgName) {
 	const baseUrl = (process.env.npm_config_registry || "https://registry.npmjs.org").replace(/\/$/, "");
 	const res = await fetch(`${baseUrl}/-/package/${pkgName}/dist-tags`, { signal: AbortSignal.timeout(3e3) });
 	if (!res.ok) throw new Error("Fetch failed");
@@ -228,11 +229,11 @@ function saveCache(latest) {
 function checkForUpdate(pkg) {
 	const cache = getCache();
 	if (cache?.latest && semver.gt(cache.latest, pkg.version)) {
-		if (process.stdout.isTTY) console.error(`\n  📦 Update available: \x1b[31m${pkg.version}\x1b[0m → \x1b[32m${cache.latest}\x1b[0m\n  👉 No need to reinstall. Run: \x1b[36mnpm update -g ${pkg.name} --force \x1b[0m\n`);
+		if (process.stdout.isTTY) console.error(`\n  📦 Update available: \x1b[31m${pkg.version}\x1b[0m → \x1b[32m${cache.latest}\x1b[0m\n  👉 Run: \x1b[36mskill-atlas update\x1b[0m\n`);
 	}
 	const lastCheck = cache?.lastCheck || 0;
 	if (Date.now() - lastCheck < CHECK_INTERVAL) return;
-	fetchLatestVersion(pkg.name).then((latest) => {
+	fetchLatestVersion$1(pkg.name).then((latest) => {
 		saveCache(latest);
 	}).catch(() => {});
 }
@@ -1261,4 +1262,70 @@ var logger_default = {
 	log: ((...a) => consola.log(...a))
 };
 //#endregion
-export { checkForUpdate, install_default as install, logger_default as logger, runSearch };
+//#region src/commands/update.ts
+/**
+* update 命令：快速升级 CLI 到最新版本
+*/
+/** 从 npm registry 获取最新版本 */
+async function fetchLatestVersion(pkgName) {
+	const baseUrl = (process.env.npm_config_registry || "https://registry.npmjs.org").replace(/\/$/, "");
+	const res = await fetch(`${baseUrl}/-/package/${pkgName}/dist-tags`, { signal: AbortSignal.timeout(5e3) });
+	if (!res.ok) throw new Error("获取最新版本失败");
+	return (await res.json()).latest || "0.0.0";
+}
+/** 执行 npm install -g <pkg>@latest */
+function runNpmUpdate(pkgName) {
+	return new Promise((resolve) => {
+		const child = spawn("npm", [
+			"install",
+			"-g",
+			`${pkgName}@latest --force`
+		], {
+			stdio: "inherit",
+			shell: true
+		});
+		child.on("close", (code) => resolve(code ?? 0));
+		child.on("error", () => resolve(1));
+	});
+}
+async function runUpdate(options) {
+	const { pkgName, currentVersion, yes } = options;
+	const spinner = p.spinner();
+	spinner.start("检查最新版本...");
+	try {
+		const latest = await fetchLatestVersion(pkgName);
+		spinner.stop("检查完成");
+		if (!semver.valid(latest)) {
+			p.log.error(`无法解析最新版本: ${latest}`);
+			process.exit(1);
+		}
+		if (semver.lte(latest, currentVersion)) {
+			p.log.success(`已是最新版本 ${chalk.cyan(currentVersion)}`);
+			return;
+		}
+		p.log.message(`发现新版本: ${chalk.red(currentVersion)} → ${chalk.green(latest)}`);
+		const proceed = yes || !process.stdin.isTTY ? true : await p.confirm({
+			message: "是否立即升级？",
+			initialValue: true
+		});
+		if (p.isCancel(proceed) || proceed === false) {
+			p.cancel("已取消升级");
+			return;
+		}
+		spinner.start("正在升级...");
+		const code = await runNpmUpdate(pkgName);
+		spinner.stop(code === 0 ? "升级完成" : "升级失败");
+		if (code !== 0) {
+			logger_default.error("升级失败，可手动执行: npm install -g " + pkgName + "@latest");
+			process.exit(1);
+		}
+		p.log.success(`已升级到 ${chalk.green(latest)}`);
+	} catch (err) {
+		spinner.stop("检查失败");
+		p.log.error(err.message);
+		logger_default.info("可手动执行: npm install -g " + pkgName + "@latest");
+		process.exit(1);
+	}
+}
+//#endregion
+export { checkForUpdate, install_default as install, logger_default as logger, runSearch, runUpdate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-atlas-cli",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "skill-atlas CLI - 虾小宝 命令行工具",
   "homepage": "https://ai.skillatlas.cn/",
   "type": "module",
@@ -29,7 +29,8 @@
     "plugin",
     "package.json",
     "README.md",
-    "install.sh"
+    "install.sh",
+    "SKILL.md"
   ],
   "keywords": [
     "skill-atlas",
@@ -48,15 +49,15 @@
     "cac": "^7.0.0",
     "chalk": "^5.6.2",
     "consola": "^3.4.2",
-    "semver": "^7.6.0"
+    "semver": "^7.7.4"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "vitest": "^2.1.0",
+    "@types/node": "^22.19.15",
     "picocolors": "^1.1.1",
-    "simple-git": "^3.32.3",
-    "tsdown": "^0.21.0",
-    "typescript": "^5.6.0",
+    "simple-git": "^3.33.0",
+    "tsdown": "^0.21.4",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9",
     "xdg-basedir": "^5.1.0"
   },
   "engines": {