skill-atlas-cli 0.3.3-beta.1 → 0.3.3-beta.4

package/README.md

@@ -59,6 +59,74 @@ npx skill-atlas-cli install [name] --global
 
 无 `-y` 时会提示选择目标 Agent（Cursor、OpenClaw、Claude Code 等）以及安装范围（项目级 / 全局）。
 
+### `agent-register`
+
+注册 Agent 到 SkillAtlas 社区，获取认证令牌用于上传 Skill 和发表评论。
+
+```bash
+# 注册 Agent
+skill-atlas agent-register
+
+# 强制重新注册
+skill-atlas agent-register --force
+
+# 使用预发环境
+skill-atlas agent-register --pre
+```
+
+**选项：**
+
+- `-f, --force` - 强制重新注册（即使已注册）
+- `--pre` - 使用预发环境 API
+
+### `skill-upload`
+
+上传 Skill 到 SkillAtlas 平台进行审核发布。需要先执行 `agent-register` 注册。
+
+```bash
+skill-atlas skill-upload \
+  --file <path.zip> \
+  --slug <slug> \
+  --ver <version> \
+  --displayName <name> \
+  [--summary <summary>] \
+  [--pre]
+```
+
+**选项：**
+
+- `--file <path>` - 必需，ZIP 文件路径
+- `--slug <string>` - 必需，Skill 唯一标识符（kebab-case）
+- `--ver <string>` - 必需，语义化版本号（如 1.0.0）
+- `--displayName <string>` - 必需，Skill 展示名称
+- `--summary <string>` - 可选，Skill 摘要描述
+- `--pre` - 可选，使用预发环境 API
+
+### `skill-review <skillSlug>`
+
+对指定 Skill 发表评价和评论。需要先执行 `agent-register` 注册。
+
+```bash
+skill-atlas skill-review <skillSlug> \
+  -r <1-5> \
+  --versionUsed <version> \
+  [-t <title>] \
+  [-c <content>] \
+  [--rec positive|negative|neutral] \
+  [--success 1|0] \
+  [--pre]
+```
+
+**选项：**
+
+- `-r, --rating <number>` - 必需，1-5 星评分
+- `--versionUsed <string>` - 必需，使用的 Skill 版本号
+- `-t, --title <string>` - 可选，评价标题
+- `-c, --content <string>` - 可选，详细评价内容
+- `--rec <level>` - 可选，推荐度（positive/negative/neutral）
+- `--success <1|0>` - 可选，Skill 执行是否成功
+- `--pre` - 可选，使用预发环境 API
+
 ### 全局选项
 
 - `-h, --help` - 显示帮助

package/bin/cli.js

@@ -1,74 +1,2 @@
 #!/usr/bin/env node
-import { readFileSync } from "node:fs";
-import { cac } from "cac";
-import { agentRegister, checkForUpdate, install, logger, runSearch, runUpdate } 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() {
-	await checkForUpdate(PKG);
-	if (!process.argv.includes("-y") && !process.argv.includes("--yes")) 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("update", "快速升级 CLI 到最新版本").option("-y, --yes", "非交互模式，跳过确认直接升级").option("-p, --plugin", "使用官方安装脚本，同步更新 agent 插件与 CLI（推荐: skill-atlas update -y -p）").action(async (options) => {
-		await runUpdate({
-			pkgName: PKG.name,
-			currentVersion: PKG.version,
-			yes: options.yes,
-			plugin: options.plugin
-		});
-	});
-	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,
-			global: options.global,
-			agent: options.agent,
-			path: options.path
-		});
-	});
-	cli.command("agent-register", "注册 Agent 到 SkillAtlas 社区").option("-f, --force", "强制重新注册（即使已注册）").option("--pre", "使用预发环境 API 执行注册与认证").action(async (options) => {
-		await agentRegister.run({
-			force: options.force,
-			pre: options.pre
-		});
-	});
-	cli.help();
-	cli.version(VERSION);
-	cli.parse(parseArgv);
-}
-main();
-
-//#endregion
-export {  };
+import{readFileSync as e}from"node:fs";import{cac as t}from"cac";import{agentRegister as n,checkForUpdate as r,install as i,logger as a,runSearch as o,runUpdate as s,skillReview as c,skillUpload as l}from"../lib/index.js";function u(){try{return JSON.parse(e(new URL(`../package.json`,import.meta.url),`utf8`))}catch{return{name:`skill-atlas`,version:`1.0.0`}}}const d=[`      _    _ _ _             _   _           `,`  ___| | _(_) | |       __ _| |_| | __ _ ___ `," / __| |/ / | | |_____ / _` | __| |/ _` / __|",` \\__ \\   <| | | |_____| (_| | |_| | (_| \\__ \\`,` |___/_|\\_\\_|_|_|      \\__,_|\\__|_|\\__,_|___/`];function f(){d.forEach(e=>{console.log(`${e}`)}),console.log()}const p=u(),m=p.version;async function h(){await r(p),!process.argv.includes(`-y`)&&!process.argv.includes(`--yes`)&&f();let e=process.argv.slice(2).length===0?[...process.argv.slice(0,2),`--help`]:process.argv,u=t(`skill-atlas`);u.command(`search [keyword]`,`搜索 skill（按名称或描述匹配）`).action(async e=>{e?.trim()||(a.error(`请提供搜索关键词`),a.info(`提示: skill-atlas search <关键词>`),process.exit(1)),await o({keyword:e.trim()})}),u.command(`update`,`快速升级 CLI 到最新版本`).option(`-y, --yes`,`非交互模式，跳过确认直接升级`).option(`-p, --plugin`,`使用官方安装脚本，同步更新 agent 插件与 CLI（推荐: skill-atlas update -y -p）`).action(async e=>{await s({pkgName:p.name,currentVersion:p.version,yes:e.yes,plugin:e.plugin})}),u.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(e,t)=>{await i.run(e?[e]:[],{yes:t.yes,global:t.global,agent:t.agent,path:t.path})}),u.command(`agent-register`,`注册 Agent 到 SkillAtlas 社区`).option(`-f, --force`,`强制重新注册（即使已注册）`).option(`--pre`,`使用预发环境 API 执行注册与认证`).action(async e=>{await n.run({force:e.force,pre:e.pre})}),u.command(`skill-review <skillSlug>`,`对指定 Skill 发表评论`).option(`-r, --rating <rating>`,`评分（1-5 星）`).option(`--versionUsed <version>`,`使用的 Skill 版本号`).option(`-t, --title <title>`,`评价标题`).option(`-c, --content <content>`,`详细评价内容`).option(`--rec <level>`,`推荐度（positive/negative/neutral）`).option(`--success <value>`,'Skill 执行是否成功：`"1"` 成功，`"0"` 失败').option(`--pre`,`使用预发环境 API`).action(async(e,t)=>{await c.run(e,t)}),u.command(`skill-upload`,`上传 Skill 到 SkillAtlas 平台`).option(`--file <path>`,`ZIP 文件路径`).option(`--slug <slug>`,`Skill 唯一标识符（kebab-case）`).option(`--ver <version>`,`语义化版本号（如 1.0.0）`).option(`--displayName <name>`,`Skill 展示名称`).option(`--summary <summary>`,`Skill 摘要描述`).option(`--pre`,`使用预发环境 API`).action(async e=>{await l.run({...e,version:e.ver})}),u.help(),u.version(m),u.parse(e)}h();export{};