yingmi-skill-cli 0.0.2 → 0.0.6

package/README.md

@@ -1,4 +1,4 @@
-# `yingmi-cli`
+# `yingmi-skill-cli`
 
 一个面向 Agent 的 CLI，用来统一盈米 MCP 能力发现、初始化配置、远端 skill 管理和版本升级。
 
@@ -17,44 +17,50 @@
 CLI 聚焦 5 个核心模块：
 
 - `init`：让 CLI 首次可用，负责配置写入、环境检查和连通性验证
-- `mcp`：浏览 MCP 摘要、查看某个工具的完整 OpenAPI 定义，并发起工具调用
-- `remote-skill`：列出可用 skill，进入某个 skill 上下文查看目录结构，并可在该目录执行脚本
+- `mcp`：浏览原子金融能力摘要、查看某个工具的完整 OpenAPI 定义，并发起工具调用
+- `remote-skill`：列出可用金融场景 skill，进入某个 skill 上下文，先阅读 skill 说明，再执行约定脚本
 - `help`：提供显式帮助入口，并保持与 `--help` 同源
 - `upgrade`：检查版本并升级 CLI
 
 这套划分的核心原则是：先初始化，再发现能力，再查看定义，再执行调用或远端脚本，让命令树围绕统一心智模型组织。
 
+`mcp` 和 `remote-skill` 的边界不是按“复杂度高低”区分，而是按“能力层级”区分：
+
+- `mcp` 是原子能力层，适合已知要调用哪个工具、并且能明确构造 JSON 输入的场景
+- `remote-skill` 是金融场景编排层，适合基金分析、组合诊断、财富规划、市场简报等完整任务
+- `remote-skill` 内部可以按需调用一个或多个 `mcp`
+
 ## 安装
 
 ```bash
-npm install -g yingmi-cli
+npm install -g yingmi-skill-cli
 ```
 
-安装后可通过 `yingmi-cli` 命令使用。
+安装后可通过 `yingmi-skill-cli` 命令使用。
 
 ## 命令树
 
 ```bash
-yingmi-cli init setup
-yingmi-cli init setup --api-key <value>
-yingmi-cli init setup --phone <value>
-yingmi-cli init setup --verify-code <value>
-yingmi-cli init status
-yingmi-cli init doctor
-
-yingmi-cli mcp list
-yingmi-cli mcp schema <toolName>
-yingmi-cli mcp call <toolName> --input <json>
-
-yingmi-cli remote-skill list
-yingmi-cli remote-skill enter <skillName>
-yingmi-cli remote-skill exec --script <script>
-yingmi-cli remote-skill exec --script-file <path>
-
-yingmi-cli help [command]
-
-yingmi-cli upgrade
-yingmi-cli upgrade --check-only
+yingmi-skill-cli init setup
+yingmi-skill-cli init setup --api-key <value>
+yingmi-skill-cli init setup --phone <value>
+yingmi-skill-cli init setup --verify-code <value>
+yingmi-skill-cli init status
+yingmi-skill-cli init doctor
+
+yingmi-skill-cli mcp list
+yingmi-skill-cli mcp schema <toolName>
+yingmi-skill-cli mcp call <toolName> --input <json>
+
+yingmi-skill-cli remote-skill list
+yingmi-skill-cli remote-skill enter <skillName>
+yingmi-skill-cli remote-skill exec --script <script>
+yingmi-skill-cli remote-skill exec --script-file <path>
+
+yingmi-skill-cli help [command]
+
+yingmi-skill-cli upgrade
+yingmi-skill-cli upgrade --check-only
 ```
 
 ## 模块说明
@@ -66,11 +72,11 @@ yingmi-cli upgrade --check-only
 常用命令：
 
 ```bash
-yingmi-cli init setup --api-key <value>
-yingmi-cli init setup --phone <手机号>
-yingmi-cli init setup --verify-code <验证码>
-yingmi-cli init status
-yingmi-cli init doctor
+yingmi-skill-cli init setup --api-key <value>
+yingmi-skill-cli init setup --phone <手机号>
+yingmi-skill-cli init setup --verify-code <验证码>
+yingmi-skill-cli init status
+yingmi-skill-cli init doctor
 ```
 
 行为约束：
@@ -82,14 +88,14 @@ yingmi-cli init doctor
 
 ### `mcp`
 
-`mcp` 负责“发现能力、理解能力、执行能力”三个阶段。
+`mcp` 负责“发现原子能力、理解能力定义、执行单次调用”三个阶段。
 
 常用命令：
 
 ```bash
-yingmi-cli mcp list
-yingmi-cli mcp schema getFundCampisiIndicator
-yingmi-cli mcp call getFundCampisiIndicator --input '{"fundCode":"000001","timePeriod":"LAST_YEAR"}'
+yingmi-skill-cli mcp list
+yingmi-skill-cli mcp schema getFundCampisiIndicator
+yingmi-skill-cli mcp call getFundCampisiIndicator --input '{"fundCode":"000001","timePeriod":"LAST_YEAR"}'
 ```
 
 行为约束：
@@ -97,44 +103,48 @@ yingmi-cli mcp call getFundCampisiIndicator --input '{"fundCode":"000001","timeP
 - `mcp list`：展示工具摘要，默认优先结构化结果
 - `mcp schema <toolName>`：展示某个工具的完整 OpenAPI 定义
 - `mcp call <toolName>`：调用目标工具，支持 `--input` 和 `--input-file`
+- `mcp` 适合直接取数、单次计算、单个分析接口调用，不适合直接承载完整金融场景工作流
 - 输出协议必须稳定，stdout 只承载结果，stderr 承载提示与错误
 
 ### `remote-skill`
 
-`remote-skill` 面向远端 skill 运行服务，核心是“发现 skill 并进入 skill 上下文工作”。
+`remote-skill` 面向远端 skill 运行服务，核心是“发现 skill、进入 skill 上下文，并按 skill 协议完成金融场景任务”。
 
 常用命令：
 
 ```bash
-yingmi-cli remote-skill list
-yingmi-cli remote-skill enter fund-analyzer
-yingmi-cli remote-skill exec --script 'node index.js'
-yingmi-cli remote-skill exec --script-file ./scripts/run.sh
+yingmi-skill-cli remote-skill list
+yingmi-skill-cli remote-skill enter fund-analyzer
+yingmi-skill-cli remote-skill exec --script 'cat SKILL.md'
+yingmi-skill-cli remote-skill exec --script 'python main.py'
+yingmi-skill-cli remote-skill exec --script-file ./scripts/run.sh
 ```
 
 行为约束：
 
 - `list`：调用远端 `/api/get-skills` 接口，使用本地 `apiKey` 作为请求头
