@cli-skill/cli 0.0.1-beta.20260402075508 → 0.0.1-beta.20260402112811

package/README.md

@@ -2,13 +2,14 @@
 
 `@cli-skill/cli` 是 `cli-skill` 的平台命令行入口。
 
-它不是某一个具体 skill 的运行时，而是整个 skill 生命周期的管理入口。
+它不是某一个具体 skill 的运行时，而是整个 skill 生命周期和本地注册表的管理入口。
 
 ## 主要职责
 
 - 创建新的 skill 项目
-- 提供统一的 skill 作用域命令入口
-- 构建 `skill/` 产物
+- 维护本地 skill 注册表
+- 提供当前目录命令和已注册 skill 执行入口
+- 生成 `skill/` 产物
 - 安装和卸载已发布 skill
 - 挂载和取消挂载本地 skill
 - 发布本地 skill
@@ -25,30 +26,31 @@ cli-skill install <skillName> [--packageName <packageName>]
 cli-skill uninstall <packageName>
 cli-skill config get [keyPath]
 cli-skill config set <keyPath> <value>
+cli-skill exec <skillName> <toolName> [rawInput]
 ```
 
-### skill 作用域命令
+### 当前目录命令
 
 ```bash
-cli-skill <skillName> list
-cli-skill <skillName> run <toolName> [rawInput]
-cli-skill <skillName> config get [keyPath]
-cli-skill <skillName> config set <keyPath> <value>
-cli-skill <skillName> config unset <keyPath>
-cli-skill <skillName> mount [targetPath]
-cli-skill <skillName> unmount [targetPath]
-cli-skill <skillName> build
-cli-skill <skillName> publish [--dry-run] [--tag <tag>]
+cli-skill tools
+cli-skill run <toolName> [rawInput]
+cli-skill config get [keyPath]
+cli-skill config set <keyPath> <value>
+cli-skill config unset <keyPath>
+cli-skill build
+cli-skill mount [targetPath]
+cli-skill unmount [targetPath]
+cli-skill publish [--dry-run] [--tag <tag>]
 ```
 
 ## 典型工作流
 
 ```bash
 cli-skill create my-skill --cli-name my-skill
-cd ~/.cli-skill/skills/my-skill
+cd ./my-skill
 bun install
