@guandata/guanskill 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## @guandata/guanskill 0.1.13 - 2026-07-15
+
+- 新增统一的观远 CLI 套件入口，可识别任务并路由到六个正式组件。
+- 同步聚合包依赖到 guancli 1.0.40、guands 0.1.20、guanwf 0.1.820 和 guanvis 0.1.31。
+
+## @guandata/guanskill 0.1.12 - 2026-07-10
+
+- 同步聚合包依赖版本，包含本次发布的 guanmetric。
+- 聚合包命令转发与 `install-skill` 依赖版本同步到最新组件版本。
+
 ## @guandata/guanskill 0.1.11 - 2026-07-08
 
 - 同步聚合包依赖版本，包含本次发布的 guancli、guands、guanetl、guanwf、guanvis、guanmetric。

package/README.md

@@ -1,6 +1,6 @@
 # @guandata/guanskill
 
-Guandata BI Skills 聚合安装包，用于一次性安装和更新观远 BI 命令行工具与常用 AI skills。
+Guandata BI Skills 聚合安装包，用于一次性安装和更新观远 BI 命令行工具、常用 AI skills 与统一的观远 CLI 套件入口。
 
 ## 安装
 
@@ -25,19 +25,31 @@ guanmetric
 guanskill install-skill
 ```
 
+该命令还会安装 `guandata-cli-suite`。它负责识别观远数据任务并路由到下列正式组件。
+
 ## 包含组件
 
 | 组件 | 版本 | 用途 |
 |---|---:|---|
-| `@guandata/guancli` | `1.0.39` | 观远 BI 基础命令行工具 |
-| `@guandata/guands` | `0.1.19` | 数据源和数据集管理 |
+| `@guandata/guancli` | `1.0.40` | 观远 BI 基础命令行工具 |
+| `@guandata/guands` | `0.1.20` | 数据源和数据集管理 |
 | `@guandata/guanetl` | `0.1.19` | ETL 编辑、预览和执行 |
-| `@guandata/guanwf` | `0.1.7` | 工作流数据流管理 |
-| `@guandata/guanvis` | `0.1.30` | 图表、卡片和仪表板构建 |
-| `@guandata/guanmetric` | `0.1.0` | 指标创建、编辑和模板标准化 |
+| `@guandata/guanwf` | `0.1.820` | 工作流数据流管理 |
+| `@guandata/guanvis` | `0.1.31` | 图表、卡片和仪表板构建 |
+| `@guandata/guanmetric` | `0.1.1` | 指标创建、编辑和模板标准化 |
 
 ## 版本更新
 
+### @guandata/guanskill 0.1.13
+
+- 新增统一的观远 CLI 套件入口，可识别任务并路由到六个正式组件。
+- 同步聚合包依赖到 guancli 1.0.40、guands 0.1.20、guanwf 0.1.820 和 guanvis 0.1.31。
+
+### @guandata/guanskill 0.1.12
+
+- 同步聚合包依赖版本，包含本次发布的 guanmetric。
+- 聚合包命令转发与 `install-skill` 依赖版本同步到最新组件版本。
+
 ### @guandata/guanskill 0.1.11
 
 - 同步聚合包依赖版本，包含本次发布的 guancli、guands、guanetl、guanwf、guanvis、guanmetric。

package/bin/run.js

@@ -3,8 +3,20 @@
 "use strict";
 
 const { spawnSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
 const path = require("path");
 
+const SUITE_SKILL = "guandata-cli-suite";
+
+class BuddyInstallError extends Error {
+  constructor(failures) {
+    super(`Buddy skill installation failed:\n${failures.join("\n")}`);
+    this.name = "BuddyInstallError";
+    this.failures = failures;
+  }
+}
+
 const COMPONENTS = [
   { command: "guancli", packageName: "@guandata/guancli" },
   { command: "guands", packageName: "@guandata/guands" },
@@ -44,6 +56,167 @@ function resolveComponentBin(component) {
   }
 }
 
+function resolveComponentPackageRoot(component) {
+  try {
+    return path.dirname(require.resolve(`${component.packageName}/package.json`));
+  } catch (err) {
+    console.error(
+      `Cannot find ${component.packageName}. Reinstall with: npm install -g @guandata/guanskill`
+    );
+    process.exit(1);
+  }
+}
+
+function copyDirectory(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else if (entry.isSymbolicLink()) {
+      fs.symlinkSync(fs.readlinkSync(srcPath), destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function replaceDirectory(src, dest, copy = copyDirectory, operations = fs) {
+  const parentDir = path.dirname(dest);
+  const suffix = `${process.pid}-${Date.now()}`;
+  const tempDir = path.join(parentDir, `.${path.basename(dest)}.tmp-${suffix}`);
+  const backupDir = path.join(parentDir, `.${path.basename(dest)}.backup-${suffix}`);
+
+  operations.mkdirSync(parentDir, { recursive: true });
+  try {
+    copy(src, tempDir);
+    if (operations.existsSync(dest)) {
+      operations.renameSync(dest, backupDir);
+    }
+    operations.renameSync(tempDir, dest);
+    operations.rmSync(backupDir, { recursive: true, force: true });
+  } catch (err) {
+    let restoreError;
+    let cleanupError;
+    if (!operations.existsSync(dest) && operations.existsSync(backupDir)) {
+      try {
+        operations.renameSync(backupDir, dest);
+      } catch (restoreErr) {
+        restoreError = restoreErr;
+      }
+    }
+    try {
+      operations.rmSync(tempDir, { recursive: true, force: true });
+    } catch (cleanupErr) {
+      cleanupError = cleanupErr;
+    }
+    if (restoreError) {
+      throw new Error(`${err.message}; failed to restore previous skill: ${restoreError.message}`);
+    }
+    if (cleanupError) {
+      throw new Error(`${err.message}; failed to clean temporary skill: ${cleanupError.message}`);
+    }
+    throw err;
+  }
+}
+
+function resolveNpxInvocation(options = {}) {
+  const platform = options.platform || process.platform;
+  const nodePath = options.nodePath || process.execPath;
+  const npmExecPath = Object.prototype.hasOwnProperty.call(options, "npmExecPath")
+    ? options.npmExecPath
+    : process.env.npm_execpath;
+  const exists = options.exists || fs.existsSync;
+  const executableDir = path.dirname(nodePath);
+  const candidates = [];
+
+  if (npmExecPath) {
+    candidates.push(path.join(path.dirname(npmExecPath), "npx-cli.js"));
+  }
+  candidates.push(path.join(executableDir, "node_modules", "npm", "bin", "npx-cli.js"));
+  candidates.push(path.resolve(executableDir, "..", "node_modules", "npm", "bin", "npx-cli.js"));
+  candidates.push(path.resolve(executableDir, "..", "lib", "node_modules", "npm", "bin", "npx-cli.js"));
+
+  const npxCliPath = candidates.find((candidate) => exists(candidate));
+  if (npxCliPath) {
+    return { command: nodePath, argsPrefix: [npxCliPath] };
+  }
+  if (platform === "win32") {
+    throw new Error("Cannot locate npm/bin/npx-cli.js for safe Windows execution");
+  }
+  return { command: "npx", argsPrefix: [] };
+}
+
+function installBuddySkill(pkgRoot, skill) {
+  const srcDir = path.join(pkgRoot, "skills", skill);
+  if (!fs.existsSync(path.join(srcDir, "SKILL.md"))) {
+    console.error(`Skill not found: ${srcDir}. Reinstall @guandata/guanskill.`);
+    process.exit(1);
+  }
+
+  const targets = [
+    {
+      name: "CodeBuddy",
+      configDir: process.env.CODEBUDDY_CONFIG_DIR || path.join(os.homedir(), ".codebuddy"),
+    },
+    {
+      name: "WorkBuddy",
+      configDir: process.env.WORKBUDDY_CONFIG_DIR || path.join(os.homedir(), ".workbuddy"),
+    },
+  ];
+  const failures = [];
+
+  for (const target of targets) {
+    try {
+      const destDir = path.join(target.configDir, "skills", skill);
+      replaceDirectory(srcDir, destDir);
+      console.log(`Installed ${skill} to ${target.name}: ${destDir}`);
+    } catch (err) {
+      const message = `${target.name} install failed for ${skill}: ${err.message}`;
+      console.error(message);
+      failures.push(message);
+    }
+  }
+
+  if (failures.length > 0) {
+    throw new BuddyInstallError(failures);
+  }
+}
+
+function installPackageSkill(pkgRoot, skill, extraArgs, options = {}) {
+  const spawn = options.spawn || spawnSync;
+  const installBuddy = options.installBuddy || installBuddySkill;
+  const exit = options.exit || process.exit;
+  const npxInvocation = options.npxInvocation || resolveNpxInvocation();
+  const args = ["skills", "add", pkgRoot, "--skill", skill, "-g", "-y", ...extraArgs];
+  const result = spawn(npxInvocation.command, [...npxInvocation.argsPrefix, ...args], {
+    stdio: "inherit",
+    env: process.env,
+    shell: false,
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status == null) {
+    console.error(`${skill} installer terminated by signal: ${result.signal || "unknown"}`);
+    exit(1);
+    return false;
+  }
+  if (result.status !== 0) {
+    exit(result.status);
+    return false;
+  }
+  installBuddy(pkgRoot, skill);
+  return true;
+}
+
+function installSuiteSkill(extraArgs, options = {}) {
+  const pkgRoot = options.pkgRoot || path.join(__dirname, "..");
+  console.log(`\n== ${SUITE_SKILL} install-skill ==`);
+  return installPackageSkill(pkgRoot, SUITE_SKILL, extraArgs, options);
+}
+
 function printVersion() {
   const pkg = ownPackage();
   console.log(`${pkg.name} ${pkg.version}`);
@@ -57,21 +230,39 @@ function printVersion() {
   }
 }
 
-function installAllSkills(extraArgs) {
-  for (const component of COMPONENTS) {
-    const scriptPath = resolveComponentBin(component);
-    console.log(`\n== ${component.command} install-skill ==`);
-    const result = spawnSync(process.execPath, [scriptPath, "install-skill", ...extraArgs], {
-      stdio: "inherit",
-      env: process.env,
-    });
-    if (result.error) {
-      throw result.error;
+function installAllSkills(extraArgs, options = {}) {
+  const components = options.components || COMPONENTS;
+  const resolvePackageRoot = options.resolveComponentPackageRoot || resolveComponentPackageRoot;
+  const installPackage = options.installPackageSkill || installPackageSkill;
+  const installSuite = options.installSuite || installSuiteSkill;
+  const buddyFailures = [];
+
+  function attemptInstall(install) {
+    try {
+      return install();
+    } catch (err) {
+      if (!(err instanceof BuddyInstallError)) {
+        throw err;
+      }
+      buddyFailures.push(...err.failures);
+      return true;
     }
-    if (result.status) {
-      process.exit(result.status);
+  }
+
+  for (const component of components) {
+    const pkgRoot = resolvePackageRoot(component);
+    console.log(`\n== ${component.command} install-skill ==`);
+    if (!attemptInstall(() => installPackage(pkgRoot, component.command, extraArgs))) {
+      return false;
     }
   }
+  if (!attemptInstall(() => installSuite(extraArgs))) {
+    return false;
+  }
+  if (buddyFailures.length > 0) {
+    throw new BuddyInstallError(buddyFailures);
+  }
+  return true;
 }
 
 function printHelp() {
@@ -116,4 +307,19 @@ function main() {
   process.exit(1);
 }
 
-main();
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  BuddyInstallError,
+  SUITE_SKILL,
+  copyDirectory,
+  installBuddySkill,
+  installAllSkills,
+  installPackageSkill,
+  installSuiteSkill,
+  replaceDirectory,
+  resolveComponentPackageRoot,
+  resolveNpxInvocation,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanskill",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Guandata BI Skills 聚合安装包 - 一次性安装和更新 guancli、guands、guanetl、guanwf、guanvis、guanmetric",
   "bin": {
     "guanskill": "bin/run.js",
@@ -12,23 +12,28 @@
     "guanmetric": "bin/run.js"
   },
   "scripts": {
+    "build": "node scripts/sync-skill.js",
+    "test": "npm run build && node scripts/sync-skill.test.js && node scripts/install-skill.test.js && node scripts/preflight.test.js && node scripts/pack.test.js",
+    "prepack": "npm run build",
+    "skillhub:dry-run": "npm run build && skillhub publish ./skillhub/guandata-cli-suite --host https://api.skillhub.cn --dry-run",
     "check-changelog": "node ../../scripts/check-release-changelog.js .",
-    "prepublishOnly": "npm run check-changelog && node scripts/preflight.js"
+    "prepublishOnly": "npm run test && npm run check-changelog && node scripts/preflight.js"
   },
   "files": [
     "bin/",
+    "skills/",
     "CHANGELOG.md",
     "LICENSE",
     "LICENSE.zh-CN",
     "README.md"
   ],
   "dependencies": {
-    "@guandata/guancli": "1.0.39",
-    "@guandata/guands": "0.1.19",
+    "@guandata/guancli": "1.0.40",
+    "@guandata/guands": "0.1.20",
     "@guandata/guanetl": "0.1.19",
-    "@guandata/guanwf": "0.1.7",
-    "@guandata/guanvis": "0.1.30",
-    "@guandata/guanmetric": "0.1.0"
+    "@guandata/guanwf": "0.1.820",
+    "@guandata/guanvis": "0.1.31",
+    "@guandata/guanmetric": "0.1.1"
   },
   "keywords": [
     "guandata",
@@ -38,7 +43,7 @@
   ],
   "license": "SEE LICENSE IN LICENSE",
   "engines": {
-    "node": ">=14"
+    "node": ">=14.14.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/skills/guandata-cli-suite/LICENSE

@@ -0,0 +1,133 @@
+Guandata Developer Tools Free Evaluation License
+
+Copyright (c) Hangzhou Guandata Co., Ltd.
+
+This software and its related source code, documentation, examples, packages,
+configuration files, command-line tools, MCP servers, SDKs, plugins, and tool
+integrations are proprietary software of Hangzhou Guandata Co., Ltd. or its
+licensors.
+
+This license applies to Guandata developer tools, including but not limited to
+Guandata CLI, Guandata MCP Server, related npm packages, source code,
+documentation, examples, configuration files, and tool integrations.
+
+1. Free Personal Evaluation Use
+
+Hangzhou Guandata Co., Ltd. grants you a limited, non-exclusive,
+non-transferable, revocable license to use this software free of charge solely
+for personal learning, local testing, technical evaluation, and non-production
+experiments.
+
+This free license does not permit enterprise, commercial, production, internal
+business, team, organizational, hosted, customer-facing, or revenue-generating
+use.
+
+2. Enterprise and Commercial Use
+
+Any use by or for a company, organization, institution, government entity, team,
+client, or other non-individual entity requires a separate commercial license
+from Hangzhou Guandata Co., Ltd.
+
+Enterprise or commercial use includes, but is not limited to:
+
+- use in production, staging, shared, or hosted environments;
+- use for internal business operations or automated business workflows;
+- use by employees, contractors, consultants, service providers, or
+  representatives on behalf of an organization;
+- integration into commercial products, services, platforms, workflows, AI
+  agents, MCP clients, or customer deliverables;
+- connection to, access to, processing of, exposure of, or operation on
+  enterprise data, business systems, customer data, or production data;
+- redistribution, hosting, resale, sublicensing, or provision of this software
+  as part of a paid or unpaid service.
+
+To obtain an enterprise or commercial license, please contact Hangzhou Guandata
+Co., Ltd. through its official sales, support, or business channels.
+
+3. MCP Server and Agent Integration
+
+For Guandata MCP Server or any MCP-compatible tool integration, the free license
+is limited to local personal testing, learning, and non-production evaluation.
+
+The free license does not permit use of the MCP Server in enterprise agent
+platforms, production AI applications, shared team environments,
+customer-facing systems, hosted services, automated business workflows, or
+integrations that access, process, expose, or operate on enterprise data.
+
+Any organizational, commercial, hosted, production, or data-connected use of the
+MCP Server requires a separate commercial license from Hangzhou Guandata Co., Ltd.
+
+4. Restrictions
+
+Unless expressly permitted by this license, reasonably necessary to install and
+use the software as allowed by this license, or expressly permitted by a
+separate written agreement with Hangzhou Guandata Co., Ltd., you may not:
+
+- copy, distribute, sublicense, sell, lease, host, or provide this software to
+  third parties;
+- modify, adapt, translate, create derivative works of, or otherwise alter this
+  software;
+- reverse engineer, decompile, disassemble, or attempt to derive the source
+  code, structure, sequence, organization, or underlying ideas of this software,
+  except to the extent such restriction is prohibited by applicable law;
+- remove or alter copyright, trademark, license, or proprietary notices;
+- use Guandata names, logos, trademarks, product names, or brand assets without
+  permission;
+- use this software in violation of applicable laws, regulations, or third-party
+  rights;
+- circumvent license, access control, usage limitation, telemetry, audit, or
+  security mechanisms, if any.
+
+5. Ownership
+
+Hangzhou Guandata Co., Ltd. and its licensors retain all rights, title, and
+interest in and to this software. No rights are granted except as expressly
+stated in this license.
+
+6. Third-Party Components
+
+Third-party open source components, if any, are licensed under their respective
+licenses. This license applies only to software owned by Hangzhou Guandata Co., Ltd.
+and does not modify any third-party license terms.
+
+7. No Warranty
+
+This software is provided "as is" and "as available", without warranties of any
+kind, whether express, implied, statutory, or otherwise, including but not
+limited to warranties of merchantability, fitness for a particular purpose,
+accuracy, availability, security, and non-infringement.
+
+8. Limitation of Liability
+
+To the maximum extent permitted by applicable law, Hangzhou Guandata Co., Ltd.
+shall not be liable for any indirect, incidental, special, consequential,
+exemplary, or punitive damages, or for any loss of profits, revenue, data,
+goodwill, business opportunity, or business interruption arising from or related
+to this software, even if Hangzhou Guandata Co., Ltd. has been advised of the
+possibility of such damages.
+
+9. Termination
+
+Your rights under this license terminate automatically if you violate any term of
+this license. Upon termination, you must stop using the software and delete all
+copies in your possession or control.
+
+10. Governing Law and Dispute Resolution
+
+This license shall be governed by the laws of the People's Republic of China,
+without regard to its conflict of laws principles.
+
+Any dispute arising from or related to this license or the software shall be
+submitted to the competent court with jurisdiction in Hangzhou, Zhejiang
+Province, China, unless otherwise required by applicable law.
+
+11. Contact
+
+For enterprise licensing, commercial authorization, partnership, procurement, or
+other questions, please contact Hangzhou Guandata Co., Ltd. through its official
+website or official business channels.
+
+12. Language
+
+If this license is provided in multiple languages, the English version controls
+unless Hangzhou Guandata Co., Ltd. expressly states otherwise in writing.

package/skills/guandata-cli-suite/LICENSE.zh-CN

@@ -0,0 +1,82 @@
+观远开发者工具免费评估许可协议
+
+版权所有 (c) 杭州观远数据有限公司。
+
+本软件及其相关源代码、文档、示例、软件包、配置文件、命令行工具、MCP Server、SDK、插件和工具集成，属于杭州观远数据有限公司或其授权方的专有软件。
+
+本协议适用于观远开发者工具，包括但不限于观远 CLI、观远 MCP Server、相关 npm 包、源代码、文档、示例、配置文件和工具集成。
+
+1. 免费个人评估使用
+
+杭州观远数据有限公司授予你一项有限的、非独占的、不可转让的、可撤销的许可，允许你免费使用本软件，但仅限于个人学习、本地测试、技术评估和非生产环境实验。
+
+本免费许可不允许企业使用、商业使用、生产环境使用、内部业务使用、团队使用、组织使用、托管使用、面向客户的使用，或任何直接或间接产生商业收益的使用。
+
+2. 企业及商业使用
+
+任何由公司、组织、机构、政府单位、团队、客户或其他非个人主体进行的使用，或代表上述主体进行的使用，均需事先取得杭州观远数据有限公司的单独商业授权。
+
+企业或商业使用包括但不限于：
+
+- 在生产环境、预发布环境、共享环境或托管环境中使用；
+- 用于内部业务运营或自动化业务流程；
+- 由员工、承包商、顾问、服务商或代理人代表组织使用；
+- 集成到商业产品、服务、平台、工作流、AI 智能体、MCP 客户端或客户交付物中；
+- 连接、访问、处理、暴露或操作企业数据、业务系统、客户数据或生产数据；
+- 对本软件进行分发、托管、转售、再许可，或作为任何付费或免费的服务的一部分提供。
+
+如需企业或商业授权，请通过观远官方销售、支持或商务渠道联系杭州观远数据有限公司。
+
+3. MCP Server 与智能体集成
+
+对于观远 MCP Server 或任何兼容 MCP 的工具集成，免费许可仅限于个人本地测试、学习和非生产环境评估。
+
+免费许可不允许将 MCP Server 用于企业级智能体平台、生产环境 AI 应用、团队共享环境、面向客户的系统、托管服务、自动化业务流程，或任何访问、处理、暴露、操作企业数据的集成场景。
+
+任何组织用途、商业用途、托管用途、生产用途，或涉及企业数据连接的 MCP Server 使用，均需取得杭州观远数据有限公司的单独商业授权。
+
+4. 限制
+
+除非本协议明确允许、为按照本协议安装和使用本软件所合理必需，或杭州观远数据有限公司通过单独书面协议明确允许，你不得：
+
+- 复制、分发、再许可、销售、出租、托管本软件，或向第三方提供本软件；
+- 修改、改编、翻译本软件，创作本软件的衍生作品，或以其他方式变更本软件；
+- 对本软件进行反向工程、反编译、反汇编，或试图获取本软件的源代码、结构、顺序、组织方式或底层思想，但适用法律禁止限制的情形除外；
+- 删除或修改版权、商标、许可或专有权利声明；
+- 未经许可使用杭州观远数据有限公司或观远品牌的名称、标识、商标、产品名称或品牌资产；
+- 以违反适用法律法规或第三方权利的方式使用本软件；
+- 绕过任何许可、访问控制、使用限制、遥测、审计或安全机制。
+
+5. 权利归属
+
+本软件的所有权利、所有权和利益均归杭州观远数据有限公司及其授权方所有。除本协议明确授予的权利外，不授予任何其他权利。
+
+6. 第三方组件
+
+本软件中如包含第三方开源组件，该等组件适用其各自的许可协议。本协议仅适用于杭州观远数据有限公司拥有权利的软件部分，并不修改任何第三方许可条款。
+
+7. 无担保
+
+本软件按“现状”和“现有”基础提供，不作任何明示、默示、法定或其他形式的担保，包括但不限于适销性、特定用途适用性、准确性、可用性、安全性和不侵权担保。
+
+8. 责任限制
+
+在适用法律允许的最大范围内，杭州观远数据有限公司不对因本软件引起或与本软件相关的任何间接、附带、特殊、后果性、惩罚性或惩戒性损害承担责任，也不对利润、收入、数据、商誉、商业机会损失或业务中断承担责任，即使杭州观远数据有限公司已被告知可能发生该等损害。
+
+9. 终止
+
+如果你违反本协议的任何条款，你在本协议项下的权利将自动终止。终止后，你必须停止使用本软件，并删除你持有或控制的所有副本。
+
+10. 适用法律与争议解决
+
+本协议适用中华人民共和国法律，但不包括其冲突法规则。
+
+因本协议或本软件引起或与之相关的任何争议，应提交中国浙江省杭州市有管辖权的人民法院解决，除非适用法律另有强制性规定。
+
+11. 联系方式
+
+如需企业授权、商业许可、合作、采购或有其他问题，请通过观远官方网站或官方商务渠道联系杭州观远数据有限公司。
+
+12. 语言
+
+如本协议提供多个语言版本，除非杭州观远数据有限公司另有明确书面说明，以英文版本为准。

package/skills/guandata-cli-suite/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: guandata-cli-suite
+description: 观远 CLI 套件的统一入口。用户要查询或分析 ETL、数据集、页面、卡片、指标和血缘，读写表单填报数据，创建 SuperApp 模板，管理数据源或数据集，创建修改 ETL，构建图表或仪表板，创建编辑指标，或查询和编排工作流、数据流时使用。根据任务选择 guancli、guands、guanetl、guanvis、guanmetric 或 guanwf；若组件尚未安装，则引导通过 @guandata/guanskill 安装正式套件。
+license: SEE LICENSE IN LICENSE
+---
+
+# 观远 CLI 套件
+
+根据观远数据任务选择对应的正式 CLI Skill，并按目标 Skill 的最新说明完成查询、修改和验证。
+
+## 执行流程
+
+1. 判断用户是在了解能力、请求安装，还是要执行具体任务。
+2. 按“能力路由”选择最贴近主任务的组件；跨域任务再按依赖顺序组合多个组件。
+3. 检查目标组件是否已安装。已安装时使用对应 Skill；未安装时进入“安装套件”流程。
+4. 遵守目标 Skill 的查询、预览、确认、保存、发布和验证规则。
+
+## 能力路由
+
+| 用户意图 | 使用 Skill | 边界 |
+|---|---|---|
+| 查询、分析 ETL、数据集、字段、页面、卡片、血缘、节点 SQL、指标数据，读写表单填报数据，或创建 SuperApp 模板 | `guancli` | 负责查询分析、表单数据 CRUD 和通用入口；不负责修改 ETL、数据集或仪表板 |
+| 管理连接器、账号、数据源、数据集、目录、导入数据、增量更新、刷新调度、计算字段，或创建 SurveyEngine 填报表单 | `guands` | 数据源和数据集写操作，以及表单结构创建 |
+| 新建、修改、调试、保存、运行、取消或调度 ETL | `guanetl` | 查基础元信息时可先配合 `guancli` |
+| 新建、修改、组装卡片、筛选器、指标卡片或仪表板，或做页面截图验证 | `guanvis` | 只查询现有页面或卡片内容时使用 `guancli` |
+| 创建、编辑、删除指标，管理指标主题、目录、公共维度或标准化指标 Excel | `guanmetric` | 指标查询仍使用 `guancli` |
+| 查询、创建、编辑、保存、运行工作流或数据流，编排 Python、子工作流和多节点 DAG | `guanwf` | 工作流引擎能力；普通 ETL 使用 `guanetl` |
+
+典型跨域顺序：先用 `guands` 准备数据层，再按需用 `guanetl` 做复杂转换，最后用 `guanvis` 构建可视化。查询线上资源 ID 或结构时使用 `guancli`。
+
+## 安装套件
+
+先检查 `guanskill` 和目标组件命令是否可用。macOS/Linux 使用：
+
+```bash
+command -v guanskill
+command -v guancli
+```
+
+Windows PowerShell 使用：
+
+```powershell
+Get-Command guanskill
+Get-Command guancli
+```
+
+若未安装，说明将安装六个正式组件；获得用户同意后执行：
+
+```bash
+npm install -g @guandata/guanskill
+guanskill install-skill
+```
+
+安装要求和认证说明以官方文档为准：
+
+`https://www.guandata.com/guandata-cli-installation-guide.md`
+
+安装完成后重新加载目标组件 Skill，再继续原始任务。
+
+需要连接观远环境时检查认证状态：
+
+```bash
+guancli auth status
+```
+
+尚未认证时引导用户执行 `guancli auth login`。

package/skills/guandata-cli-suite/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "观远 CLI 套件"
+  short_description: "统一识别观远数据场景并路由到正式 CLI Skills"
+  default_prompt: "Use $guandata-cli-suite to handle this Guandata task with the appropriate official CLI skill."