-- `enter <skillName>`：每次都会重新调用远端 `/api/get-skill-by-name` 获取压缩包地址，下载并解压到 `~/.yingmi-cli/skills/<skillName>` 后输出本地工作目录和文件清单，并把当前 skill 上下文写入本地配置
-- `exec --script/--script-file`：只能在最近一次成功 `enter` 后使用，在当前 skill 目录执行脚本，并输出执行状态、退出码、stdout 和 stderr
-- 远端服务地址默认读取 `https://stargate-staging.yingmi-inc.com/`，也可在 `~/.yingmi-cli/config.json` 里手工设置 `remoteSkillServerBaseUrl`
+- `enter <skillName>`：每次都会重新调用远端 `/api/get-skill-by-name` 获取压缩包地址，下载并解压到 `~/.yingmi-skill-cli/skills/<skillName>` 后输出目录树，并把当前 skill 上下文写入本地配置
+- `exec --script/--script-file`：只能在最近一次成功 `enter` 后使用，建议先执行 `cat SKILL.md` 理解 skill 约定，再在当前 skill 目录执行入口脚本；执行结果输出状态、退出码、stdout 和 stderr，不额外回传本地工作目录路径
+- `remote-skill` 适合基金分析、组合诊断、财富规划、市场简报等场景任务；skill 内部可以继续调用多个 `mcp`
+- 远端服务地址默认读取 `https://stargate-staging.yingmi-inc.com/`，也可在 `~/.yingmi-skill-cli/config.json` 里手工设置 `remoteSkillServerBaseUrl`
 
 ### `help`
 
-`help` 是显式帮助入口，用来补足 `--help` 之外的可发现性。
+`help` 是显式帮助入口，用来补足 `--help` 之外的可发现性，并承担按任务导航的职责。
 
 常用命令：
 
 ```bash
-yingmi-cli help
-yingmi-cli help mcp
-yingmi-cli mcp --help
+yingmi-skill-cli help
+yingmi-skill-cli help mcp
+yingmi-skill-cli mcp --help
 ```
 
 约束：
 
 - `help` 和 `--help` 必须共用同一套命令元数据
-- 每个命令帮助都应包含 2 到 3 个最常见示例
+- 根帮助优先回答“该去哪个模块”，模块帮助优先说明推荐顺序，叶子命令帮助优先说明输入规则和常见示例
+- `remote-skill` 默认示例应体现“先读 `SKILL.md`，再执行入口脚本”，不把目录探测命令作为推荐路径
 
 ### `upgrade`
 
@@ -143,8 +153,8 @@ yingmi-cli mcp --help
 常用命令：
 
 ```bash
-yingmi-cli upgrade
-yingmi-cli upgrade --check-only
+yingmi-skill-cli upgrade
+yingmi-skill-cli upgrade --check-only
 ```
 
 约束：
@@ -167,12 +177,11 @@ yingmi-cli upgrade --check-only
 
 推荐使用方式如下：
 
-1. 先执行 `yingmi-cli init setup`，让 CLI 进入可用状态。
-2. 用 `yingmi-cli mcp list` 浏览可用工具。
-3. 用 `yingmi-cli mcp schema <toolName>` 查看完整定义。
-4. 用 `yingmi-cli mcp call <toolName>` 发起调用。
-5. 需要处理远端 skill 时，先用 `yingmi-cli remote-skill list` 发现 skill，再用 `yingmi-cli remote-skill enter <skillName>` 刷新并查看目录，最后用 `yingmi-cli remote-skill exec` 在该上下文执行脚本。
-6. 需要查看帮助或升级时，分别使用 `help` 和 `upgrade`。
+1. 先执行 `yingmi-skill-cli init setup`，让 CLI 进入可用状态。
+2. 如果要直接调用单个原子能力，先用 `yingmi-skill-cli mcp list` 浏览可用工具。
+3. 对于 `mcp`，继续用 `yingmi-skill-cli mcp schema <toolName>` 查看完整定义，再用 `yingmi-skill-cli mcp call <toolName>` 发起调用。
+4. 如果要完成基金分析、组合诊断、财富规划等场景任务，先用 `yingmi-skill-cli remote-skill list` 发现 skill，再用 `yingmi-skill-cli remote-skill enter <skillName>` 进入上下文，随后优先执行 `yingmi-skill-cli remote-skill exec --script 'cat SKILL.md'` 阅读说明，再按 skill 约定执行脚本。
+5. 需要查看帮助或升级时，分别使用 `help` 和 `upgrade`。
 
 ## 当前代码组织
 

package/bin/index.js

@@ -7,12 +7,11 @@ var fs = require('fs');
 var os = require('os');
 var path = require('path');
 var axios = require('axios');
-var puppeteer = require('puppeteer');
 var crypto = require('crypto');
 var child_process = require('child_process');
 
