@guandata/guanskill 0.1.14 → 0.1.15

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## @guandata/guanskill 0.1.15 - 2026-07-20
+
+- 同步聚合包中的六个组件依赖到本次发布版本。
+- 调整安装后 Skill 刷新流程，由各组件维护自身 Skill，聚合包负责统一套件入口。
+
 ## @guandata/guanskill 0.1.14 - 2026-07-15
 
 - 同步聚合包中的 guands 依赖到 0.1.21。

package/README.md

@@ -25,21 +25,28 @@ guanmetric
 guanskill install-skill
 ```
 
+> `npm install -g` / `npm link` 全局安装时会通过 postinstall 自动执行一次 skill 安装/刷新；上述命令用于手动重装或排查。CI 等无需 skill 的环境可设 `GUAN_SKIP_INSTALL_SKILL=1` 跳过。
+
 该命令还会安装 `guandata-cli-suite`。它负责识别观远数据任务并路由到下列正式组件。
 
 ## 包含组件
 
 | 组件 | 版本 | 用途 |
 |---|---:|---|
-| `@guandata/guancli` | `1.0.40` | 观远 BI 基础命令行工具 |
-| `@guandata/guands` | `0.1.21` | 数据源和数据集管理 |
-| `@guandata/guanetl` | `0.1.19` | ETL 编辑、预览和执行 |
-| `@guandata/guanwf` | `0.1.820` | 工作流数据流管理 |
-| `@guandata/guanvis` | `0.1.31` | 图表、卡片和仪表板构建 |
-| `@guandata/guanmetric` | `0.1.1` | 指标创建、编辑和模板标准化 |
+| `@guandata/guancli` | `1.0.41` | 观远 BI 基础命令行工具 |
+| `@guandata/guands` | `0.1.22` | 数据源和数据集管理 |
+| `@guandata/guanetl` | `0.1.20` | ETL 编辑、预览和执行 |
+| `@guandata/guanwf` | `0.1.821` | 工作流数据流管理 |
+| `@guandata/guanvis` | `0.1.32` | 图表、卡片和仪表板构建 |
+| `@guandata/guanmetric` | `0.1.2` | 指标创建、编辑和模板标准化 |
 
 ## 版本更新
 
+### @guandata/guanskill 0.1.15
+
+- 同步聚合包中的六个组件依赖到本次发布版本。
+- 调整安装后 Skill 刷新流程，由各组件维护自身 Skill，聚合包负责统一套件入口。
+
 ### @guandata/guanskill 0.1.14
 
 - 同步聚合包中的 guands 依赖到 0.1.21。

package/bin/postinstall.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+/**
+ * Best-effort post-install hook: refresh the installed AI skill right after
+ * a global npm install/upgrade, so users cannot forget to run
+ * `guanskill install-skill` and end up with a stale SKILL.md.
+ *
+ * Constraints:
+ * - MUST never fail the npm install: every failure path still exits 0.
+ * - Only runs for global installs (`npm install -g` / `npm link`); a local
+ *   `npm install` inside a project never touches the user's home dirs.
+ * - Escape hatch: GUAN_SKIP_INSTALL_SKILL=1 skips entirely (e.g. CI images
+ *   that install the CLI but never run an AI agent are skipped by default).
+ */
+
+"use strict";
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+
+const CLI_NAME = "guanskill";
+
+function skipReason() {
+  if (process.env.GUAN_SKIP_INSTALL_SKILL === "1") return "GUAN_SKIP_INSTALL_SKILL=1";
+  if (process.env.npm_config_global !== "true") return "not a global install";
+  if (process.env.CI) return "CI environment";
+  return "";
+}
+
+function main() {
+  const reason = skipReason();
+  if (reason) {
+    console.log(`[${CLI_NAME}] postinstall: skipping automatic install-skill (${reason}).`);
+    return;
+  }
+  // 只装 suite skill：六个组件依赖各自的 postinstall 已经安装了自己的
+  // skill，聚合包再跑 install-skill（全量）会把它们重复装一遍。
+  console.log(`[${CLI_NAME}] postinstall: refreshing suite AI skill (${CLI_NAME} install-suite-skill)...`);
+  const result = spawnSync(
+    process.execPath,
+    [path.join(__dirname, "run.js"), "install-suite-skill"],
+    { stdio: "inherit", env: process.env, timeout: 180000 }
+  );
+  if (result.error || result.status !== 0) {
+    console.warn(
+      `[${CLI_NAME}] postinstall: automatic skill install did not complete` +
+        (result.error ? ` (${result.error.message})` : ` (exit ${result.status})`) +
+        `; run \`${CLI_NAME} install-skill\` manually to refresh SKILL.md.`
+    );
+  }
+}
+
+try {
+  main();
+} catch (err) {
+  console.warn(
+    `[${CLI_NAME}] postinstall: ${err.message}; run \`${CLI_NAME} install-skill\` manually.`
+  );
+}
+process.exit(0);

package/bin/run.js

@@ -189,7 +189,8 @@ function installPackageSkill(pkgRoot, skill, extraArgs, options = {}) {
   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];
+  // --yes: postinstall 等非交互环境下 npx 需要免确认下载 skills CLI
+  const args = ["--yes", "skills", "add", pkgRoot, "--skill", skill, "-g", "-y", ...extraArgs];
   const result = spawn(npxInvocation.command, [...npxInvocation.argsPrefix, ...args], {
     stdio: "inherit",
     env: process.env,
@@ -270,7 +271,8 @@ function printHelp() {
 
 Usage:
   guanskill version
-  guanskill install-skill
+  guanskill install-skill        # 安装全部 skill（六个组件 + suite）
+  guanskill install-suite-skill  # 仅安装 suite skill（postinstall hook 使用）
   guancli <args>
   guands <args>
   guanetl <args>
@@ -301,6 +303,14 @@ function main() {
     installAllSkills(args.slice(1));
     return;
   }
+  // postinstall hook 专用：聚合包全局安装时，六个组件依赖各自的
+  // postinstall 已经安装了自己的 skill，这里只补 suite skill 本身，
+  // 避免 installAllSkills 把组件 skill 重复安装一遍（重复网络请求
+  // 与共享目录写入）。手动修复/重装请用 install-skill（全量）。
+  if (command === "install-suite-skill") {
+    installSuiteSkill(args.slice(1));
+    return;
+  }
 
   console.error(`Unknown guanskill command: ${command}`);
   printHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanskill",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Guandata BI Skills 聚合安装包 - 一次性安装和更新 guancli、guands、guanetl、guanwf、guanvis、guanmetric",
   "bin": {
     "guanskill": "bin/run.js",
@@ -12,6 +12,7 @@
     "guanmetric": "bin/run.js"
   },
   "scripts": {
+    "postinstall": "node bin/postinstall.js",
     "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",
@@ -28,12 +29,12 @@
     "README.md"
   ],
   "dependencies": {
-    "@guandata/guancli": "1.0.40",
-    "@guandata/guands": "0.1.21",
-    "@guandata/guanetl": "0.1.19",
-    "@guandata/guanwf": "0.1.820",
-    "@guandata/guanvis": "0.1.31",
-    "@guandata/guanmetric": "0.1.1"
+    "@guandata/guancli": "1.0.41",
+    "@guandata/guands": "0.1.22",
+    "@guandata/guanetl": "0.1.20",
+    "@guandata/guanwf": "0.1.821",
+    "@guandata/guanvis": "0.1.32",
+    "@guandata/guanmetric": "0.1.2"
   },
   "keywords": [
     "guandata",