skill-atlas-cli 0.1.4

package/README.md

@@ -0,0 +1,82 @@
+# Skill-Atlas CLI
+
+虾小宝 SkillAtlas 命令行工具，用于从 [skillatlas.cn](https://skillatlas.cn) 搜索并安装 skill 到各类 AI 编程助手（Cursor、OpenClaw、Claude Code、Cline 等）。
+
+## 环境要求
+
+- Node.js >= 20.19
+
+## 安装
+
+```bash
+
+# 或通过 npm 全局安装
+npm install -g skill-atlas
+
+```
+
+## 命令
+
+### `search <keyword>`
+
+从 SkillAtlas 搜索 skill（按名称或描述匹配）。
+
+```bash
+skill-atlas search deploy
+```
+
+### `install [name]`
+
+从 SkillAtlas 安装 skill。支持指定 skill 名称（slug），或进入交互式输入。
+
+```bash
+# 直接指定 skill 安装
+skill-atlas install [name]
+
+# 交互式输入（无参数时）
+skill-atlas install
+
+# 非交互模式，默认安装到全局（跳过 Agent 与范围选择）
+skill-atlas install [name] -y
+
+# 显式安装到全局目录
+skill-atlas install [name] --global
+```
+
+**选项：**
+
+- `-y, --yes` - 非交互模式，默认安装到全局（使用默认 Agent：Claude Code、OpenClaw）
+- `-g, --global` - 安装到全局目录
+
+无 `-y` 时会提示选择目标 Agent（Cursor、OpenClaw、Claude Code 等）以及安装范围（项目级 / 全局）。
+
+### 全局选项
+
+- `-h, --help` - 显示帮助
+- `-v, --version` - 显示版本
+
+## 支持的 Agent
+
+| Agent          | 项目目录         | 全局目录                               |
+| -------------- | ---------------- | -------------------------------------- |
+| Cursor         | `.agents/skills` | `~/.cursor/skills`                     |
+| OpenClaw       | `skills`         | `~/.openclaw/skills`                   |
+| Claude Code    | `.claude/skills` | `~/.claude/skills`                     |
+| Cline          | `.agents/skills` | `~/.agents/skills`                     |
+| Codex          | `.agents/skills` | `~/.codex/skills`                      |
+| Gemini CLI     | `.agents/skills` | `~/.gemini/skills`                     |
+| Qwen Code      | `.qwen/skills`   | `~/.qwen/skills`                       |
+| GitHub Copilot | `.agents/skills` | `~/.copilot/skills`                    |
+| iFlow CLI      | `.iflow/skills`  | `~/.iflow/skills`                      |
+| Kimi Code CLI  | `.agents/skills` | `~/.config/agents/skills`              |
+| Qoder          | `.qoder/skills`  | `~/.qoder/skills`                      |
+| Trae / Trae CN | `.trae/skills`   | `~/.trae/skills` / `~/.trae-cn/skills` |
+| Antigravity    | `.agent/skills`  | `~/.gemini/antigravity/skills`         |
+
+## 别名
+
+可通过以下任一命令名调用：
+
+- `skill-atlas`
+- `skill-atlas-cli`
+- `skillatlas`

package/bin/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { cac } from "cac";
+import { checkForUpdate, install, logger, runSearch } from "../lib/index.js";
+//#region src/bin/cli.ts
+function getPackageJson() {
+	try {
+		return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+	} catch {
+		return {
+			name: "skill-atlas",
+			version: "1.0.0"
+		};
+	}
+}
+const LOGO_LINES = [
+	"      _    _ _ _             _   _           ",
+	"  ___| | _(_) | |       __ _| |_| | __ _ ___ ",
+	" / __| |/ / | | |_____ / _` | __| |/ _` / __|",
+	" \\__ \\   <| | | |_____| (_| | |_| | (_| \\__ \\",
+	" |___/_|\\_\\_|_|_|      \\__,_|\\__|_|\\__,_|___/"
+];
+function showLogo() {
+	LOGO_LINES.forEach((line) => {
+		console.log(`${line}`);
+	});
+	console.log();
+}
+const PKG = getPackageJson();
+const VERSION = PKG.version;
+async function main() {
+	checkForUpdate(PKG);
+	showLogo();
+	const parseArgv = process.argv.slice(2).length === 0 ? [...process.argv.slice(0, 2), "--help"] : process.argv;
+	const cli = cac("skill-atlas");
+	cli.command("search [keyword]", "搜索 skill（按名称或描述匹配）").action(async (keyword) => {
+		if (!keyword?.trim()) {
+			logger.error("请提供搜索关键词");
+			logger.info("提示: skill-atlas search <关键词>");
+			process.exit(1);
+		}
+		await runSearch({ keyword: keyword.trim() });
+	});
+	cli.command("install [name]", "安装 skill（支持 skill 名称）").option("-y, --yes", "非交互模式，默认安装到全局").option("-g, --global", "安装到全局目录").action(async (name, options) => {
+		await install.run(name ? [name] : [], {
+			yes: options.yes,
+			global: options.global
+		});
+	});
+	cli.help();
+	cli.version(VERSION);
+	cli.parse(parseArgv);
+}
+main();
+//#endregion
+export {};

package/lib/index.d.ts

@@ -0,0 +1,63 @@
+//#region src/core/update-notifier.d.ts
+/**
+ * 检查更新，有新版本时输出提示（无需重装，直接 update）
+ */
+declare function checkForUpdate(pkg: {
+  name: string;
+  version: string;
+}): void;
+//#endregion
+//#region src/commands/install.d.ts
+interface AddOptions {
+  global?: boolean;
+  agent?: string[];
+  yes?: boolean;
+  skill?: string[];
+  list?: boolean;
+  all?: boolean;
+  fullDepth?: boolean;
+  copy?: boolean;
+}
+declare const _default: {
+  run: (args: string[], options?: AddOptions) => Promise<void>;
+};
+//#endregion
+//#region src/commands/search.d.ts
+/**
+ * 根据接口文档 /api/v1/skills 搜索 skill
+ * q 有值时执行搜索；q 为空时按热度排序返回列表
+ */
+interface SearchOptions {
+  /** 搜索关键词 */
+  keyword: string;
+}
+declare function runSearch(options: SearchOptions): Promise<void>;
+//#endregion
+//#region src/core/logger.d.ts
+/**
+ * 设置 verbose 模式（启用 debug 输出）
+ * consola level: 3=info, 4=debug
+ */
+declare function setVerbose(enabled: boolean): void;
+/**
+ * 检查是否启用 verbose
+ */
+declare function isVerbose(): boolean;
+/**
+ * 错误别名（兼容 err 调用）
+ */
+declare function err(...args: unknown[]): void;
+type LogFn = (...a: unknown[]) => void;
+declare const _default$1: {
+  setVerbose: typeof setVerbose;
+  isVerbose: typeof isVerbose;
+  info: LogFn;
+  success: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  err: typeof err;
+  debug: LogFn;
+  log: LogFn;
+};
+//#endregion
+export { checkForUpdate, _default as install, _default$1 as logger, runSearch };