-var name = "yingmi-skill-cli";
-var version = "0.0.2";
+var name = "yingmi-cli";
+var version = "0.0.6";
 
 function fail(message) {
   console.error(message);
@@ -21,22 +20,64 @@ function fail(message) {
 
 function resolveCommand(root, pathSegments) {
   let current = root;
-  pathSegments.forEach((segment) => {
-    current = current?.commands.find((command) => command.name() === segment);
-  });
-  return current;
+  const matchedPath = [];
+  for (const segment of pathSegments) {
+    const nextCommand = current?.commands.find(
+      (command) => command.name() === segment
+    );
+    if (!nextCommand) {
+      return {
+        command: current ?? root,
+        matchedPath,
+        invalidSegment: segment
+      };
+    }
+    current = nextCommand;
+    matchedPath.push(segment);
+  }
+  return {
+    command: current ?? root,
+    matchedPath
+  };
+}
+function formatAvailableCommands(command) {
+  const availableCommands = command.commands.map((item) => item.name());
+  return availableCommands.length > 0 ? availableCommands.join(", ") : "(\u65E0\u53EF\u7528\u5B50\u547D\u4EE4)";
 }
 function registerHelpCommand(program) {
-  program.command("help").description("\u663E\u793A CLI \u6216\u6307\u5B9A\u5B50\u547D\u4EE4\u7684\u5E2E\u52A9\u4FE1\u606F").argument("[commandPath...]", "\u547D\u4EE4\u8DEF\u5F84\uFF0C\u4F8B\u5982: mcp call").action((commandPath) => {
+  program.command("help").description("\u663E\u793A CLI \u6216\u6307\u5B9A\u5B50\u547D\u4EE4\u7684\u5E2E\u52A9\u4FE1\u606F").argument("[commandPath...]", "\u547D\u4EE4\u8DEF\u5F84\uFF0C\u4F8B\u5982: mcp call").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u67E5\u770B\u6839\u547D\u4EE4\u3001\u6A21\u5757\u547D\u4EE4\u6216\u6307\u5B9A\u5B50\u547D\u4EE4\u7684\u5E2E\u52A9\u4FE1\u606F\u3002
+
+\u793A\u4F8B:
+  yingmi-cli help
+  yingmi-cli help init
+  yingmi-cli help mcp
+  yingmi-cli help mcp call
+  yingmi-cli help remote-skill exec
+
+\u8BF4\u660E:
+  - help \u548C --help \u5171\u4EAB\u540C\u4E00\u5957\u547D\u4EE4\u5143\u6570\u636E
+  - \u4E0D\u786E\u5B9A\u8BE5\u770B\u54EA\u4E2A\u6A21\u5757\u65F6\uFF0C\u5148\u6267\u884C yingmi-cli help
+  - \u4E0D\u786E\u5B9A\u8BE5\u7528 mcp \u8FD8\u662F remote-skill \u65F6\uFF0C\u5148\u770B\u5B83\u662F\u5728\u8C03\u7528\u5355\u4E2A\u80FD\u529B\uFF0C\u8FD8\u662F\u5728\u5B8C\u6210\u91D1\u878D\u573A\u666F\u4EFB\u52A1
+  - \u5DF2\u77E5\u76EE\u6807\u6A21\u5757\u65F6\uFF0C\u4F18\u5148\u67E5\u770B\u66F4\u5177\u4F53\u7684\u5B50\u547D\u4EE4\u5E2E\u52A9
+`
+  ).action((commandPath) => {
     if (!commandPath || commandPath.length === 0) {
       program.outputHelp();
       return;
     }
-    const targetCommand = resolveCommand(program, commandPath);
-    if (!targetCommand) {
-      fail(`\u672A\u627E\u5230\u547D\u4EE4: ${commandPath.join(" ")}`);
+    const resolvedCommand = resolveCommand(program, commandPath);
+    if (resolvedCommand.invalidSegment) {
+      const availableCommands = formatAvailableCommands(resolvedCommand.command);
+      const prefix = resolvedCommand.matchedPath.length > 0 ? `\u5DF2\u8BC6\u522B\u524D\u7F00: ${resolvedCommand.matchedPath.join(" ")}` : "\u5DF2\u8BC6\u522B\u524D\u7F00: \u9876\u5C42\u547D\u4EE4";
+      fail(`\u672A\u627E\u5230\u547D\u4EE4: ${commandPath.join(" ")}
+${prefix}
+\u53EF\u7528\u5B50\u547D\u4EE4: ${availableCommands}`);
     }
-    targetCommand.outputHelp();
+    resolvedCommand.command.outputHelp();
   });
 }
 
@@ -44,7 +85,7 @@ const CONFIG_DIR = path.join(os.homedir(), ".yingmi-cli");
 const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 const SKILLS_DIR = path.join(CONFIG_DIR, "skills");
 const DEFAULT_QIEMAN_BASE_URL = "https://qieman.com";
-const DEFAULT_REMOTE_SKILL_SERVER_BASE_URL = "https://stargate-staging.yingmi-inc.com/";
+const DEFAULT_STARGATE_BASE_URL = "https://stargate-staging.yingmi-inc.com/";
 function ensureConfigDir() {
   fs.mkdirSync(CONFIG_DIR, { recursive: true });
 }
@@ -119,9 +160,9 @@ function getSkillsDirPath() {
   fs.mkdirSync(SKILLS_DIR, { recursive: true });
   return SKILLS_DIR;
 }
-function getRemoteSkillServerBaseUrl() {
-  const configuredBaseUrl = readConfig().remoteSkillServerBaseUrl?.trim();
-  return configuredBaseUrl || DEFAULT_REMOTE_SKILL_SERVER_BASE_URL;
+function getStargateBaseUrl() {
+  const configuredBaseUrl = readConfig().stargateBaseUrl?.trim();
+  return configuredBaseUrl || DEFAULT_STARGATE_BASE_URL;
 }
 function getQiemanBaseUrl() {
   const configuredBaseUrl = readConfig().qiemanBaseUrl?.trim();
@@ -253,111 +294,28 @@ function getPendingSetupResult() {
   };
 }
 
-function getHeaderValue(headers, headerName) {
-  const expectedHeaderName = headerName.toLowerCase();
-  const matchedEntry = Object.entries(headers).find(
-    ([currentHeaderName]) => currentHeaderName.toLowerCase() === expectedHeaderName
-  );
-  return matchedEntry?.[1];
-}
-function waitForFirstFetchRequest(page, timeoutMs) {
-  return new Promise((resolve, reject) => {
-    let settled = false;
-    const cleanup = () => {
-      clearTimeout(timer);
-      page.off("request", handleRequest);
-    };
-    const settle = (callback) => {
-      if (settled) {
-        return;
-      }
-      settled = true;
-      cleanup();
-      callback();
-    };
-    const handleRequest = (request) => {
-      if (request.resourceType() !== "fetch") {
-        return;
-      }
-      settle(() => resolve(request));
-    };
-    const timer = setTimeout(() => {
-      settle(() => reject(new Error(`\u5728 ${timeoutMs}ms \u5185\u672A\u6355\u83B7\u5230 fetch \u8BF7\u6C42`)));
-    }, timeoutMs);
-    page.on("request", handleRequest);
-  });
+const DEFAULT_TIMEOUT_MS = 2e4;
+const SKILL_ACCESS_CONFIG_PATH = "/api/skill-access-config";
+function trimTrailingSlash$1(value) {
+  return value.replace(/\/+$/, "");
 }
-
-function getCandidateExecutablePaths() {
-  const homeDirectory = os.homedir();
-  switch (process.platform) {
-    case "darwin":
-      return [
-        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-        "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
-        "/Applications/Chromium.app/Contents/MacOS/Chromium"
-      ];
-    case "win32":
-      return [
-        "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
-        "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
-        "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe",
-        "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe"
-      ];
-    default:
-      return [
-        "/usr/bin/google-chrome",
-        "/usr/bin/google-chrome-stable",
-        "/usr/bin/chromium",
-        "/usr/bin/chromium-browser",
-        `${homeDirectory}/.cache/puppeteer/chrome/linux-*/chrome-linux64/chrome`
-      ];
-  }
+function buildSkillAccessConfigUrl(baseUrl) {
+  return `${trimTrailingSlash$1(baseUrl)}${SKILL_ACCESS_CONFIG_PATH}`;
 }
-function resolveExecutablePath(executablePath) {
-  const customExecutablePath = executablePath?.trim() || process.env.PUPPETEER_EXECUTABLE_PATH?.trim();
-  if (customExecutablePath) {
-    if (!fs.existsSync(customExecutablePath)) {
-      throw new Error(`\u6D4F\u89C8\u5668\u4E0D\u5B58\u5728: ${customExecutablePath}`);
-    }
-    return customExecutablePath;
-  }
-  const matchedPath = getCandidateExecutablePaths().find(
-    (candidatePath) => fs.existsSync(candidatePath)
-  );
-  if (!matchedPath) {
-    throw new Error(
-      "\u672A\u627E\u5230\u53EF\u7528\u7684 Chrome/Chromium\uFF0C\u53EF\u901A\u8FC7 --executable-path \u6216 PUPPETEER_EXECUTABLE_PATH \u6307\u5B9A\u6D4F\u89C8\u5668\u8DEF\u5F84"
-    );
-  }
-  return matchedPath;
-}
-
-const DEFAULT_TIMEOUT_MS = 2e4;
 async function getXSign(options = {}) {
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  const browser = await puppeteer.launch({
-    executablePath: resolveExecutablePath(options.executablePath),
-    headless: options.headless ?? true,
-    args: ["--no-sandbox", "--disable-setuid-sandbox"]
+  const url = options.url?.trim() || buildSkillAccessConfigUrl(getStargateBaseUrl());
+  const response = await axios.get(url, {
+    headers: {
+      accept: "application/json"
+    },
+    timeout: timeoutMs
   });
-  try {
-    const page = await browser.newPage();
-    const firstFetchRequestPromise = waitForFirstFetchRequest(page, timeoutMs);
-    const url = options.url ?? getQiemanBaseUrl();
-    await page.goto(url, {
-      waitUntil: "domcontentloaded",
-      timeout: timeoutMs
-    });
-    const firstFetchRequest = await firstFetchRequestPromise;
-    const xSign = getHeaderValue(firstFetchRequest.headers(), "x-sign")?.trim();
-    if (!xSign) {
-      throw new Error(`\u9996\u4E2A fetch \u8BF7\u6C42\u672A\u643A\u5E26 x-sign: ${firstFetchRequest.url()}`);
-    }
-    return xSign;
-  } finally {
-    await browser.close();
+  const xSign = response.data.sign?.trim();
+  if (!xSign) {
+    throw new Error(`\u83B7\u53D6 x-sign \u5931\u8D25\uFF0C\u54CD\u5E94\u4E2D\u7F3A\u5C11 sign: ${url}`);
   }
+  return xSign;
 }
 
 function trimTrailingSlash(value) {
@@ -537,14 +495,14 @@ function countSetupModes(options) {
   return [options.apiKey, options.phone, options.verifyCode].filter(Boolean).length;
 }
 function persistHiddenConfigOptions(options) {
-  const remoteSkillServerBaseUrl = options.remoteSkillServerBaseUrl?.trim();
+  const stargateBaseUrl = options.stargateBaseUrl?.trim();
   const qiemanBaseUrl = options.qiemanBaseUrl?.trim();
-  if (!remoteSkillServerBaseUrl && !qiemanBaseUrl) {
+  if (!stargateBaseUrl && !qiemanBaseUrl) {
     return;
   }
   writeConfig({
     ...readConfig(),
-    ...remoteSkillServerBaseUrl ? { remoteSkillServerBaseUrl } : {},
+    ...stargateBaseUrl ? { stargateBaseUrl } : {},
     ...qiemanBaseUrl ? { qiemanBaseUrl } : {}
   });
 }
@@ -552,14 +510,16 @@ async function runInitSetup(options) {
   const apiKey = options.apiKey?.trim();
   const phone = options.phone?.trim();
   const qiemanBaseUrl = options.qiemanBaseUrl?.trim();
-  const remoteSkillServerBaseUrl = options.remoteSkillServerBaseUrl?.trim();
+  const remoteSkillServerBaseUrl = options.stargateBaseUrl?.trim();
   const verifyCode = options.verifyCode?.trim();
   persistHiddenConfigOptions({
-    remoteSkillServerBaseUrl,
+    stargateBaseUrl: remoteSkillServerBaseUrl,
     qiemanBaseUrl
   });
   if (countSetupModes({ apiKey, phone, verifyCode }) > 1) {
-    throw new Error("`--api-key`\u3001`--phone`\u3001`--verify-code` \u4E00\u6B21\u53EA\u80FD\u4F7F\u7528\u4E00\u79CD\uFF0C\u8BF7\u6309\u521D\u59CB\u5316\u9636\u6BB5\u5206\u522B\u6267\u884C");
+    throw new Error(
+      "`--api-key`\u3001`--phone`\u3001`--verify-code` \u4E00\u6B21\u53EA\u80FD\u4F7F\u7528\u4E00\u79CD\uFF0C\u8BF7\u6309\u521D\u59CB\u5316\u9636\u6BB5\u5206\u522B\u6267\u884C"
+    );
   }
   if (apiKey) {
     return setupWithApiKey(apiKey);
@@ -574,15 +534,40 @@ async function runInitSetup(options) {
 }
 
 function registerDoctorCommand(initCommand) {
-  initCommand.command("doctor").description("\u68C0\u67E5\u672C\u5730\u914D\u7F6E\u4E0E\u8FD0\u884C\u73AF\u5883").action(() => {
+  initCommand.command("doctor").description("\u68C0\u67E5\u672C\u5730\u914D\u7F6E\u4E0E\u8FD0\u884C\u73AF\u5883").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u8BCA\u65AD\u672C\u5730\u914D\u7F6E\u3001\u8FD0\u884C\u73AF\u5883\u548C\u521D\u59CB\u5316\u72B6\u6001\uFF0C\u5E2E\u52A9\u5B9A\u4F4D\u4E0D\u53EF\u7528\u539F\u56E0\u3002
+
+\u793A\u4F8B:
+  yingmi-cli init doctor
+
+\u8BF4\u660E:
+  - \u9002\u5408\u5728 init status \u8F93\u51FA\u5F02\u5E38\u65F6\u4F7F\u7528
+  - \u9519\u8BEF\u4FE1\u606F\u5E94\u540C\u65F6\u8BF4\u660E\u539F\u56E0\u548C\u4E0B\u4E00\u6B65\u4FEE\u590D\u5EFA\u8BAE
+`
+  ).action(() => {
     console.log(JSON.stringify(runInitDoctorChecks(), null, 2));
   });
 }
 
 function registerSetupCommand(initCommand) {
-  initCommand.command("setup").description("\u6267\u884C\u9996\u6B21\u521D\u59CB\u5316\uFF0C\u652F\u6301\u76F4\u63A5\u5199\u5165 API Key \u6216\u9A8C\u8BC1\u7801\u7533\u8BF7 API Key").option("--api-key <value>", "\u76F4\u63A5\u5199\u5165 StarGate API Key").option("--phone <value>", "\u901A\u8FC7\u624B\u673A\u53F7\u53D1\u8D77\u9A8C\u8BC1\u7801\u521D\u59CB\u5316").option("--verify-code <value>", "\u786E\u8BA4\u77ED\u4FE1\u9A8C\u8BC1\u7801\u5E76\u5B8C\u6210 API Key \u521D\u59CB\u5316").addOption(
-    new commander.Option("--remote-skill-server-base-url <value>", "\u8986\u76D6 remote-skill \u670D\u52A1\u57FA\u5730\u5740").hideHelp()
-  ).addOption(new commander.Option("--qieman-base-url <value>", "\u8986\u76D6\u4E14\u6162\u670D\u52A1\u57FA\u5730\u5740").hideHelp()).action(async (options) => {
+  initCommand.command("setup").description("\u6267\u884C\u9996\u6B21\u521D\u59CB\u5316\uFF0C\u652F\u6301\u76F4\u63A5\u5199\u5165 API Key \u6216\u9A8C\u8BC1\u7801\u7533\u8BF7 API Key").option("--api-key <value>", "\u76F4\u63A5\u5199\u5165 StarGate API Key").option("--phone <value>", "\u901A\u8FC7\u624B\u673A\u53F7\u53D1\u8D77\u9A8C\u8BC1\u7801\u521D\u59CB\u5316").option("--verify-code <value>", "\u786E\u8BA4\u77ED\u4FE1\u9A8C\u8BC1\u7801\u5E76\u5B8C\u6210 API Key \u521D\u59CB\u5316").addOption(new commander.Option("--stargate-base-url <value>", "\u8986\u76D6 Stargate \u670D\u52A1\u57FA\u5730\u5740").hideHelp()).addOption(new commander.Option("--qieman-base-url <value>", "\u8986\u76D6\u4E14\u6162\u670D\u52A1\u57FA\u5730\u5740").hideHelp()).addHelpText(
+    "after",
+    `
+\u8F93\u5165\u89C4\u5219:
+  1. --api-key\u3001--phone\u3001--verify-code \u4E09\u79CD\u6A21\u5F0F\u4E92\u65A5
+  2. \u4E0D\u5E26\u53C2\u6570\u6267\u884C\u65F6\uFF0C\u8FD4\u56DE\u4E0B\u4E00\u6B65\u521D\u59CB\u5316\u5F15\u5BFC
+  3. \u5EFA\u8BAE\u4F18\u5148\u4F7F\u7528\u957F\u53C2\u6570\u540D\uFF0C\u4FBF\u4E8E\u811A\u672C\u548C Agent \u8C03\u7528
+
+\u793A\u4F8B:
+  yingmi-cli init setup
+  yingmi-cli init setup --api-key <value>
+  yingmi-cli init setup --phone <\u624B\u673A\u53F7>
+  yingmi-cli init setup --verify-code <\u9A8C\u8BC1\u7801>
+`
+  ).action(async (options) => {
     try {
       const result = await runInitSetup(options);
       console.log(JSON.stringify(result, null, 2));
@@ -593,13 +578,43 @@ function registerSetupCommand(initCommand) {
 }
 
 function registerStatusCommand(initCommand) {
-  initCommand.command("status").description("\u67E5\u770B\u521D\u59CB\u5316\u72B6\u6001\u548C\u914D\u7F6E\u6458\u8981").action(() => {
+  initCommand.command("status").description("\u67E5\u770B\u521D\u59CB\u5316\u72B6\u6001\u548C\u914D\u7F6E\u6458\u8981").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u8F93\u51FA\u5F53\u524D\u521D\u59CB\u5316\u72B6\u6001\u6458\u8981\uFF0C\u4FBF\u4E8E\u786E\u8BA4 CLI \u662F\u5426\u5DF2\u53EF\u7528\u3002
+
+\u793A\u4F8B:
+  yingmi-cli init status
+
+\u4E0B\u4E00\u6B65:
+  1. \u5982\u679C\u5C1A\u672A\u5B8C\u6210\u521D\u59CB\u5316\uFF0C\u6267\u884C yingmi-cli init setup
+  2. \u5982\u679C\u72B6\u6001\u5F02\u5E38\uFF0C\u6267\u884C yingmi-cli init doctor
+`
+  ).action(() => {
     console.log(JSON.stringify(getInitStatusSummary(), null, 2));
   });
 }
 
 function registerInitCommand(program) {
-  const initCommand = program.command("init").description("\u521D\u59CB\u5316 CLI \u5E76\u67E5\u770B\u5F53\u524D\u72B6\u6001");
+  const initCommand = program.command("init").description("\u521D\u59CB\u5316 CLI \u5E76\u67E5\u770B\u5F53\u524D\u72B6\u6001").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u8BA9 CLI \u8FDB\u5165\u53EF\u7528\u72B6\u6001\uFF0C\u5E76\u68C0\u67E5\u5F53\u524D\u672C\u5730\u914D\u7F6E\u548C\u8FD0\u884C\u73AF\u5883\u3002
+
+\u63A8\u8350\u987A\u5E8F:
+  1. yingmi-cli init setup
+  2. yingmi-cli init status
+  3. \u9047\u5230\u95EE\u9898\u65F6\u6267\u884C yingmi-cli init doctor
+
+\u8BF4\u660E:
+  - setup \u7528\u4E8E\u9996\u6B21\u521D\u59CB\u5316\u6216\u8865\u5168 API Key
+  - status \u7528\u4E8E\u67E5\u770B\u5F53\u524D\u72B6\u6001\u6458\u8981
+  - doctor \u7528\u4E8E\u6392\u67E5\u914D\u7F6E\u6216\u73AF\u5883\u95EE\u9898
+  - \u521D\u59CB\u5316\u5B8C\u6210\u540E\uFF0C\u8C03\u7528\u5355\u4E2A\u80FD\u529B\u4F18\u5148\u4F7F\u7528 mcp\uFF0C\u5B8C\u6210\u91D1\u878D\u573A\u666F\u4EFB\u52A1\u4F18\u5148\u4F7F\u7528 remote-skill
+`
+  );
   registerSetupCommand(initCommand);
   registerStatusCommand(initCommand);
   registerDoctorCommand(initCommand);
@@ -637,9 +652,7 @@ function readJsonInput(input, inputFile) {
 function requireApiKey() {
   const { apiKey } = readConfig();
   if (!apiKey) {
-    fail(
-      "\u672A\u914D\u7F6E apiKey\uFF0C\u8BF7\u5148\u6267\u884C: yingmi-cli init setup --api-key <your-api-key>\uFF0C\u6216\u5148\u7528 yingmi-cli init setup --phone <\u624B\u673A\u53F7> \u5B8C\u6210\u9A8C\u8BC1\u7801\u521D\u59CB\u5316"
-    );
+    fail("\u672A\u5B8C\u6210\u521D\u59CB\u5316\uFF0C\u8BF7\u5148\u6267\u884C: yingmi-cli init setup --phone <\u624B\u673A\u53F7> \u5B8C\u6210\u624B\u673A\u53F7\u9A8C\u8BC1\u7801\u521D\u59CB\u5316");
   }
   return apiKey;
 }
@@ -821,6 +834,7 @@ function validateParameters(parameters, values, locationLabel) {
 
 const DOCS_URL = "https://stargate.yingmi.com/api/docs.json";
 const HTTP_METHODS = ["get", "post", "put", "patch", "delete", "head", "options"];
+const HIDDEN_OPERATION_NAMES = /* @__PURE__ */ new Set(["getSkillByName"]);
 async function fetchOpenApiDocument(apiKey) {
   const response = await axios.get(DOCS_URL, {
     params: {
@@ -856,6 +870,9 @@ function listOperations(document) {
   });
   return operations.sort((left, right) => left.name.localeCompare(right.name));
 }
+function listVisibleOperations(document) {
+  return listOperations(document).filter((operation) => !HIDDEN_OPERATION_NAMES.has(operation.name));
+}
 function getOperationByName(document, toolName) {
   return listOperations(document).find((operation) => operation.name === toolName);
 }
@@ -881,7 +898,21 @@ function getPrimaryRequestContentType(operation) {
 }
 
 function registerCallCommand(mcpCommand) {
-  mcpCommand.command("call").description("\u8C03\u7528\u6307\u5B9A MCP \u5DE5\u5177").argument("<toolName>", "\u5DE5\u5177\u540D").option("--input <json>", "\u76F4\u63A5\u4F20\u5165 JSON \u5B57\u7B26\u4E32").option("--input-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6 JSON \u8F93\u5165").action(async (toolName, options) => {
+  mcpCommand.command("call").description("\u8C03\u7528\u6307\u5B9A MCP \u5DE5\u5177").argument("<toolName>", "\u5DE5\u5177\u540D").option("--input <json>", "\u76F4\u63A5\u4F20\u5165 JSON \u5B57\u7B26\u4E32").option("--input-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6 JSON \u8F93\u5165").addHelpText(
+    "after",
+    `
+\u8F93\u5165\u89C4\u5219:
+  1. \u5148\u6267\u884C yingmi-cli mcp schema <toolName> \u786E\u8BA4\u5B57\u6BB5\u540D\u548C requestBody
+  2. path/query/header \u53C2\u6570\u53EF\u76F4\u63A5\u653E\u5728 JSON \u9876\u5C42\uFF0C\u4E5F\u53EF\u5206\u522B\u653E\u8FDB path/query/header
+  3. body \u53EF\u663E\u5F0F\u653E\u5728 body \u5B57\u6BB5\uFF1B\u5982\u679C\u5DE5\u5177\u53EA\u6709 requestBody \u4E14\u6CA1\u6709\u5176\u5B83\u53C2\u6570\uFF0C\u4E5F\u53EF\u76F4\u63A5\u4F20 body \u5BF9\u8C61
+  4. mcp call \u9002\u5408\u5355\u6B21\u539F\u5B50\u80FD\u529B\u8C03\u7528\uFF0C\u4E0D\u9002\u5408\u76F4\u63A5\u627F\u8F7D\u5B8C\u6574\u91D1\u878D\u573A\u666F\u5DE5\u4F5C\u6D41
+
+\u793A\u4F8B:
+  yingmi-cli mcp call GetCurrentTime
+  yingmi-cli mcp call GuessFundCode --input '{"fundNameOrCode":"\u6613\u65B9\u8FBE\u84DD\u7B79\u7CBE\u9009"}'
+  yingmi-cli mcp call <toolName> --input '{"query":{"pageNum":1},"body":{"keyword":"\u65B0\u80FD\u6E90"}}'
+`
+  ).action(async (toolName, options) => {
     const apiKey = requireApiKey();
     const document = await fetchOpenApiDocument(apiKey);
     const operation = getOperationByName(document, toolName);
@@ -933,10 +964,21 @@ function registerCallCommand(mcpCommand) {
 }
 
 function registerListCommand(mcpCommand) {
-  mcpCommand.command("list").description("\u5217\u51FA\u6240\u6709 MCP \u5DE5\u5177\u6458\u8981").action(async () => {
+  mcpCommand.command("list").description("\u5217\u51FA\u6240\u6709 MCP \u5DE5\u5177\u6458\u8981").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u6D4F\u89C8\u53EF\u76F4\u63A5\u8C03\u7528\u7684\u539F\u5B50\u80FD\u529B\u5217\u8868\uFF0C\u5224\u65AD\u662F\u5426\u5DF2\u7ECF\u5B58\u5728\u5408\u9002\u7684 tool\u3002
+
+\u4E0B\u4E00\u6B65:
+  1. \u4ECE\u8F93\u51FA\u91CC\u6311\u4E00\u4E2A toolName
+  2. \u6267\u884C yingmi-cli mcp schema <toolName> \u67E5\u770B\u53C2\u6570\u548C\u54CD\u5E94\u7ED3\u6784
+  3. \u5982\u679C\u76EE\u6807\u5176\u5B9E\u662F\u57FA\u91D1\u5206\u6790\u3001\u7EC4\u5408\u8BCA\u65AD\u6216\u8D22\u5BCC\u89C4\u5212\u7B49\u5B8C\u6574\u573A\u666F\uFF0C\u6539\u770B yingmi-cli remote-skill list
+`
+  ).action(async () => {
     const apiKey = requireApiKey();
     const document = await fetchOpenApiDocument(apiKey);
-    const operations = listOperations(document);
+    const operations = listVisibleOperations(document);
     console.log(
       JSON.stringify(
         operations.map((operation) => ({
@@ -954,7 +996,20 @@ function registerListCommand(mcpCommand) {
 }
 
 function registerSchemaCommand(mcpCommand) {
-  mcpCommand.command("schema").description("\u67E5\u770B\u67D0\u4E2A MCP \u5DE5\u5177\u7684\u5B8C\u6574 Schema").argument("<toolName>", "\u5DE5\u5177\u540D").action(async (toolName) => {
+  mcpCommand.command("schema").description("\u67E5\u770B\u67D0\u4E2A MCP \u5DE5\u5177\u7684\u5B8C\u6574 Schema").argument("<toolName>", "\u5DE5\u5177\u540D").addHelpText(
+    "after",
+    `
+\u5EFA\u8BAE:
+  0. schema \u9002\u5408\u5728\u4F60\u5DF2\u7ECF\u786E\u5B9A\u8981\u8C03\u7528\u67D0\u4E2A\u539F\u5B50\u80FD\u529B\u65F6\u4F7F\u7528
+  1. \u5148\u770B parameters\uFF0C\u786E\u8BA4 path/query/header \u7684\u5B57\u6BB5\u540D
+  2. \u518D\u770B requestBody\uFF0C\u786E\u8BA4 body \u662F\u5426\u5FC5\u586B
+  3. \u6700\u540E\u6267\u884C yingmi-cli mcp call <toolName> --input '<json>'
+
+\u793A\u4F8B:
+  yingmi-cli mcp schema GetCurrentTime
+  yingmi-cli mcp schema GuessFundCode
+`
+  ).action(async (toolName) => {
     const apiKey = requireApiKey();
     const document = await fetchOpenApiDocument(apiKey);
     const operation = getOperationByName(document, toolName);
@@ -981,7 +1036,28 @@ function registerSchemaCommand(mcpCommand) {
 }
 
 function registerMcpCommand(program) {
-  const mcpCommand = program.command("mcp").description("\u6D4F\u89C8 MCP \u6458\u8981\u3001\u67E5\u770B Schema \u5E76\u8C03\u7528\u5DE5\u5177");
+  const mcpCommand = program.command("mcp").description("\u6D4F\u89C8\u539F\u5B50\u80FD\u529B\u6458\u8981\u3001\u67E5\u770B Schema \u5E76\u76F4\u63A5\u8C03\u7528\u5DE5\u5177").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u6D4F\u89C8 MCP \u5DE5\u5177\u6458\u8981\uFF0C\u67E5\u770B\u5DE5\u5177 schema\uFF0C\u5E76\u53D1\u8D77\u5355\u6B21\u539F\u5B50\u80FD\u529B\u8C03\u7528\u3002
+
+\u63A8\u8350\u987A\u5E8F:
+  1. yingmi-cli mcp list
+  2. yingmi-cli mcp schema <toolName>
+  3. yingmi-cli mcp call <toolName> --input '<json>'
+
+\u8BF4\u660E:
+  - mcp \u9002\u5408\u5DF2\u77E5\u8981\u8C03\u7528\u54EA\u4E2A\u80FD\u529B\u3001\u5E76\u4E14\u80FD\u660E\u786E\u6784\u9020 JSON \u8F93\u5165\u7684\u573A\u666F
+  - schema \u7528\u4E8E\u786E\u8BA4\u5B57\u6BB5\u540D\u3001\u53C2\u6570\u4F4D\u7F6E\u548C requestBody
+  - call \u7684\u8F93\u5165\u662F JSON \u534F\u8BAE\uFF0C\u4E0D\u662F\u81EA\u7136\u8BED\u8A00 prompt
+  - \u5982\u679C\u76EE\u6807\u662F\u5B8C\u6210\u57FA\u91D1\u5206\u6790\u3001\u7EC4\u5408\u8BCA\u65AD\u6216\u8D22\u5BCC\u89C4\u5212\u7B49\u573A\u666F\u4EFB\u52A1\uFF0C\u4F18\u5148\u67E5\u770B remote-skill
+
+\u6700\u5C0F\u6210\u529F\u793A\u4F8B:
+  yingmi-cli mcp schema GetCurrentTime
+  yingmi-cli mcp call GetCurrentTime
+`
+  );
   registerListCommand(mcpCommand);
   registerSchemaCommand(mcpCommand);
   registerCallCommand(mcpCommand);
@@ -1083,7 +1159,7 @@ function validateRemoteSkillName(skillName) {
   return normalizedName;
 }
 async function fetchRemoteSkillSummaries(apiKey) {
-  const serverBaseUrl = normalizeServerBaseUrl(getRemoteSkillServerBaseUrl());
+  const serverBaseUrl = normalizeServerBaseUrl(getStargateBaseUrl());
   const response = await axios.get(`${serverBaseUrl}/api/get-skills`, {
     headers: buildRequestHeaders(apiKey),
     timeout: REQUEST_TIMEOUT
@@ -1092,7 +1168,7 @@ async function fetchRemoteSkillSummaries(apiKey) {
 }
 async function prepareRemoteSkillContext(skillName, apiKey) {
   const normalizedSkillName = validateRemoteSkillName(skillName);
-  const serverBaseUrl = normalizeServerBaseUrl(getRemoteSkillServerBaseUrl());
+  const serverBaseUrl = normalizeServerBaseUrl(getStargateBaseUrl());
   const detailResponse = await axios.get(
     `${serverBaseUrl}/api/get-skill-by-name`,
     {
@@ -1169,8 +1245,35 @@ function readScriptInput(options) {
   }
 }
 function registerRemoteSkillCommand(program) {
-  const remoteSkillCommand = program.command("remote-skill").description("\u67E5\u770B skill \u6458\u8981\uFF0C\u5E76\u8FDB\u5165\u67D0\u4E2A skill \u4E0A\u4E0B\u6587");
-  remoteSkillCommand.command("list").description("\u5C55\u793A\u5F53\u524D\u652F\u6301\u7684 skill \u6458\u8981").action(async () => {
+  const remoteSkillCommand = program.command("remote-skill").description("\u67E5\u770B\u91D1\u878D\u573A\u666F skill\u3001\u8FDB\u5165\u4E0A\u4E0B\u6587\uFF0C\u5E76\u5728\u8BE5\u76EE\u5F55\u6267\u884C\u7EA6\u5B9A\u811A\u672C").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u53D1\u73B0\u8FDC\u7AEF\u91D1\u878D\u573A\u666F skill\uFF0C\u8FDB\u5165\u67D0\u4E2A skill \u7684\u5DE5\u4F5C\u4E0A\u4E0B\u6587\uFF0C\u5E76\u6309 skill \u7EA6\u5B9A\u6267\u884C\u811A\u672C\u3002
+
+\u63A8\u8350\u987A\u5E8F:
+  1. yingmi-cli remote-skill list
+  2. yingmi-cli remote-skill enter <skillName>
+  3. yingmi-cli remote-skill exec --script 'cat SKILL.md'
+  4. \u6309 skill \u8BF4\u660E\u6267\u884C\u5B9E\u9645\u811A\u672C\uFF0C\u4F8B\u5982:
+     yingmi-cli remote-skill exec --script 'python main.py'
+
+\u6CE8\u610F:
+  - remote-skill \u7528\u4E8E\u5B8C\u6210\u57FA\u91D1\u5206\u6790\u3001\u7EC4\u5408\u8BCA\u65AD\u3001\u8D22\u5BCC\u89C4\u5212\u3001\u5E02\u573A\u7B80\u62A5\u7B49\u573A\u666F\u4EFB\u52A1
+  - \u4E00\u4E2A skill \u5185\u90E8\u53EF\u4EE5\u6309\u9700\u8C03\u7528\u4E00\u4E2A\u6216\u591A\u4E2A mcp
+  - remote-skill exec \u6267\u884C\u7684\u662F shell \u811A\u672C\uFF0C\u4E0D\u662F\u81EA\u7136\u8BED\u8A00\u4EFB\u52A1
+  - \u5EFA\u8BAE\u4F18\u5148\u9605\u8BFB skill \u5185\u7684 SKILL.md\uFF0C\u518D\u6267\u884C\u7EA6\u5B9A\u5165\u53E3
+`
+  );
+  remoteSkillCommand.command("list").description("\u5C55\u793A\u5F53\u524D\u652F\u6301\u7684\u91D1\u878D\u573A\u666F skill \u6458\u8981").addHelpText(
+    "after",
+    `
+\u4E0B\u4E00\u6B65:
+  1. \u4ECE\u8F93\u51FA\u91CC\u6311\u4E00\u4E2A\u6700\u8D34\u8FD1\u5F53\u524D\u91D1\u878D\u573A\u666F\u4EFB\u52A1\u7684 skillName
+  2. \u6267\u884C yingmi-cli remote-skill enter <skillName>
+  3. \u518D\u6267\u884C yingmi-cli remote-skill exec --script 'cat SKILL.md'
+`
+  ).action(async () => {
     try {
       const apiKey = requireApiKey();
       const skills = await fetchRemoteSkillSummaries(apiKey);
@@ -1179,7 +1282,21 @@ function registerRemoteSkillCommand(program) {
       fail(error.message);
     }
   });
-  remoteSkillCommand.command("enter").description("\u8FDB\u5165\u67D0\u4E2A skill \u4E0A\u4E0B\u6587\uFF0C\u5E76\u5C55\u793A\u76EE\u5F55\u548C\u6587\u4EF6\u7ED3\u6784").argument("<skillName>", "skill \u540D\u79F0").action(async (skillName) => {
+  remoteSkillCommand.command("enter").description("\u8FDB\u5165\u67D0\u4E2A\u573A\u666F skill \u4E0A\u4E0B\u6587\uFF0C\u4FDD\u5B58\u5F53\u524D\u4F1A\u8BDD\uFF0C\u5E76\u5C55\u793A\u76EE\u5F55\u6811").argument("<skillName>", "skill \u540D\u79F0").addHelpText(
+    "after",
+    `
+\u8BF4\u660E:
+  enter \u6210\u529F\u540E\u4F1A\u8BB0\u5F55\u6700\u8FD1\u4E00\u6B21 skill \u4F1A\u8BDD\uFF0C\u540E\u7EED exec \u9ED8\u8BA4\u590D\u7528\u8FD9\u4E2A\u4E0A\u4E0B\u6587\u3002
+  \u8FDB\u5165 skill \u9002\u5408\u4F60\u5DF2\u7ECF\u786E\u5B9A\u8981\u5B8C\u6210\u67D0\u4E2A\u91D1\u878D\u573A\u666F\u4EFB\u52A1\uFF0C\u800C\u4E0D\u662F\u53EA\u8C03\u7528\u5355\u4E2A mcp\u3002
+
+\u793A\u4F8B:
+  yingmi-cli remote-skill enter fund-analyst
+
+\u4E0B\u4E00\u6B65:
+  1. yingmi-cli remote-skill exec --script 'cat SKILL.md'
+  2. \u6309 skill \u6587\u6863\u8BF4\u660E\u6267\u884C\u5165\u53E3\u811A\u672C
+`
+  ).action(async (skillName) => {
     try {
       const apiKey = requireApiKey();
       const context = await prepareRemoteSkillContext(skillName, apiKey);
@@ -1192,7 +1309,21 @@ function registerRemoteSkillCommand(program) {
       fail(error.message);
     }
   });
-  remoteSkillCommand.command("exec").description("\u5728\u6700\u8FD1\u4E00\u6B21\u8FDB\u5165\u7684 skill \u4E0A\u4E0B\u6587\u4E2D\u6267\u884C\u811A\u672C").option("--script <content>", "\u5728\u5F53\u524D skill \u4E0A\u4E0B\u6587\u4E2D\u6267\u884C\u811A\u672C").option("--script-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6\u811A\u672C\u5185\u5BB9\u540E\u6267\u884C").action(async (options) => {
+  remoteSkillCommand.command("exec").description("\u5728\u6700\u8FD1\u4E00\u6B21\u8FDB\u5165\u7684 skill \u4E0A\u4E0B\u6587\u4E2D\u6267\u884C\u7EA6\u5B9A\u811A\u672C").option("--script <content>", "\u5728\u5F53\u524D skill \u4E0A\u4E0B\u6587\u4E2D\u6267\u884C shell \u811A\u672C\u5185\u5BB9").option("--script-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6\u811A\u672C\u5185\u5BB9\u540E\u6267\u884C").addHelpText(
+    "after",
+    `
+\u6CE8\u610F:
+  1. \u8FD9\u91CC\u6267\u884C\u7684\u662F shell \u811A\u672C\uFF0C\u4E0D\u662F\u81EA\u7136\u8BED\u8A00 prompt
+  2. \u5EFA\u8BAE\u4F18\u5148\u9605\u8BFB skill \u5185\u7684 SKILL.md\uFF0C\u6309 skill \u7EA6\u5B9A\u6267\u884C\u811A\u672C
+  3. skill \u5728\u6267\u884C\u8FC7\u7A0B\u4E2D\u53EF\u80FD\u4F1A\u7EE7\u7EED\u8C03\u7528\u4E00\u4E2A\u6216\u591A\u4E2A mcp
+  4. \u5BF9\u4E8E Python skill\uFF0C\u4F18\u5148\u4F7F\u7528 python \u547D\u4EE4\u6267\u884C\u5165\u53E3\u811A\u672C
+
+\u793A\u4F8B:
+  yingmi-cli remote-skill exec --script 'cat SKILL.md'
+  yingmi-cli remote-skill exec --script 'python main.py'
+  yingmi-cli remote-skill exec --script-file ./scripts/run.sh
+`
+  ).action(async (options) => {
     try {
       if (options.script && options.scriptFile) {
         fail("--script \u548C --script-file \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528");
@@ -1215,7 +1346,6 @@ function registerRemoteSkillCommand(program) {
         JSON.stringify(
           {
             skillName: currentSession.skillName,
-            workingDirectory: currentSession.workingDirectory,
             execution
           },
           null,
@@ -1319,7 +1449,22 @@ async function checkAndUpdate(checkOnly = false) {
 }
 
 function registerUpgradeCommand(program) {
-  program.command("upgrade").description("\u68C0\u67E5 CLI \u66F4\u65B0\uFF0C\u5E76\u5728\u6709\u65B0\u7248\u672C\u65F6\u6267\u884C\u5347\u7EA7").option("--check-only", "\u4EC5\u68C0\u67E5\u6700\u65B0\u7248\u672C\uFF0C\u4E0D\u6267\u884C\u5B89\u88C5").action(async (options) => {
+  program.command("upgrade").description("\u68C0\u67E5 CLI \u66F4\u65B0\uFF0C\u5E76\u5728\u6709\u65B0\u7248\u672C\u65F6\u6267\u884C\u5347\u7EA7").option("--check-only", "\u4EC5\u68C0\u67E5\u6700\u65B0\u7248\u672C\uFF0C\u4E0D\u6267\u884C\u5B89\u88C5").addHelpText(
+    "after",
+    `
+\u7528\u9014:
+  \u68C0\u67E5 CLI \u662F\u5426\u6709\u65B0\u7248\u672C\uFF0C\u5E76\u5728\u9700\u8981\u65F6\u6267\u884C\u5347\u7EA7\u3002
+
+\u793A\u4F8B:
+  yingmi-cli upgrade --check-only
+  yingmi-cli upgrade
+
+\u8BF4\u660E:
+  - --check-only \u53EA\u68C0\u67E5\u7248\u672C\uFF0C\u4E0D\u6267\u884C\u5B89\u88C5
+  - \u771F\u6B63\u5347\u7EA7\u524D\u5E94\u660E\u786E\u4E86\u89E3\u526F\u4F5C\u7528
+  - \u975E\u4EA4\u4E92\u73AF\u5883\u4E0B\u4E0D\u5E94\u4F9D\u8D56\u786E\u8BA4\u8F93\u5165
+`
+  ).action(async (options) => {
     try {
       await checkAndUpdate(Boolean(options.checkOnly));
     } catch (error) {
@@ -1340,6 +1485,31 @@ function createProgram() {
   registerHelpCommand(program);
   registerUpgradeCommand(program);
   program.showHelpAfterError("(\u4F7F\u7528 --help \u67E5\u770B\u547D\u4EE4\u5E2E\u52A9)");
+  program.addHelpText(
+    "after",
+    `
+\u5E38\u89C1\u4EFB\u52A1:
+  \u9996\u6B21\u914D\u7F6E CLI                yingmi-cli help init
+  \u76F4\u63A5\u8C03\u7528\u539F\u5B50\u91D1\u878D\u80FD\u529B         yingmi-cli help mcp
+  \u5B8C\u6210\u57FA\u91D1\u6216\u8D22\u5BCC\u573A\u666F\u4EFB\u52A1       yingmi-cli help remote-skill
+  \u67E5\u770B\u67D0\u4E2A\u547D\u4EE4\u7684\u8BE6\u7EC6\u5E2E\u52A9       yingmi-cli help <command...>
+  \u68C0\u67E5\u6216\u5347\u7EA7\u7248\u672C              yingmi-cli help upgrade
+
+\u5FEB\u901F\u5F00\u59CB:
+  1. yingmi-cli init setup
+  2. \u5982\u679C\u8981\u76F4\u63A5\u8C03\u7528\u5355\u4E2A\u80FD\u529B\uFF0C\u6267\u884C yingmi-cli mcp list
+  3. \u5982\u679C\u8981\u5B8C\u6210\u91D1\u878D\u573A\u666F\u4EFB\u52A1\uFF0C\u6267\u884C yingmi-cli remote-skill list
+  4. \u5BF9\u4E8E mcp\uFF0C\u7EE7\u7EED\u6267\u884C yingmi-cli mcp schema <toolName>
+  5. \u5BF9\u4E8E mcp\uFF0C\u6267\u884C yingmi-cli mcp call <toolName> --input '<json>'
+
+\u534F\u8BAE\u63D0\u793A:
+  - \u7ED3\u6784\u5316\u7ED3\u679C\u8F93\u51FA\u5230 stdout
+  - \u63D0\u793A\u3001\u544A\u8B66\u548C\u9519\u8BEF\u8F93\u51FA\u5230 stderr
+  - \u4F18\u5148\u4F7F\u7528\u975E\u4EA4\u4E92\u53C2\u6570\uFF0C\u4FBF\u4E8E\u811A\u672C\u548C Agent \u8C03\u7528
+  - mcp \u7528\u4E8E\u539F\u5B50\u80FD\u529B\u8C03\u7528\uFF0Cremote-skill \u7528\u4E8E\u91D1\u878D\u573A\u666F\u7F16\u6392
+  - \u8C03\u7528 mcp \u524D\u5EFA\u8BAE\u5148\u67E5\u770B schema \u786E\u8BA4\u8F93\u5165\u5B57\u6BB5
+`
+  );
   return program;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yingmi-skill-cli",
-  "version": "0.0.2",
+  "version": "0.0.6",
   "author": "yingmi",
   "license": "MIT",
   "files": [
@@ -13,6 +13,7 @@
   "scripts": {
     "dev": "rollup -c -w",
     "build": "rollup -c",
+    "release": "bash ./publish.sh",
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage --passWithNoTests"
@@ -33,7 +34,6 @@
   "dependencies": {
     "axios": "^1",
     "chalk": "^4",
-    "commander": "*",
-    "puppeteer": "^24.39.1"
+    "commander": "*"
   }
-}
+}