skill-atlas-cli 0.1.24 → 0.1.26

package/bin/cli.js

@@ -41,10 +41,12 @@ async function main() {
 		}
 		await runSearch({ keyword: keyword.trim() });
 	});
-	cli.command("install [name]", "安装 skill（支持 skill 名称）").option("-y, --yes", "非交互模式，默认安装到全局").option("-g, --global", "安装到全局目录").action(async (name, options) => {
+	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
+			global: options.global,
+			agent: options.agent,
+			path: options.path
 		});
 	});
 	cli.help();

package/lib/index.d.ts

@@ -17,6 +17,8 @@ interface AddOptions {
   all?: boolean;
   fullDepth?: boolean;
   copy?: boolean;
+  /** 安装到自定义路径（目录） */
+  path?: string;
 }
 declare const _default: {
   run: (args: string[], options?: AddOptions) => Promise<void>;

package/lib/index.js

@@ -407,8 +407,8 @@ const agents = {
 	cline: {
 		name: "cline",
 		displayName: "Cline",
-		skillsDir: ".agents/skills",
-		globalSkillsDir: join$1(home, ".agents", "skills"),
+		skillsDir: ".cline/skills",
+		globalSkillsDir: join$1(home, ".cline", "skills"),
 		detectInstalled: async () => {
 			return existsSync$1(join$1(home, ".cline"));
 		}
@@ -452,7 +452,7 @@ const agents = {
 	"github-copilot": {
 		name: "github-copilot",
 		displayName: "GitHub Copilot",
-		skillsDir: ".agents/skills",
+		skillsDir: ".github/skills",
 		globalSkillsDir: join$1(home, ".copilot/skills"),
 		detectInstalled: async () => {
 			return existsSync$1(join$1(home, ".copilot"));
@@ -503,6 +503,15 @@ const agents = {
 			return existsSync$1(join$1(home, ".qoder"));
 		}
 	},
+	qoderwork: {
+		name: "qoderwork",
+		displayName: "QoderWork",
+		skillsDir: ".qoderwork/skills",
+		globalSkillsDir: join$1(home, ".qoderwork/skills"),
+		detectInstalled: async () => {
+			return existsSync$1(join$1(home, ".qoderwork"));
+		}
+	},
 	"qwen-code": {
 		name: "qwen-code",
 		displayName: "Qwen Code",
@@ -530,6 +539,15 @@ const agents = {
 			return existsSync$1(join$1(home, ".trae-cn"));
 		}
 	},
+	windsurf: {
+		name: "windsurf",
+		displayName: "Windsurf",
+		skillsDir: ".windsurf/skills",
+		globalSkillsDir: join$1(home, ".codeium/windsurf/skills"),
+		detectInstalled: async () => {
+			return existsSync$1(join$1(home, ".codeium/windsurf"));
+		}
+	},
 	universal: {
 		name: "universal",
 		displayName: "Universal",
@@ -816,17 +834,45 @@ async function installWellKnownSkillForAgent(skill, agentType, options = {}) {
 	const isGlobal = options.global ?? false;
 	const cwd = options.cwd || process.cwd();
 	const installMode = options.mode ?? "symlink";
+	const customPath = options.path?.trim();
+	const skillName = sanitizeName(skill.slug);
+	let agentDir;
+	if (customPath) {
+		const resolvedPath = resolve(customPath);
+		agentDir = join$1(resolvedPath, skillName);
+		if (!isPathSafe(resolvedPath, agentDir)) return {
+			success: false,
+			path: agentDir,
+			mode: "copy",
+			error: "Invalid path: potential path traversal detected"
+		};
+		try {
+			await cleanAndCreateDirectory(agentDir);
+			await downloadAndExtractPackage(skill, agentDir);
+			return {
+				success: true,
+				path: agentDir,
+				mode: "copy"
+			};
+		} catch (error) {
+			return {
+				success: false,
+				path: agentDir,
+				mode: "copy",
+				error: error instanceof Error ? error.message : "Unknown error"
+			};
+		}
+	}
 	if (isGlobal && agent.globalSkillsDir === void 0) return {
 		success: false,
 		path: "",
 		mode: installMode,
 		error: `${agent.displayName} does not support global skill installation`
 	};
-	const skillName = sanitizeName(skill.slug);
 	const canonicalBase = getCanonicalSkillsDir(isGlobal, cwd);
 	const canonicalDir = join$1(canonicalBase, skillName);
 	const agentBase = getAgentBaseDir(agentType, isGlobal, cwd);
-	const agentDir = join$1(agentBase, skillName);
+	agentDir = join$1(agentBase, skillName);
 	if (!isPathSafe(canonicalBase, canonicalDir)) return {
 		success: false,
 		path: agentDir,
@@ -953,6 +999,10 @@ ${asset.readme || ""}
 }
 //#endregion
 //#region src/commands/install.ts
+/** 非 TTY 环境（如 OpenClaw、CI、管道）下自动启用非交互模式，避免阻塞 */
+function isNonInteractiveEnv() {
+	return !process.stdin.isTTY;
+}
 async function promptForAgents(message, choices, initialValues) {
 	return await searchMultiselect({
 		message,
@@ -980,8 +1030,12 @@ function buildAgentChoices(globalInstall) {
 function getDefaultAgents(choices) {
 	return ["claude-code", "openclaw"].filter((agent) => choices.some((choice) => choice.value === agent));
 }
-async function resolveSkillName(inputSkill) {
+async function resolveSkillName(inputSkill, nonInteractive) {
 	if (inputSkill?.trim()) return inputSkill.trim();
+	if (nonInteractive) errorAndExit("Please provide skill name", {
+		title: "Usage",
+		body: "skill-atlas install <skillName>\n\nExample: skill-atlas install my-skill"
+	});
 	const input = await p.text({
 		message: "Enter skill to install",
 		placeholder: "my-skill",
@@ -992,20 +1046,52 @@ async function resolveSkillName(inputSkill) {
 	if (p.isCancel(input)) cancelAndExit("Cancelled");
 	return input.trim();
 }
-async function resolveTargetAgents(options) {
-	const allAgentChoices = buildAgentChoices(Boolean(options.global ?? options.yes));
-	if (options.yes) {
+/** 校验并解析传入的 agent 名称（纯函数，可单独测试） */
+function parseAgentNames(input) {
+	const names = Array.isArray(input) ? input : input ? [input] : [];
+	if (!names.length) return [];
+	const validKeys = new Set(Object.keys(agents));
+	const result = [];
+	const invalid = [];
+	for (const name of names) {
+		const normalized = name.trim().toLowerCase();
+		if (validKeys.has(normalized)) result.push(normalized);
+		else invalid.push(name);
+	}
+	if (invalid.length > 0) return { invalid };
+	return result;
+}
+function resolveAgentNamesFromOptions(input) {
+	const parsed = parseAgentNames(input);
+	if (Array.isArray(parsed)) return parsed;
+	errorAndExit(`Unknown agent(s): ${parsed.invalid.join(", ")}`, {
+		title: "Supported agents",
+		body: `Examples: ${[
+			"cursor",
+			"openclaw",
+			"claude-code",
+			"cline",
+			"codex"
+		].join(", ")}\nFull list: ${Object.keys(agents).join(", ")}`
+	});
+}
+async function resolveTargetAgents(options, nonInteractive) {
+	const allAgentChoices = buildAgentChoices(Boolean(options.global ?? options.yes ?? nonInteractive));
+	if (options.yes || nonInteractive) {
+		const specified = resolveAgentNamesFromOptions(options.agent);
+		if (specified.length > 0) return specified;
 		const defaults = getDefaultAgents(allAgentChoices);
 		if (defaults.length === 0) cancelAndExit("No default agents available");
+		p.log.message(chalk.dim("未指定 --agent，使用默认 agents。可用 --agent cursor 等指定安装目标"));
 		return defaults;
 	}
 	const selected = await promptForAgents("Which agents do you want to install to?", allAgentChoices, getDefaultAgents(allAgentChoices));
 	if (p.isCancel(selected) || selected.length === 0) cancelAndExit("Installation cancelled");
 	return selected;
 }
-async function resolveInstallScope(options, targetAgents) {
+async function resolveInstallScope(options, targetAgents, nonInteractive) {
 	const supportsGlobal = targetAgents.some((agent) => agents[agent].globalSkillsDir !== void 0);
-	if (options.global !== void 0 || options.yes || !supportsGlobal) return options.global ?? (options.yes ? true : false);
+	if (options.global !== void 0 || options.yes || nonInteractive || !supportsGlobal) return options.global ?? (options.yes || nonInteractive ? true : false);
 	const scope = await p.select({
 		message: "Installation scope",
 		options: [{
@@ -1021,15 +1107,30 @@ async function resolveInstallScope(options, targetAgents) {
 	if (p.isCancel(scope)) cancelAndExit("Installation cancelled");
 	return scope;
 }
+/** 非 TTY 下使用静态输出替代 spinner，避免动画帧被逐行打印造成刷屏 */
+function createProgressReporter(nonInteractive) {
+	if (nonInteractive) return {
+		start: (msg) => p.log.message(msg),
+		stop: (msg) => {
+			if (msg) p.log.message(msg);
+		}
+	};
+	const s = p.spinner();
+	return {
+		start: (msg) => s.start(msg),
+		stop: (msg) => s.stop(msg ?? "")
+	};
+}
 const run = async (args, options = {}) => {
+	const nonInteractive = options.yes || isNonInteractiveEnv();
 	p.intro(chalk.bold("skill-atlas install"));
-	const skill = await resolveSkillName(args[0]);
-	const s = p.spinner();
-	s.start(`Searching for ${chalk.bold(skill)}...`);
+	const skill = await resolveSkillName(args[0], nonInteractive);
+	const progress = createProgressReporter(nonInteractive);
+	progress.start(`Searching for ${chalk.bold(skill)}...`);
 	try {
 		const asset = await findAsset(skill);
 		if (!asset) {
-			s.stop();
+			progress.stop();
 			errorAndExit(`Not found: ${chalk.bold(skill)}`, {
 				title: "Suggest",
 				body: `Try: skill-atlas search ${skill}`
@@ -1037,32 +1138,46 @@ const run = async (args, options = {}) => {
 		}
 		const displayName = asset.displayName || asset.slug;
 		const version = asset.currentVersion.version ?? "0.0.0";
-		s.stop(`${chalk.bold(displayName)} ${chalk.dim(`v${version}`)}`);
-		const targetAgents = await resolveTargetAgents(options);
-		const installGlobally = await resolveInstallScope(options, targetAgents);
-		const selectedLabels = targetAgents.map((a) => agents[a].displayName);
-		p.log.message(chalk.green("Selected:") + " " + selectedLabels.join(", "));
-		s.start("Installing skills...");
+		progress.stop(`${chalk.bold(displayName)} ${chalk.dim(`v${version}`)}`);
+		const customPath = options.path?.trim();
 		const installMode = options.copy ? "copy" : "symlink";
 		const installResults = [];
-		for (const agent of targetAgents) {
-			const result = await installWellKnownSkillForAgent(asset, agent, {
-				global: installGlobally,
+		if (customPath) {
+			progress.start(`${chalk.dim("Installing to")} ${customPath}...`);
+			const result = await installWellKnownSkillForAgent(asset, "openclaw", {
+				path: customPath,
 				mode: installMode
 			});
-			if (!result.success) throw new Error(`Failed to install to ${agents[agent].displayName}: ${result.error || "Unknown error"}`);
+			if (!result.success) throw new Error(`Failed to install to ${customPath}: ${result.error || "Unknown error"}`);
 			installResults.push({
-				agent,
+				agent: "openclaw",
 				path: result.path
 			});
+		} else {
+			const targetAgents = await resolveTargetAgents(options, nonInteractive);
+			const installGlobally = await resolveInstallScope(options, targetAgents, nonInteractive);
+			const selectedLabels = targetAgents.map((a) => agents[a].displayName);
+			p.log.message(chalk.green("Selected:") + " " + selectedLabels.join(", "));
+			progress.start("Installing skills...");
+			for (const agent of targetAgents) {
+				const result = await installWellKnownSkillForAgent(asset, agent, {
+					global: installGlobally,
+					mode: installMode
+				});
+				if (!result.success) throw new Error(`Failed to install to ${agents[agent].displayName}: ${result.error || "Unknown error"}`);
+				installResults.push({
+					agent,
+					path: result.path
+				});
+			}
 		}
-		s.stop("Skills installed successfully");
+		progress.stop("Skills installed successfully");
 		const title = import_picocolors.default.green("Installed 1 skill");
-		const resultLines = installResults.map((r) => `  ${agents[r.agent].displayName}: ${r.path}`);
+		const resultLines = customPath ? [`  ${customPath}: ${installResults[0].path}`] : installResults.map((r) => `  ${agents[r.agent].displayName}: ${r.path}`);
 		p.note(resultLines.join("\n"), title);
 		p.outro(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Skill ready. Review before use."));
 	} catch (err) {
-		s.stop();
+		progress.stop();
 		p.log.error(`Install failed: ${err.message}`);
 		process.exit(1);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-atlas-cli",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "skill-atlas CLI - 虾小宝 命令行工具",
   "homepage": "https://ai.skillatlas.cn/",
   "type": "module",