-cli-skill my-skill build
-cli-skill my-skill mount
+cli-skill build
+cli-skill mount
 ```
 
 ## skill 项目结构
@@ -68,7 +70,7 @@ cli-skill my-skill mount
 - `src/skill/*`
   - 文档模板源目录
 
-执行 `build` 后会生成：
+执行 `cli-skill build` 后会生成：
 
 - `skill/SKILL.md`
 - `skill/agents/openai.yaml`
@@ -80,7 +82,7 @@ cli-skill my-skill mount
 
 ## build 输入
 
-`cli-skill <skillName> build` 会读取：
+`cli-skill build` 会读取：
 
 - `src/index.ts`
 - `src/skill/`
@@ -97,13 +99,17 @@ cli-skill my-skill mount
 
 ## 安装模型
 
-本地 skill 默认放在：
+本地创建的 skill 默认放在当前目录：
+
+- `./<skill-name>`
+
+已安装 skill 默认放在：
 
 - `~/.cli-skill/skills`
 
-托管安装目录默认是：
+本地注册表默认放在：
 
-- `~/.cli-skill/installed`
+- `~/.cli-skill/registry.json`
 
 默认 agent 目录是：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cli-skill/cli",
-  "version": "0.0.1-beta.20260402075508",
+  "version": "0.0.1-beta.20260402112811",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -14,11 +14,10 @@
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
     "test": "tsc -p tsconfig.test.json && bun test ./test"
   },
   "dependencies": {
-    "@cli-skill/core": "^0.0.1-beta.20260402075508",
+    "@cli-skill/core": "^0.0.1-beta.20260402112811",
     "cac": "^6.7.14",
     "lodash": "^4.17.21",
     "zod": "^3.25.76"

package/skill/SKILL.md

@@ -23,7 +23,7 @@ description: 当任务涉及 cli skill 的创建、挂载、安装、发布或
 
 ## 工作模型
 
-处理 cli skill 时，默认按两层命令来理解：
+处理 cli skill 时，默认按三类命令来理解：
 
 - 平台命令
   - `cli-skill create`
@@ -31,10 +31,16 @@ description: 当任务涉及 cli skill 的创建、挂载、安装、发布或
   - `cli-skill install`
   - `cli-skill uninstall`
   - `cli-skill config ...`
-- skill 作用域命令
-  - `cli-skill <skill-name> ...`
+- 当前目录命令
+  - `cli-skill tools`
+  - `cli-skill run`
+  - `cli-skill build`
+  - `cli-skill mount`
+  - `cli-skill publish`
+- 已注册 skill 执行命令
+  - `cli-skill exec <skill-name> ...`
 
-skill 自己的 bin 只是一个转发入口，仍然会落到 `cli-skill <skill-name> ...`。
+skill 自己的 bin 只是一个转发入口，最终会落到 `cli-skill exec <skill-name> ...`。
 
 ## 默认流程
 
@@ -42,9 +48,10 @@ skill 自己的 bin 只是一个转发入口，仍然会落到 `cli-skill <skill
 
 ```bash
 cli-skill create <skill-name> --cli-name <cli-name>
+cd ./<skill-name>
 bun install
-cli-skill <skill-name> build
-cli-skill <skill-name> mount
+cli-skill build
+cli-skill mount
 ```
 
 如果没有提供 `cli-name`，默认令它等于 `skill-name`。
@@ -66,13 +73,7 @@ cli-skill <skill-name> mount
 - `src/skill/*`
   - 文档模板源目录
 
-执行：
-
-```bash
-cli-skill <skill-name> build
-```
-
-会生成：
+执行 `cli-skill build` 会生成：
 
 - `skill/SKILL.md`
 - `skill/agents/openai.yaml`
@@ -85,15 +86,16 @@ cli-skill <skill-name> build
 | 查看 skill 列表 | `cli-skill list` |
 | 安装已发布 skill | `cli-skill install <skill-name>` |
 | 卸载已发布 skill | `cli-skill uninstall <package-name>` |
-| 查看 tool 列表 | `cli-skill <skill-name> list` |
-| 运行 tool | `cli-skill <skill-name> run <tool-name> [rawInput]` |
-| 读取 skill 配置 | `cli-skill <skill-name> config get [keyPath]` |
-| 写入 skill 配置 | `cli-skill <skill-name> config set <keyPath> <value>` |
-| 删除 skill 配置 | `cli-skill <skill-name> config unset <keyPath>` |
-| 挂载 skill | `cli-skill <skill-name> mount [targetPath]` |
-| 取消挂载 skill | `cli-skill <skill-name> unmount [targetPath]` |
-| 构建 skill 产物 | `cli-skill <skill-name> build` |
-| 发布本地 skill | `cli-skill <skill-name> publish [--dry-run] [--tag <tag>]` |
+| 查看 tool 列表 | `cli-skill tools` |
+| 运行当前目录 tool | `cli-skill run <tool-name> [rawInput]` |
+| 运行已注册 skill 的 tool | `cli-skill exec <skill-name> <tool-name> [rawInput]` |
+| 读取当前 skill 配置 | `cli-skill config get [keyPath]` |
+| 写入当前 skill 配置 | `cli-skill config set <keyPath> <value>` |
+| 删除当前 skill 配置 | `cli-skill config unset <keyPath>` |
+| 挂载当前 skill | `cli-skill mount [targetPath]` |
+| 取消挂载当前 skill | `cli-skill unmount [targetPath]` |
+| 构建 skill 产物 | `cli-skill build` |
+| 发布当前 skill | `cli-skill publish [--dry-run] [--tag <tag>]` |
 | 读取全局配置 | `cli-skill config get [keyPath]` |
 | 写入全局配置 | `cli-skill config set <keyPath> <value>` |
 
@@ -106,14 +108,16 @@ cli-skill <skill-name> build
   - 注册根目录 `skill/` 到 agent 目录
 - `mount` 不应隐式执行 `install`。
 - `install` / `uninstall` 面向已发布 skill。
-- `publish` 只针对本地 skill。
+- `publish` 只针对当前目录的本地 skill。
 
 默认目录：
 
-- 本地 skill：
+- 当前目录创建的 skill：
+  - `./<skill-name>`
+- 已安装 skill：
   - `~/.cli-skill/skills/<skill-name>`
-- 托管安装目录：
-  - `~/.cli-skill/installed`
+- 本地注册表：
+  - `~/.cli-skill/registry.json`
 - agent 默认目录：
   - `~/.agents/skills/<skill-name>`
 
@@ -132,8 +136,9 @@ skill 作用域配置路径：
 ```bash
 cli-skill config get
 cli-skill config set skillsRoot ~/.cli-skill/skills
-cli-skill <skill-name> config get
-cli-skill <skill-name> config set baseUrl https://example.com
+cd ./<skill-name>
+cli-skill config get
+cli-skill config set baseUrl https://example.com
 ```
 
 ## 文档规则
@@ -143,7 +148,7 @@ cli-skill <skill-name> config set baseUrl https://example.com
 - tool 或配置变更后，应重新执行：
 
 ```bash
-cli-skill <skill-name> build
+cli-skill build
 ```
 
 ## 不要做的事

package/skill/references/core.md

@@ -14,11 +14,11 @@
   - 真正执行动作的最小单元
 - `skill`
   - 对 tools 的组织与描述
-- `build` 产物
+- `skill/` 产物
   - 给 agent 使用的 `skill/` 目录
 
 源码不是直接写给 agent 的。  
-源码先定义 skill 和 tools，然后再由 `build` 生成 agent 真正消费的产物。
+源码先定义 skill 和 tools，然后再由 `cli-skill build` 生成 agent 真正消费的产物。
 
 ## skill 项目源码结构
 
@@ -40,7 +40,7 @@
 执行：
 
 ```bash
-cli-skill <skill-name> build
+cli-skill build
 ```
 
 之后，根目录会生成：
@@ -179,11 +179,11 @@ export default defineSkill({
 
 - `tool` 负责声明自己要 `browserPlugin`
 - `skill` 只负责把它组织起来
-- `build` 再负责生成 `skill/` 产物
+- `cli-skill build` 再负责生成 `skill/` 产物
 
 ## 文档模板怎么写
 
-`src/skill/*` 下的 `.md/.yaml/.yml` 文件会在 build 时做变量替换。
+`src/skill/*` 下的 `.md/.yaml/.yml` 文件会在 `cli-skill build` 时做变量替换。
 
 当前常用变量有：
 
@@ -217,7 +217,7 @@ export default defineSkill({
 
 - 怎么创建 skill
 - 怎么 mount / install / publish
-- 怎么 build 产物
+- 怎么生成 `skill/` 产物
 
 优先回到主 skill 文档：
 

package/src/app.ts

@@ -3,7 +3,7 @@ import { registerConfigCommand } from "./commands/config";
 import { registerCreateCommand } from "./commands/create";
 import { registerInstallCommand } from "./commands/install";
 import { registerListCommand } from "./commands/list";
-import { registerSkillCommand } from "./commands/skill";
+import { registerSkillCommands } from "./commands/skill";
 import { registerUninstallCommand } from "./commands/uninstall";
 
 export function createApp(version: string) {
@@ -14,7 +14,7 @@ export function createApp(version: string) {
   registerListCommand(cli);
   registerInstallCommand(cli);
   registerUninstallCommand(cli);
-  registerSkillCommand(cli);
+  registerSkillCommands(cli);
 
   cli.help();
   cli.version(version);

package/src/bun.ts

@@ -1,5 +1,6 @@
-import { execFile } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 import { mkdir, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
 
@@ -19,6 +20,33 @@ export async function runBun(
   });
 }
 
+export async function runBunStreaming(
+  args: string[],
+  cwd?: string,
+  envOverrides?: Record<string, string | undefined>,
+): Promise<void> {
+  await new Promise<void>((resolve, reject) => {
+    const child = spawn("bun", args, {
+      cwd,
+      env: {
+        ...process.env,
+        ...envOverrides,
+      },
+      stdio: "inherit",
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+
+      reject(new Error(`bun ${args.join(" ")} failed with code ${code ?? "null"}${signal ? ` signal ${signal}` : ""}`));
+    });
+  });
+}
+
 export async function runBunx(args: string[], cwd?: string): Promise<string> {
   const { stdout } = await execFileAsync("bunx", args, {
     cwd,
@@ -36,7 +64,9 @@ export async function runBunAndCapture(args: string[], cwd?: string): Promise<st
 }
 
 export async function getBunGlobalBinDir(): Promise<string> {
-  return runBunAndCapture(["pm", "bin", "-g"]);
+  const home = process.env.HOME || os.homedir();
+  const bunInstall = process.env.BUN_INSTALL || path.join(home, ".bun");
+  return path.join(bunInstall, "bin");
 }
 
 export async function installPackageToDirectory(packageSpec: string, installDir: string): Promise<void> {

package/src/commands/config.ts

@@ -6,7 +6,9 @@ import {
   parseConfigCliValue,
   saveBrowserSkillCliConfig,
   setConfigValue,
+  unsetConfigValue,
 } from "../config";
+import { getCurrentSkillProject } from "../registry";
 
 function printConfigValue(value: unknown): void {
   if (typeof value === "string") {
@@ -25,13 +27,24 @@ function printConfigValue(value: unknown): void {
 export function registerConfigCommand(cli: CAC): void {
   cli
     .command("config [...args]", "Manage cli-skill config")
-    .usage("config get [keyPath]\n  cli-skill config set <keyPath> <value>")
+    .usage("config get [keyPath]\n  cli-skill config set <keyPath> <value>\n  cli-skill config unset <keyPath>")
     .action(async (args: string[] = []) => {
       const [subcommand, keyPath, rawValue] = args;
+      let currentSkillName: string | null = null;
+
+      try {
+        currentSkillName = (await getCurrentSkillProject()).skillName;
+      } catch {}
+
+      const scopedKeyPath = currentSkillName && keyPath
+        ? `skillConfig.${currentSkillName}.${keyPath}`
+        : currentSkillName
+          ? `skillConfig.${currentSkillName}`
+          : keyPath;
 
       if (subcommand === "get") {
         const currentConfig = await loadBrowserSkillCliConfig();
-        const value = getConfigValue(currentConfig, keyPath);
+        const value = getConfigValue(currentConfig, scopedKeyPath);
         printConfigValue(value);
         return;
       }
@@ -42,12 +55,28 @@ export function registerConfigCommand(cli: CAC): void {
         }
 
         const currentConfig = await loadBrowserSkillCliConfig();
-        const nextConfig = setConfigValue(currentConfig, keyPath, parseConfigCliValue(rawValue));
+        const nextConfig = setConfigValue(
+          currentConfig,
+          scopedKeyPath!,
+          parseConfigCliValue(rawValue),
+        );
+        await saveBrowserSkillCliConfig(nextConfig);
+        console.log(getBrowserSkillConfigPath());
+        return;
+      }
+
+      if (subcommand === "unset") {
+        if (!keyPath) {
+          throw new Error("Usage: cli-skill config unset <keyPath>");
+        }
+
+        const currentConfig = await loadBrowserSkillCliConfig();
+        const nextConfig = unsetConfigValue(currentConfig, scopedKeyPath!);
         await saveBrowserSkillCliConfig(nextConfig);
         console.log(getBrowserSkillConfigPath());
         return;
       }
 
-      throw new Error("Usage: cli-skill config get [keyPath] | cli-skill config set <keyPath> <value>");
+      throw new Error("Usage: cli-skill config get [keyPath] | cli-skill config set <keyPath> <value> | cli-skill config unset <keyPath>");
     });
 }

package/src/commands/create.ts

@@ -1,6 +1,7 @@
 import type { CAC } from "cac";
 import { DEFAULT_TEMPLATE_NAME } from "../constants";
 import { createSkillProject } from "../project";
+import { registerLocalSkillProject } from "../registry";
 
 function resolveTemplateName(templateOption?: string): string {
   return templateOption ?? DEFAULT_TEMPLATE_NAME;
@@ -20,6 +21,7 @@ export function registerCreateCommand(cli: CAC): void {
         options.cliName ?? skillName,
         resolveTemplateName(options.template),
       );
+      await registerLocalSkillProject(targetDir);
       console.log(targetDir);
     });
 }

package/src/commands/install.ts

@@ -2,8 +2,8 @@ import type { CAC } from "cac";
 import https from "node:https";
 import path from "node:path";
 import { installPackageToDirectory } from "../bun";
-import { getInstalledSkillsRoot } from "../constants";
-import { installManagedSkill } from "../registry";
+import { getDefaultSkillsRoot } from "../constants";
+import { registerInstalledSkillProject, setupLocalSkillBins } from "../registry";
 
 interface SearchResultPackage {
   name: string;
@@ -98,23 +98,21 @@ export function registerInstallCommand(cli: CAC): void {
     .alias("i")
     .option("--packageName <packageName>", "Install directly by explicit package name")
     .option("--package-name <packageName>", "Install directly by explicit package name")
-    .option("--skill-root <skillRoot>", "Override the target skill registration directory")
     .action(
       async (
         skillName: string,
-        options: { packageName?: string; "package-name"?: string; skillRoot?: string },
+        options: { packageName?: string; "package-name"?: string },
       ) => {
         const explicitPackageName = options.packageName ?? options["package-name"];
         const { packageSpec, packageName } = await resolveInstallTarget(skillName, explicitPackageName);
 
-        const installedSkillsRoot = await getInstalledSkillsRoot();
-        const installDir = path.join(installedSkillsRoot, packageName.replaceAll("/", "__"));
+        const skillsRoot = await getDefaultSkillsRoot();
+        const installDir = path.join(skillsRoot, skillName);
         await installPackageToDirectory(packageSpec, installDir);
         const packageDir = path.join(installDir, "node_modules", packageName);
-        const targetPath = await installManagedSkill(packageName, packageSpec, packageDir, {
-          skillRoot: options.skillRoot,
-        });
-        console.log(targetPath);
+        await registerInstalledSkillProject(packageDir);
+        await setupLocalSkillBins(packageDir);
+        console.log(packageDir);
       },
     );
 }

package/src/commands/list.ts

@@ -1,6 +1,6 @@
 import type { CAC } from "cac";
 import os from "node:os";
-import { listBrowserSkills } from "../registry";
+import { listRegisteredSkills } from "../registry";
 
 function pad(value: string, width: number): string {
   return value.padEnd(width, " ");
@@ -21,54 +21,49 @@ function formatPath(value: string): string {
 
 export function registerListCommand(cli: CAC): void {
   cli.command("list", "List local and installed cli skills").action(async () => {
-    const skills = await listBrowserSkills();
+    const skills = await listRegisteredSkills();
     if (skills.length === 0) {
       console.log("无");
       return;
     }
 
     const rows = skills.map((skill) => ({
-      skillName: skill.skillName,
-      source: skill.source === "local" ? "local" : "remote",
+      name: skill.skillName,
       packageName: skill.packageName,
-      active: skill.active ? "yes" : "no",
-      agentPaths: `[${skill.agentPaths.map((agentPath) => formatPath(agentPath)).join(", ")}]`,
+      source: skill.source,
+      mounted: `[${skill.agentPaths.map((agentPath) => formatPath(agentPath)).join(", ")}]`,
     }));
 
     const headers = {
-      skillName: "Skill",
-      source: "Source",
+      name: "Name",
       packageName: "Package",
-      active: "Active",
-      agentPaths: "AgentPaths",
+      source: "Source",
+      mounted: "MountPaths",
     };
 
     const widths = {
-      skillName: Math.max(headers.skillName.length, ...rows.map((row) => row.skillName.length)),
-      source: Math.max(headers.source.length, ...rows.map((row) => row.source.length)),
+      name: Math.max(headers.name.length, ...rows.map((row) => row.name.length)),
       packageName: Math.max(headers.packageName.length, ...rows.map((row) => row.packageName.length)),
-      active: Math.max(headers.active.length, ...rows.map((row) => row.active.length)),
-      agentPaths: Math.max(headers.agentPaths.length, ...rows.map((row) => row.agentPaths.length)),
+      source: Math.max(headers.source.length, ...rows.map((row) => row.source.length)),
+      mounted: Math.max(headers.mounted.length, ...rows.map((row) => row.mounted.length)),
     };
 
     console.log(
       [
-        pad(headers.skillName, widths.skillName),
-        pad(headers.source, widths.source),
+        pad(headers.name, widths.name),
         pad(headers.packageName, widths.packageName),
-        pad(headers.active, widths.active),
-        headers.agentPaths,
+        pad(headers.source, widths.source),
+        headers.mounted,
       ].join("  "),
     );
 
     for (const row of rows) {
       console.log(
         [
-          pad(row.skillName, widths.skillName),
-          pad(row.source, widths.source),
+          pad(row.name, widths.name),
           pad(row.packageName, widths.packageName),
-          pad(row.active, widths.active),
-          row.agentPaths,
+          pad(row.source, widths.source),
+          row.mounted,
         ].join("  "),
       );
     }