@cli-skill/cli 0.0.1-beta.20260402112811 → 0.0.2-beta.20260402145701

package/README.md

@@ -22,6 +22,7 @@
 ```bash
 cli-skill create <skillName> --cli-name <cliName> [--template <templateName>]
 cli-skill list
+cli-skill tools <skillName>
 cli-skill install <skillName> [--packageName <packageName>]
 cli-skill uninstall <packageName>
 cli-skill config get [keyPath]
@@ -70,6 +71,13 @@ cli-skill mount
 - `src/skill/*`
   - 文档模板源目录
 
+模板生成出来的 skill 包会同时依赖：
+
+- `@cli-skill/core`
+  - 运行 skill
+- `@cli-skill/cli`
+  - 在项目目录内调用 `cli-skill build`、`cli-skill mount` 等命令
+
 执行 `cli-skill build` 后会生成：
 
 - `skill/SKILL.md`
@@ -127,3 +135,26 @@ cli-skill mount
 ```bash
 cli-skill install fx --packageName @scope/cli-skill-fx
 ```
+
+## skill bin 的行为
+
+生成出来的 skill 自带一个很薄的 bin。
+
+例如：
+
+```bash
+my-skill list
+my-skill open_page '{"url":"https://example.com"}'
+```
+
+它适合做：
+
+- 查看这个 skill 的 tool 列表
+- 直接执行某个 tool
+
+它不承担项目管理命令。以下操作仍然只通过 `cli-skill` 使用：
+
+- `build`
+- `mount`
+- `unmount`
+- `publish`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cli-skill/cli",
-  "version": "0.0.1-beta.20260402112811",
+  "version": "0.0.2-beta.20260402145701",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -17,9 +17,9 @@
     "test": "tsc -p tsconfig.test.json && bun test ./test"
   },
   "dependencies": {
-    "@cli-skill/core": "^0.0.1-beta.20260402112811",
+    "@cli-skill/core": "^0.0.2-beta.20260402145701",
     "cac": "^6.7.14",
     "lodash": "^4.17.21",
-    "zod": "^3.25.76"
+    "zod": "^4.3.6"
   }
 }

package/skill/SKILL.md

@@ -28,6 +28,7 @@ description: 当任务涉及 cli skill 的创建、挂载、安装、发布或
 - 平台命令
   - `cli-skill create`
   - `cli-skill list`
+  - `cli-skill tools <skill-name>`
   - `cli-skill install`
   - `cli-skill uninstall`
   - `cli-skill config ...`
@@ -40,7 +41,14 @@ description: 当任务涉及 cli skill 的创建、挂载、安装、发布或
 - 已注册 skill 执行命令
   - `cli-skill exec <skill-name> ...`
 
-skill 自己的 bin 只是一个转发入口，最终会落到 `cli-skill exec <skill-name> ...`。
+skill 自己的 bin 只是一个转发入口：
+
+- `skill-name list`
+  - 查看这个 skill 的 tools
+- `skill-name <tool>`
+  - 执行这个 skill 的 tool
+
+项目级命令仍然通过 `cli-skill` 使用，不通过 skill bin 使用。
 
 ## 默认流程
 
@@ -84,6 +92,7 @@ cli-skill mount
 | --- | --- |
 | 创建 skill | `cli-skill create <skill-name> --cli-name <cli-name> [--template <templateName>]` |
 | 查看 skill 列表 | `cli-skill list` |
+| 查看已注册 skill 的 tool 列表 | `cli-skill tools <skill-name>` |
 | 安装已发布 skill | `cli-skill install <skill-name>` |
 | 卸载已发布 skill | `cli-skill uninstall <package-name>` |
 | 查看 tool 列表 | `cli-skill tools` |
@@ -109,6 +118,10 @@ cli-skill mount
 - `mount` 不应隐式执行 `install`。
 - `install` / `uninstall` 面向已发布 skill。
 - `publish` 只针对当前目录的本地 skill。
+- skill bin 只负责：
+  - `list`
+  - 直接执行 tool
+  - `config get/set/unset`
 
 默认目录：
 
@@ -156,4 +169,5 @@ cli-skill build
 - 不要把 `create` 当成“已经可执行”
 - 不要手动改 `~/.agents/skills`
 - 不要把 skill bin 当成独立平台
+- 不要期待 skill bin 提供 `build` / `mount` / `publish`
 - 不要在修改已有 skill 时重新 `create`

package/skill/references/core.md

@@ -67,6 +67,8 @@ cli-skill build
 
 也就是说，skill 只做“组织”和“说明”，不直接承担运行时能力注入。
 
+命令解析也不在 `core`。`core` 只负责类型、runtime、tool 执行。
+
 ## `defineTool` 负责什么
 
 `defineTool` 才是运行能力的核心。
@@ -211,6 +213,8 @@ export default defineSkill({
 
 这也是为什么生成出来的 skill 模板会把 `zod` 放在自己的 `dependencies` 里。
 
+skill 项目默认只依赖 `@cli-skill/core`。平台 CLI 通过全局安装的 `cli-skill` 提供，不会再写进模板依赖里。
+
 ## 什么时候继续往下看
 
 如果你需要的是：

package/src/build.ts

@@ -1,6 +1,6 @@
 import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { type ZodRawShape, type ZodTypeAny } from "zod";
+import { type ZodTypeAny } from "zod";
 import type { SkillDefinition } from "@cli-skill/core";
 
 interface FieldInfo {
@@ -15,27 +15,39 @@ interface DocRow {
   notes: string;
 }
 
+type ShapeLike = Record<string, ZodTypeAny>;
+
+function getSchemaDef(schema: ZodTypeAny): Record<string, unknown> | undefined {
+  return (schema as ZodTypeAny & { _def?: Record<string, unknown>; def?: Record<string, unknown> })._def
+    ?? (schema as ZodTypeAny & { def?: Record<string, unknown> }).def;
+}
+
 function unwrapField(schema: ZodTypeAny): FieldInfo {
   let current = schema;
   let optional = false;
   let defaultValue: unknown;
 
   while (true) {
-    if (current?._def?.typeName === "ZodOptional") {
+    const def = getSchemaDef(current);
+    const typeName = def?.typeName;
+    const type = def?.type;
+
+    if ((typeName === "ZodOptional" || type === "optional") && def?.innerType) {
       optional = true;
-      current = current._def.innerType;
+      current = def.innerType as ZodTypeAny;
       continue;
     }
 
-    if (current?._def?.typeName === "ZodDefault") {
+    if ((typeName === "ZodDefault" || type === "default") && def?.innerType) {
       optional = true;
-      defaultValue = current._def.defaultValue();
-      current = current._def.innerType;
+      const rawDefault = def.defaultValue;
+      defaultValue = typeof rawDefault === "function" ? rawDefault() : rawDefault;
+      current = def.innerType as ZodTypeAny;
       continue;
     }
 
-    if (current?._def?.typeName === "ZodNullable") {
-      current = current._def.innerType;
+    if ((typeName === "ZodNullable" || type === "nullable") && def?.innerType) {
+      current = def.innerType as ZodTypeAny;
       continue;
     }
 
@@ -46,25 +58,30 @@ function unwrapField(schema: ZodTypeAny): FieldInfo {
 }
 
 function getTypeName(schema: ZodTypeAny): string | undefined {
-  return schema?._def?.typeName;
+  const def = getSchemaDef(schema);
+  return (def?.typeName as string | undefined) ?? (def?.type as string | undefined);
 }
 
-function getObjectShape(schema: ZodTypeAny): ZodRawShape | null {
-  if (getTypeName(schema) !== "ZodObject") {
+function getObjectShape(schema: ZodTypeAny): ShapeLike | null {
+  const typeName = getTypeName(schema);
+  if (typeName !== "ZodObject" && typeName !== "object") {
     return null;
   }
 
   const objectSchema = schema as ZodTypeAny & {
-    _def: { shape?: (() => ZodRawShape) | ZodRawShape };
-    shape?: ZodRawShape;
+    _def?: { shape?: (() => ShapeLike) | ShapeLike };
+    def?: { shape?: (() => ShapeLike) | ShapeLike };
+    shape?: ShapeLike;
   };
+  const def = getSchemaDef(objectSchema);
+  const shapeValue = def?.shape as (() => ShapeLike) | ShapeLike | undefined;
 
-  if (typeof objectSchema._def.shape === "function") {
-    return objectSchema._def.shape();
+  if (typeof shapeValue === "function") {
+    return shapeValue();
   }
 
-  if (objectSchema._def.shape) {
-    return objectSchema._def.shape;
+  if (shapeValue) {
+    return shapeValue;
   }
 
   return objectSchema.shape ?? null;
@@ -87,21 +104,32 @@ function describeType(schema: ZodTypeAny): string {
     return "boolean";
   }
 
-  if (typeName === "ZodLiteral") {
-    return JSON.stringify(base._def.value);
+  const def = getSchemaDef(base);
+
+  if (typeName === "ZodLiteral" || typeName === "literal") {
+    const values = def?.values;
+    if (Array.isArray(values) && values.length === 1) {
+      return JSON.stringify(values[0]);
+    }
+
+    return JSON.stringify(def?.value);
   }
 
-  if (typeName === "ZodEnum") {
-    return (base as ZodTypeAny & { options: string[] }).options
-      .map((item: string) => JSON.stringify(item))
+  if (typeName === "ZodEnum" || typeName === "enum") {
+    const entries = (def?.entries as Record<string, string> | undefined)
+      ?? ((base as ZodTypeAny & { options?: string[] }).options
+        ? Object.fromEntries(((base as ZodTypeAny & { options: string[] }).options).map((item) => [item, item]))
+        : undefined);
+    return Object.values(entries ?? {})
+      .map((item) => JSON.stringify(item))
       .join(" | ");
   }
 
-  if (typeName === "ZodArray") {
-    return `array<${describeType(base._def.type)}>`;
+  if (typeName === "ZodArray" || typeName === "array") {
+    return `array<${describeType((def?.type ?? def?.element) as ZodTypeAny)}>`;
   }
 
-  if (typeName === "ZodObject") {
+  if (typeName === "ZodObject" || typeName === "object") {
     return "object";
   }
 
@@ -123,7 +151,7 @@ function describeNotes(schema: ZodTypeAny): string {
   return notes.join("; ");
 }
 
-function collectShapeRows(shape: ZodRawShape, prefix = ""): DocRow[] {
+function collectShapeRows(shape: ShapeLike, prefix = ""): DocRow[] {
   const rows: DocRow[] = [];
 
   for (const [key, schema] of Object.entries(shape)) {
@@ -180,7 +208,7 @@ function renderTable(headers: string[], rows: string[][]): string {
 }
 
 function renderConfigSection(skill: SkillDefinition): string {
-  const rows = collectShapeRows(skill.config).map((row) => [row.path, row.type, row.notes || ""]);
+  const rows = collectShapeRows(skill.config as ShapeLike).map((row) => [row.path, row.type, row.notes || ""]);
   return renderTable(["字段", "类型", "说明"], rows.length > 0 ? rows : [["-", "-", "-"]]);
 }
 

package/src/commands/skill.ts

@@ -1,5 +1,5 @@
 import type { CAC } from "cac";
-import { runCli } from "@cli-skill/core";
+import { listTools, runTool } from "@cli-skill/core";
 import { writeSkillDocsMarkdown } from "../build";
 import { runBunStreaming } from "../bun";
 import { loadSkillDefinition } from "../project";
@@ -16,16 +16,14 @@ export function registerSkillCommands(cli: CAC): void {
     .action(async (skillName: string, toolName: string, rawInput?: string) => {
       const resolved = await resolveRegisteredSkillProject(skillName);
       const skill = await loadSkillDefinition(resolved.projectPath);
-      const exitCode = await runCli(skill, ["run", toolName, ...(typeof rawInput === "string" ? [rawInput] : [])], {
-        rootDir: resolved.projectPath,
-      });
+      const exitCode = await runTool(skill, toolName, rawInput, { rootDir: resolved.projectPath });
       process.exitCode = exitCode;
     });
 
-  cli.command("tools", "List tools in the current cli skill project").action(async () => {
-    const resolved = await getCurrentSkillProject();
+  cli.command("tools [skillName]", "List tools in the current cli skill project or a registered cli skill").action(async (skillName?: string) => {
+    const resolved = skillName ? await resolveRegisteredSkillProject(skillName) : await getCurrentSkillProject();
     const skill = await loadSkillDefinition(resolved.projectPath);
-    const exitCode = await runCli(skill, ["list"], { rootDir: resolved.projectPath });
+    const exitCode = await listTools(skill, { rootDir: resolved.projectPath });
     process.exitCode = exitCode;
   });
 
@@ -34,9 +32,7 @@ export function registerSkillCommands(cli: CAC): void {
     .action(async (toolName: string, rawInput?: string) => {
       const resolved = await getCurrentSkillProject();
       const skill = await loadSkillDefinition(resolved.projectPath);
-      const exitCode = await runCli(skill, ["run", toolName, ...(typeof rawInput === "string" ? [rawInput] : [])], {
-        rootDir: resolved.projectPath,
-      });
+      const exitCode = await runTool(skill, toolName, rawInput, { rootDir: resolved.projectPath });
       process.exitCode = exitCode;
     });
 

package/src/commands/uninstall.ts

@@ -3,6 +3,16 @@ import { rm } from "node:fs/promises";
 import path from "node:path";
 import { resolveRegisteredSkillProject, removeRegistryEntry, unregisterProjectBins } from "../registry";
 
+function getInstalledSkillRoot(projectPath: string): string {
+  const segments = projectPath.split(path.sep);
+  const nodeModulesIndex = segments.lastIndexOf("node_modules");
+  if (nodeModulesIndex === -1) {
+    return projectPath;
+  }
+
+  return segments.slice(0, nodeModulesIndex).join(path.sep) || path.sep;
+}
+
 export function registerUninstallCommand(cli: CAC): void {
   cli
     .command("uninstall <packageName>", "Uninstall a managed cli skill")
@@ -13,7 +23,9 @@ export function registerUninstallCommand(cli: CAC): void {
       for (const agentPath of resolved.agentPaths) {
         await rm(agentPath, { recursive: true, force: true });
       }
-      await rm(path.join(resolved.projectPath, "..", ".."), { recursive: true, force: true });
+      if (resolved.source === "installed") {
+        await rm(getInstalledSkillRoot(resolved.projectPath), { recursive: true, force: true });
+      }
       await removeRegistryEntry(skillName);
       console.log(resolved.projectPath);
     });