skill-market-cli 1.0.1 → 1.1.1

package/src/index.js

@@ -9,36 +9,71 @@ const upload = require('./commands/upload');
 const update = require('./commands/update');
 const remove = require('./commands/delete');
 const runExample = require('./commands/run-example');
+const token = require('./commands/token');
 const { getConfig } = require('./auth/token-store');
+const { applyServerMode, getServerModesHelp } = require('./config/server-modes');
+const apiClient = require('./api/client');
 
 const program = new Command();
 
 program
   .name('skill-market-cli')
-  .description('CLI tool for managing skills on Skill Market')
+  .description(`Skill Market 命令行：管理技能与登录
+
+全局网络（对所有子命令生效）：
+  --mode <环境>   ${getServerModesHelp()}
+                 未指定时优先使用 ~/.skill-market-cli/config.json 中保存的环境（登录后写入），否则为 production。
+
+示例：
+  skill-market-cli --mode development login
+  skill-market-cli login --mode development
+  node bin/skill-market-cli.js list --mode development`)
   .version(pkg.version, '-v, --version')
   .option('-c, --config <path>', 'config file path')
-  .hook('preAction', (thisCommand) => {
-    // 显示欢迎信息
-    const config = getConfig();
-    if (config.user && thisCommand.args[0] !== 'login') {
-      console.log(chalk.gray(`Logged in as: ${config.user.name}`));
-    }
-  });
+  .option('--mode <environment>', getServerModesHelp());
+
+program.hook('preAction', () => {
+  const opts = program.opts();
+  const config = getConfig();
+  const effectiveMode =
+    opts.mode !== undefined && opts.mode !== null && opts.mode !== ''
+      ? opts.mode
+      : (config.mode || 'production');
+  try {
+    applyServerMode(effectiveMode);
+    apiClient.reinit();
+  } catch (e) {
+    console.error(chalk.red(e.message));
+    process.exit(1);
+  }
+});
+
+program.hook('preAction', (thisCommand) => {
+  const config = getConfig();
+  if (config.user && thisCommand.args[0] !== 'login') {
+    console.log(chalk.gray(`已登录：${config.user.name}`));
+  }
+});
 
 // Login command
 program
   .command('login')
-  .description('Login to Skill Market')
-  .option('--no-open', 'Do not open browser automatically')
+  .description('浏览器 OAuth 登录（使用全局 --mode 指向的环境）')
+  .option('--no-open', '不自动打开浏览器，仅打印授权链接')
   .action(login);
 
 // Logout command
 program
   .command('logout')
-  .description('Logout from Skill Market')
+  .description('清除本地登录状态并尝试撤销服务端令牌')
   .action(logout);
 
+// Token command
+program
+  .command('token [subcommand] [value]')
+  .description('管理 Personal Access Token（用于 CLI 免登录）')
+  .action(token);
+
 // List command
 program
   .command('list')
@@ -54,11 +89,12 @@ program
 program
   .command('upload <path>')
   .alias('up')
-  .description('Upload a new skill')
+  .description('上传 Skill（交互补全字段；用户案例 + 自动采集轨迹后提交 AI 渠道）')
   .option('-n, --name <name>', 'Skill name')
   .option('-d, --description <desc>', 'Skill description/purpose')
   .option('-t, --tags <tags>', 'Tags (comma separated)')
   .option('-m, --model <model>', 'Recommended model')
+  .option('-y, --yes', '非交互：跳过最终确认，适合脚本/CI')
   .action(upload);
 
 // Update command
@@ -100,7 +136,7 @@ program
     if (fs.existsSync(guidePath)) {
       console.log(fs.readFileSync(guidePath, 'utf-8'));
     } else {
-      console.log(chalk.yellow('Guide not found. Please visit https://kirigaya.cn/ktools/skillmanager'));
+      console.log(chalk.yellow('未找到本地指南，请访问：https://kirigaya.cn/ktools/skillmanager'));
     }
   });
 

package/src/lib/run-example-collect.js

@@ -0,0 +1,44 @@
+const chalk = require('chalk');
+
+/**
+ * 对用户 prompt 执行一次「示例运行」，采集 AI 侧轨迹（thinking / toolcall / message）。
+ * 生产环境可替换为真实模型 API；当前为可预测的模拟数据，便于联调。
+ */
+async function runExampleAndCollect(prompt, model) {
+  const modelLabel = model && String(model).trim() ? String(model).trim() : 'default';
+
+  console.log(chalk.gray('\n正在运行用户案例以采集轨迹与输出…'));
+  console.log(chalk.gray(`推荐模型：${modelLabel}`));
+
+  const simulatedResponses = [
+    {
+      type: 'thinking',
+      content: `分析用户请求：「${prompt}」。将拆解步骤并调用合适工具完成目标。`
+    },
+    {
+      type: 'toolcall',
+      toolName: 'read_file',
+      toolInput: { path: './README.md' }
+    },
+    {
+      type: 'toolcall',
+      toolName: 'write_file',
+      toolInput: {
+        path: './output.txt',
+        content: `已处理：${prompt}`
+      }
+    },
+    {
+      type: 'message',
+      content: `已根据你的请求完成处理：「${prompt}」。\n\n步骤摘要：\n1. 理解需求\n2. 读取上下文\n3. 生成结果\n\n以上为演示轨迹，上传时将一并提交。`
+    }
+  ];
+
+  await new Promise((resolve) => setTimeout(resolve, 400));
+
+  console.log(chalk.gray(`已采集 ${simulatedResponses.length} 条轨迹节点（thinking / toolcall / message）。`));
+
+  return simulatedResponses;
+}
+
+module.exports = { runExampleAndCollect };

package/src/lib/skill-upload-helpers.js

@@ -0,0 +1,77 @@
+const fs = require('fs-extra');
+const path = require('path');
+const YAML = require('yaml');
+
+/**
+ * 解析 SKILL.md：frontmatter + ## Usage Examples 下简单分块（仅 prompt 文本）
+ */
+function parseSkillMarkdown(content) {
+  let frontmatter = null;
+  let examples = [];
+
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/);
+  if (frontmatterMatch) {
+    try {
+      frontmatter = YAML.parse(frontmatterMatch[1]);
+    } catch {
+      // ignore
+    }
+  }
+
+  const examplesMatch = content.match(/## Usage Examples?\s*\n([\s\S]*?)(?=##|$)/i);
+  if (examplesMatch) {
+    const exampleText = examplesMatch[1];
+    const exampleBlocks = exampleText.split(/\n\n+/).filter((b) => b.trim());
+    examples = exampleBlocks.map((block) => {
+      const lines = block.split('\n').filter((l) => l.trim());
+      return { prompt: lines.join('\n') };
+    });
+  }
+
+  return { frontmatter, examples };
+}
+
+/**
+ * 读取 run-example 生成的 .skill-examples.json，转为接口所需 usageExamples
+ */
+function loadDotSkillExamples(skillDir) {
+  const filePath = path.join(skillDir, '.skill-examples.json');
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+  try {
+    const data = fs.readJsonSync(filePath);
+    if (!data || !Array.isArray(data.examples)) {
+      return null;
+    }
+    return data.examples.map((ex) => ({
+      prompt: ex.prompt,
+      aiResponses: ex.aiResponses || [],
+      model: ex.model || data.model || ''
+    }));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 将仅有 prompt 的条目补全为完整 UsageExample（可选采集轨迹）
+ */
+function promptOnlyExamples(examples) {
+  if (!examples || !examples.length) {
+    return [];
+  }
+  return examples
+    .map((ex) => ({
+      prompt: (ex.prompt || '').trim(),
+      aiResponses: ex.aiResponses,
+      model: ex.model
+    }))
+    .filter((ex) => ex.prompt);
+}
+
+module.exports = {
+  parseSkillMarkdown,
+  loadDotSkillExamples,
+  promptOnlyExamples
+};

package/src/skills/skill-market-upload/.skill-examples.json

@@ -0,0 +1,26 @@
+{
+  "model": "deepseek-chat",
+  "examples": [
+    {
+      "prompt": "请根据我仓库里的 SKILL.md 帮我执行上传，并告诉我你要确认哪些字段。",
+      "aiResponses": [
+        {
+          "type": "thinking",
+          "content": "用户要用 skill-market-cli 上传 SKILL。需先读 frontmatter，核对 name、描述、tags、model、rootUrl；至少一条用户案例与 thinking/toolcall/message 轨迹；再执行 upload 交互或脚本。"
+        },
+        {
+          "type": "toolcall",
+          "toolName": "read_file",
+          "toolInput": {
+            "path": "./SKILL.md"
+          }
+        },
+        {
+          "type": "message",
+          "content": "我会先读取 `SKILL.md` 的 frontmatter，列出缺失项；请你确认一条「最终用户会如何提问」的测试案例。然后运行 `skill-market-cli upload <skill 目录>`，在交互中补全字段并自动采集轨迹后提交到 Skill Market。"
+        }
+      ],
+      "model": "deepseek-chat"
+    }
+  ]
+}

package/src/skills/skill-market-upload/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: skill-market-upload
+purpose: 指导 AI Agent 使用 skill-market-cli 将本地 SKILL 上传至 Skill Market，含用户案例与轨迹采集要求
+tags:
+  - skill-market
+  - cli
+  - upload
+model: deepseek-chat
+rootUrl: https://raw.githubusercontent.com/LSTM-Kirigaya/skill-market-cli/refs/heads/main/src/skills/skill-market-upload/SKILL.md
+---
+
+# Skill Market 上传助手（给 AI Agent 用）
+
+本说明面向 **代表用户操作终端的 AI Agent**。目标：在已登录 `skill-market-cli` 的前提下，通过 **`skill-market-cli upload`** 完成上传，并满足服务端对 **AI 渠道** 的必填规则。
+
+## 你必须知道的约束
+
+1. **登录**：用户须先执行 `skill-market-cli login`（可用 `--mode development` 指向本地）。凭证在 `~/.skill-market-cli/config.json`。
+2. **上传走 AI 渠道**：CLI 使用 `POST /api/skill/ai/upload`，要求 **全部字段非空**，且 **`tags`、`usageExamples` 不得为空数组**。
+3. **用户案例（必填）**：`usageExamples` 中每一项必须包含：
+   - **`prompt`**：终端用户会如何向该 Skill 提问（由用户或你根据上下文代写，但必须经用户确认）。
+   - **`aiResponses`**：一次「示例运行」采集到的轨迹（thinking / toolcall / message）。上传命令会在本地 **自动调用采集逻辑** 生成（当前为可替换的模拟实现，结构需与后端一致）。
+   - **`model`**：推荐模型名（如 `deepseek-chat`）。
+4. **无法仅从文件推断的字段**：若 SKILL.md 未写全，上传流程会 **交互询问**：名称、描述、标签、`rootUrl`、推荐模型等。Agent 应结合仓库上下文、README、用户口述 **帮用户预填**，并在询问环节确认。
+
+## 推荐工作流（Agent）
+
+1. 确认仓库中存在 **`SKILL.md`**（目录则路径指向该目录）。
+2. 读取 frontmatter，整理候选：`name`、`purpose`/`description`、`tags`、`model`、`rootUrl`。
+3. 与用户确认 **至少一条「用户会如何提问」的测试案例**（可多轮补充）。案例文本即 `prompt`。
+4. 在终端执行上传（勿省略路径）：
+   ```bash
+   skill-market-cli upload <path-to-skill-dir-or-SKILL.md>
+   ```
+5. 按 CLI 提示补全缺失字段；当提示采集轨迹时，**允许命令自动运行**（会调用内置采集器写入 `aiResponses`）。
+6. 上传成功后，CLI 会在技能目录写入 **`.skill-examples.json`**，便于复查与再次上传。
+
+## 与 `run-example` 的关系
+
+- 可先运行 `skill-market-cli run-example <path>` 预采集，生成 `.skill-examples.json`；再执行 `upload` 时会 **自动合并** 该文件。
+- 若未预先运行，`upload` 会引导用户 **逐条输入案例并自动采集轨迹**，无需用户手动拼 JSON。
+
+## 禁止事项
+
+- 不要编造不存在的 Git 仓库 URL；`rootUrl` 可用 `file:///...` 指向本地 `SKILL.md` 的绝对路径（CLI 默认值），或用户提供的 raw URL。
+- 不要跳过「用户案例」；没有案例与轨迹，AI 渠道上传会失败。
+
+## Usage Examples
+
+### Example 1
+
+**User:** 请根据我仓库里的 SKILL.md 帮我执行上传，并告诉我你要确认哪些字段。
+
+**AI:** 我会先读取 `SKILL.md` 的 frontmatter，列出缺失的 name、描述、标签、模型与 rootUrl；请你至少提供一条「最终用户会对该 Skill 说的话」作为测试案例。然后我在终端运行 `skill-market-cli upload .`，在交互中替你填入并确认，自动完成轨迹采集后提交。