rainskills 0.1.2 → 0.1.4

package/README.md

@@ -72,7 +72,7 @@ Rainskills 安装完成，下一条消息即可直接使用。
 固定 launcher 来自当前 `package.json` 版本：
 
 ```json
-["npx", "--yes", "rainskills@0.1.2"]
+["npx", "--yes", "rainskills@0.1.4"]
 ```
 
 所有调用都把 launcher 与参数合并成 argv 数组后直接执行；不得使用 `rainskills@latest`，不得把参数拼成 shell 字符串。
@@ -192,21 +192,21 @@ Windows 本地安装是预览能力，也可以改选 Linux 服务器。它要
 
 ```bash
 # 本地单机
-npx --yes rainskills@0.1.2 platform install --onboarding-id <id> \
+npx --yes rainskills@0.1.4 platform install --onboarding-id <id> \
   --location local --mode single-node
 
 # Linux 服务器单机
-npx --yes rainskills@0.1.2 platform install --onboarding-id <id> \
+npx --yes rainskills@0.1.4 platform install --onboarding-id <id> \
   --location server --mode single-node --ssh <user@host>
 
 # 服务器主机集群（自动生成受保护示例文件）
-npx --yes rainskills@0.1.2 platform install --onboarding-id <id> \
+npx --yes rainskills@0.1.4 platform install --onboarding-id <id> \
   --location server --mode host-cluster
 
 # 已有高级 ROI cluster.yaml 才追加：--cluster-config <path>
 
 # 已有 Kubernetes
-npx --yes rainskills@0.1.2 platform install --onboarding-id <id> \
+npx --yes rainskills@0.1.4 platform install --onboarding-id <id> \
   --location server --mode existing-kubernetes \
   --kubeconfig <path> --kube-context <name> --chart-version <version>
 ```
@@ -226,13 +226,13 @@ npx --yes rainskills@0.1.2 platform install --onboarding-id <id> \
 
 ## 更新
 
-Rainskills 会在用户下一次发起业务动作时静默检查更新，且只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级；npm 上的新 RC 版本也不参与正式版自动升级。
+Rainskills 会在用户下一次发起业务动作时，由本地运行时立即返回环境查询结果，并另行启动后台任务静默检查更新。更新只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级；npm 上的新 RC 版本也不参与正式版自动升级。
 
-发现更高的正式版后，当前 launcher 只委托到经过校验的精确版本，例如 `rainskills@1.2.3`，不会执行浮动的 `@latest` 业务代码。新版本先原子刷新已经安装的 Rainskills Skills，再继续原业务操作。版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本继续，不要求用户处理。
+发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@1.2.3`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
 
 升级只更新 Rainskills 自身，不触发 Rainbond 安装、运行环境选择、登录授权、MCP 配置或重新对接。原始业务操作会继续执行；只有该业务操作本身需要运行环境时，才按既有门禁检查当前连接。可用连接直接复用，401 只重新授权一次，403 立即停止，从未连接过运行环境时才进入环境选择。
 
-正在执行或等待恢复的部署、私有平台安装和授权流程继续使用启动时锁定的旧版本，自动升级不会插入这些流程。操作结束后的下一次普通业务请求才会再次检查正式版。
+正在执行的部署、私有平台安装和授权流程继续使用启动时锁定的旧版本，自动升级不会插入这些流程。操作完成后会再次静默调度更新检查；检查进程有固定超时且不向用户输出远程 npx 命令。
 
 如需手工恢复安装，可执行 `npx --yes rainskills@latest --force`；正常使用不需要主动运行更新命令。
 

package/SKILL.md

@@ -38,7 +38,7 @@ Rainskills 安装完成，下一条消息即可直接使用。
 
 ## Manage Runtime Environments
 
-环境是全局列表，不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后通过 `node` 以 argv 数组执行；不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `npx --yes rainskills@0.1.2`。
+环境是全局列表，不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后通过 `node` 以 argv 数组执行；不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `npx --yes rainskills@0.1.4`。
 
 - 列表：用本地 launcher 执行 `environment list --json`，只展示名称、类型、状态、是否默认和最近验证时间。
 - 重命名：用本地 launcher 执行 `environment rename --environment-id <uuid> --name <name>`。

package/bin/rainskills.js

@@ -1049,6 +1049,7 @@ async function runAutoUpdatePhase(args, {
   synchronizeSkills,
   updateState,
   delegate,
+  activeOperationDetector,
 } = {}) {
   const autoUpdate = require(
     "../rainbond-platform-installer/scripts/auto-update.js"
@@ -1067,6 +1068,11 @@ async function runAutoUpdatePhase(args, {
       ) {
         throw new Error("自动升级委托版本不匹配");
       }
+      const detectActive = activeOperationDetector
+        || (() => autoUpdate.hasActiveOperation({ home, platform }));
+      if (detectActive()) {
+        throw new Error("存在正在执行的 Rainskills 操作");
+      }
       (synchronizeSkills || autoUpdate.synchronizeInstalledSkills)({
         packageRoot,
         home,

package/marketplace/rainskills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Install the complete Rainskills AI deployment skill suite as one product.",
   "author": {
     "name": "Goodrain",

package/marketplace/rainskills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Install the complete Rainskills AI deployment skill suite as one product.",
   "author": {
     "name": "Goodrain",

package/marketplace/rainskills/skills/rainskills/SKILL.md

@@ -14,7 +14,7 @@ This is the single marketplace entry for the complete Rainskills product. The in
 3. Keep stdin, stdout, and stderr attached. When `RAINSKILLS_USER_INPUT_REQUIRED` appears, pause for that installer choice. If the installer emits `rainskills.next-action.v1`, execute only its fixed `argv` through the same launcher; never evaluate output as a shell command. If the adjacent `bin/rainskills.js` exists, use it for fixed next actions; otherwise use the same versioned npm package fallback described below.
 4. Stay attached until every independent Skill is installed. Do not select, connect, or configure an application runtime during installation. In the user-facing response, output only the fixed completion message below.
 
-If the adjacent installer is missing, check the local Node.js version before choosing the fallback. With `npx` and Node.js 18 or newer, use `npx --yes rainskills@0.1.2 <target>`. With no Node.js or a version below 18, use `bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) <target>` instead. Omit `<target>` only when the host cannot be determined reliably. Keep either command attached to the interactive terminal. For an update or repair, refresh this marketplace Skill first, then run the installer again; it compares and updates every independent internal Skill.
+If the adjacent installer is missing, check the local Node.js version before choosing the fallback. With `npx` and Node.js 18 or newer, use `npx --yes rainskills@0.1.4 <target>`. With no Node.js or a version below 18, use `bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) <target>` instead. Omit `<target>` only when the host cannot be determined reliably. Keep either command attached to the interactive terminal. For an update or repair, refresh this marketplace Skill first, then run the installer again; it compares and updates every independent internal Skill.
 
 Skills-only 安装不需要 Node.js；CDN fallback 只负责安装 Skill 文件，不代表运行环境连接、应用部署或平台安装已经可执行。用户首次提出需要运行环境的动作时，对应业务 Skill 才检查 Node.js；固定 Rainskills launcher 需要 Node.js 18 或更高版本。缺失或版本过低时保留原始 intent 并停止，等待用户或 agent 明确同意安装或升级 Node.js，安装完成消息不得提前提示 Node.js。
 
@@ -38,7 +38,7 @@ Rainskills 安装完成，下一条消息即可直接使用。
 
 ## Manage Runtime Environments
 
-环境是全局列表，不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后通过 `node` 以 argv 数组执行；不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `npx --yes rainskills@0.1.2`。
+环境是全局列表，不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后通过 `node` 以 argv 数组执行；不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `npx --yes rainskills@0.1.4`。
 
 - 列表：用本地 launcher 执行 `environment list --json`，只展示名称、类型、状态、是否默认和最近验证时间。
 - 重命名：用本地 launcher 执行 `environment rename --environment-id <uuid> --name <name>`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Interactive Rainbond skill installer for Codex and Claude Code",
   "license": "Apache-2.0",
   "homepage": "https://github.com/goodrain/rainskills#readme",

package/pi/rainskills-mcp.ts

@@ -15500,7 +15500,7 @@ function serializeMessage(message) {
 // package.json
 var package_default = {
   name: "rainskills",
-  version: "0.1.2",
+  version: "0.1.4",
   description: "Interactive Rainbond skill installer for Codex and Claude Code",
   license: "Apache-2.0",
   homepage: "https://github.com/goodrain/rainskills#readme",

package/rainbond-app-assistant/SKILL.md

@@ -98,7 +98,7 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
 
   第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-  固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止使用 `rainskills@latest`，禁止拼接或执行 shell 字符串。
+  固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止使用 `rainskills@latest`，禁止拼接或执行 shell 字符串。
 
   本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定 npx launcher。
 
@@ -106,7 +106,7 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
   ```json
   {
     "schema": "rainskills.skill-runtime-contract.v1",
-    "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+    "launcher": ["npx", "--yes", "rainskills@0.1.4"],
     "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
     "local_argv": {
       "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -126,9 +126,9 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
       "existing": ["saas", "private-existing"]
     },
     "connect_argv": {
-      "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-      "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
-      "install-private": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
+      "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+      "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
+      "install-private": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
     }
   }
   ```

package/rainbond-app-version-assistant/SKILL.md

@@ -14,7 +14,7 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接运行环境后，才使用上面的固定 npx launcher。
 
@@ -22,7 +22,7 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -37,8 +37,8 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
   },
   "routes": {"existing": ["saas", "private-existing"]},
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-delivery-verifier/SKILL.md

@@ -46,7 +46,7 @@ description: "Use only when the user explicitly asks for final delivery or acces
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接运行环境后，才使用上面的固定 npx launcher。
 
@@ -54,7 +54,7 @@ description: "Use only when the user explicitly asks for final delivery or acces
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -67,8 +67,8 @@ description: "Use only when the user explicitly asks for final delivery or acces
   },
   "routes": {"existing": ["saas", "private-existing"]},
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-env-sync/SKILL.md

@@ -14,7 +14,7 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接运行环境后，才使用上面的固定 npx launcher。
 
@@ -22,7 +22,7 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -35,8 +35,8 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
   },
   "routes": {"existing": ["saas", "private-existing"]},
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-fullstack-bootstrap/SKILL.md

@@ -14,7 +14,7 @@ description: "Use only when the user explicitly asks to create the Rainbond app
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定 npx launcher。
 
@@ -22,7 +22,7 @@ description: "Use only when the user explicitly asks to create the Rainbond app
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -42,9 +42,9 @@ description: "Use only when the user explicitly asks to create the Rainbond app
     "existing": ["saas", "private-existing"]
   },
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
-    "install-private": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
+    "install-private": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-fullstack-troubleshooter/SKILL.md

@@ -46,7 +46,7 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接运行环境后，才使用上面的固定 npx launcher。
 
@@ -54,7 +54,7 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -67,8 +67,8 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
   },
   "routes": {"existing": ["saas", "private-existing"]},
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-platform-installer/SKILL.md

@@ -31,7 +31,7 @@ Do not use it to deploy an application to an existing Rainbond. Route those requ
 ## Workflow
 
 1. Read [installation-policy.md](references/installation-policy.md).
-2. Use the package-version launcher `["npx", "--yes", "rainskills@0.1.2"]`; its version must equal this package's `package.json`. For a Rainskills marker, first validate schema `rainskills.next-action.v1`, action, onboarding id, and the bounded `argv` array, then append that array to the launcher. Never use `latest` or evaluate a shell string from output.
+2. Use the package-version launcher `["npx", "--yes", "rainskills@0.1.4"]`; its version must equal this package's `package.json`. For a Rainskills marker, first validate schema `rainskills.next-action.v1`, action, onboarding id, and the bounded `argv` array, then append that array to the launcher. Never use `latest` or evaluate a shell string from output.
 3. 在任何平台安装命令之前，先执行 launcher + `["runtime", "message", "--id", "private-deployment-location"]`，并原样输出固定的三项部署位置消息。选择 1 后执行带 `["--location", "local", "--mode", "single-node"]` 的 `platform install`；选择 2 后执行带 `["--location", "server"]` 的 `platform install`，由 helper 继续显示固定的服务器类型消息；选择 3 后执行 launcher + `["runtime", "message", "--id", "private-console-origin"]` 并进入已有环境连接，不得执行 `platform install`。若是没有原始业务 intent 的直接平台安装请求，已有环境连接使用受限 `{"type":"environment-add"}` intent。
 4. Let the helper perform one read-only preflight against the already selected local or remote target, then show resources, blockers, and applicable host changes. Never invoke `platform install` without an explicit `--location`; the helper must not ask for the deployment location again.
 5. Obtain explicit confirmation before sending `y` to the waiting process or rerunning the exact command with `--yes`.

package/rainbond-platform-installer/scripts/auto-update-worker.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawn } = require("node:child_process");
+const os = require("node:os");
+
+const autoUpdate = require("./auto-update.js");
+const { version: installedVersion } = require("./installed-version.js");
+
+const UPDATE_ENTRY = Object.freeze(["runtime", "status", "--json"]);
+const DEFAULT_DELEGATE_TIMEOUT_MS = 30_000;
+const SAFE_ENVIRONMENT_KEYS = Object.freeze([
+  "HOME", "USERPROFILE", "PATH", "Path", "SystemRoot", "ComSpec",
+  "TMPDIR", "TMP", "TEMP", "LANG", "LC_ALL", "HTTP_PROXY",
+  "HTTPS_PROXY", "NO_PROXY", "http_proxy", "https_proxy", "no_proxy",
+]);
+
+function backgroundUpdateEnvironment(source = process.env) {
+  const result = {};
+  for (const key of SAFE_ENVIRONMENT_KEYS) {
+    if (typeof source[key] === "string") result[key] = source[key];
+  }
+  return result;
+}
+
+function terminateChild(child, platform, signal = "SIGTERM") {
+  try {
+    if (platform !== "win32" && Number.isInteger(child.pid)) {
+      process.kill(-child.pid, signal);
+    } else {
+      child.kill(signal);
+    }
+  } catch {
+    try { child.kill(signal); } catch { /* already stopped */ }
+  }
+}
+
+function runBoundedChild(invocation, environment, {
+  platform = process.platform,
+  timeoutMs = DEFAULT_DELEGATE_TIMEOUT_MS,
+  spawnFn = spawn,
+} = {}) {
+  return new Promise((resolve) => {
+    let settled = false;
+    let timedOut = false;
+    let forceTimer = null;
+    const finish = (result) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      if (forceTimer) clearTimeout(forceTimer);
+      resolve(result);
+    };
+    let child;
+    try {
+      child = spawnFn(invocation.executable, invocation.args, {
+        detached: platform !== "win32",
+        env: environment,
+        shell: false,
+        stdio: "ignore",
+        windowsHide: true,
+      });
+    } catch {
+      resolve({ code: 1, signal: null });
+      return;
+    }
+    const timer = setTimeout(() => {
+      timedOut = true;
+      terminateChild(child, platform);
+      forceTimer = setTimeout(() => {
+        terminateChild(child, platform, "SIGKILL");
+        finish({ code: 1, signal: "TIMEOUT" });
+      }, 1000);
+    }, timeoutMs);
+    child.once("error", () => finish({ code: 1, signal: null }));
+    child.once("close", (code, signal) => finish({
+      code: timedOut ? 1 : (code ?? 1),
+      signal: timedOut ? "TIMEOUT" : (signal || null),
+    }));
+  });
+}
+
+async function runBackgroundAutoUpdate({
+  currentVersion = installedVersion,
+  env = backgroundUpdateEnvironment(),
+  home = os.homedir(),
+  platform = process.platform,
+  updateState = autoUpdate.createAutoUpdateState({ home, platform }),
+  checkForUpdate = autoUpdate.checkForStableUpdate,
+  activeOperationDetector = () => autoUpdate.hasActiveOperation({ home, platform }),
+  runDelegated = (invocation, environment) => runBoundedChild(
+    invocation,
+    environment,
+    { platform }
+  ),
+} = {}) {
+  let lease;
+  try {
+    lease = updateState.acquireLease?.() || null;
+  } catch {
+    return { action: "continue", reason: "update-busy" };
+  }
+  try {
+    const decision = await checkForUpdate({
+      args: UPDATE_ENTRY,
+      currentVersion,
+      env,
+      home,
+      platform,
+      activeOperationDetector,
+      updateState,
+    });
+    if (decision.action !== "delegate") return decision;
+    if (activeOperationDetector()) {
+      return { action: "continue", reason: "active-operation" };
+    }
+    const invocation = autoUpdate.buildStableUpdateInvocation(
+      decision.version,
+      UPDATE_ENTRY,
+      { platform }
+    );
+    const environment = autoUpdate.buildStableUpdateEnvironment(env, {
+      fromVersion: currentVersion,
+      targetVersion: decision.version,
+    });
+    const result = await runDelegated(invocation, environment);
+    if (result.code !== 0 || result.signal) {
+      try { updateState.recordFailure?.(); } catch { /* best effort */ }
+      return { action: "continue", reason: "delegated-update-failed" };
+    }
+    return { action: "continue", reason: "updated" };
+  } catch {
+    try { updateState.recordFailure?.(); } catch { /* best effort */ }
+    return { action: "continue", reason: "update-failed" };
+  } finally {
+    lease?.release();
+  }
+}
+
+async function main() {
+  await runBackgroundAutoUpdate();
+}
+
+if (require.main === module) {
+  main().catch(() => {
+    process.exitCode = 0;
+  });
+}
+
+module.exports = {
+  backgroundUpdateEnvironment,
+  main,
+  runBackgroundAutoUpdate,
+  runBoundedChild,
+};

package/rainbond-platform-installer/scripts/auto-update.js

@@ -75,13 +75,18 @@ function fetchOfficialLatest({
 } = {}) {
   return new Promise((resolve, reject) => {
     let settled = false;
+    let req;
+    const deadline = setTimeout(() => {
+      req?.destroy(new Error("npm latest 请求超时"));
+    }, timeoutMs);
     const finish = (error, value) => {
       if (settled) return;
       settled = true;
+      clearTimeout(deadline);
       if (error) reject(error);
       else resolve(value);
     };
-    const req = request(OFFICIAL_LATEST_URL, {
+    req = request(OFFICIAL_LATEST_URL, {
       headers: { accept: "application/json" },
     }, (response) => {
       if (response.statusCode !== 200 || response.headers.location) {
@@ -247,7 +252,17 @@ function hasActiveOperation({
       path.join(home, ".rainbond", "rainskills-onboarding-v1.json"),
       stateStore
     );
-    return Boolean(onboarding && onboarding.stage !== "configured");
+    if (onboarding && onboarding.stage !== "configured") return true;
+    const operationsDirectory = path.join(home, ".rainbond", "rainskills", "operations");
+    if (!fs.existsSync(operationsDirectory)) return false;
+    const directoryInfo = fs.lstatSync(operationsDirectory);
+    if (directoryInfo.isSymbolicLink() || !directoryInfo.isDirectory()) return true;
+    for (const entry of fs.readdirSync(operationsDirectory, { withFileTypes: true })) {
+      if (!entry.isFile() || !entry.name.endsWith(".json")) return true;
+      const operation = stateStore.readProtectedJson(path.join(operationsDirectory, entry.name));
+      if (["awaiting-environment", "active"].includes(operation?.stage)) return true;
+    }
+    return false;
   } catch {
     return true;
   }

package/rainbond-platform-installer/scripts/installed-version.js

@@ -0,0 +1,5 @@
+"use strict";
+
+module.exports = Object.freeze({
+  version: "0.1.4",
+});

package/rainbond-platform-installer/scripts/local-runtime.js

@@ -1,11 +1,51 @@
 #!/usr/bin/env node
 "use strict";
 
+const path = require("node:path");
+const { spawn } = require("node:child_process");
 const { runLocalRuntimeCommand } = require("./local-runtime-commands.js");
+const { backgroundUpdateEnvironment } = require("./auto-update-worker.js");
 
-async function main() {
-  const handled = runLocalRuntimeCommand(process.argv.slice(2));
+function shouldScheduleUpdate(args, env = process.env) {
+  if (env.RAINSKILLS_DISABLE_AUTO_UPDATE === "1") return false;
+  return (
+    args[0] === "environment"
+    && args[1] === "list"
+    && args[2] === "--json"
+  ) || (
+    args[0] === "operation"
+    && args[1] === "complete"
+  );
+}
+
+function spawnBackgroundUpdate({
+  spawnFn = spawn,
+  env = process.env,
+  execPath = process.execPath,
+} = {}) {
+  try {
+    const child = spawnFn(execPath, [path.join(__dirname, "auto-update-worker.js")], {
+      detached: true,
+      env: backgroundUpdateEnvironment(env),
+      shell: false,
+      stdio: "ignore",
+      windowsHide: true,
+    });
+    child.unref();
+  } catch {
+    // Automatic updates are best-effort and never affect the local command.
+  }
+}
+
+async function main({
+  args = process.argv.slice(2),
+  runCommand = runLocalRuntimeCommand,
+  scheduleUpdate = spawnBackgroundUpdate,
+  env = process.env,
+} = {}) {
+  const handled = runCommand(args);
   if (!handled) throw new Error("不支持的本地运行环境命令");
+  if (shouldScheduleUpdate(args, env)) scheduleUpdate({ env });
 }
 
 if (require.main === module) {
@@ -15,4 +55,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = { main };
+module.exports = { main, shouldScheduleUpdate, spawnBackgroundUpdate };

package/rainbond-platform-query/SKILL.md

@@ -14,7 +14,7 @@ Node.js 前置检查通过后，每次请求先执行本地 launcher + `["enviro
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接运行环境后，才使用上面的固定 npx launcher。
 
@@ -22,7 +22,7 @@ Node.js 前置检查通过后，每次请求先执行本地 launcher + `["enviro
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -35,8 +35,8 @@ Node.js 前置检查通过后，每次请求先执行本地 launcher + `["enviro
   },
   "routes": {"existing": ["saas", "private-existing"]},
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-project-init/SKILL.md

@@ -14,7 +14,7 @@ description: "Use only when the user explicitly asks to initialize or link a loc
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定 npx launcher。
 
@@ -22,7 +22,7 @@ description: "Use only when the user explicitly asks to initialize or link a loc
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -35,9 +35,9 @@ description: "Use only when the user explicitly asks to initialize or link a loc
   },
   "routes": {"new": ["saas", "private-existing", "install-private"]},
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
-    "install-private": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
+    "install-private": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
   }
 }
 ```

package/rainbond-template-installer/SKILL.md

@@ -14,7 +14,7 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["npx", "--yes", "rainskills@0.1.2"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["npx", "--yes", "rainskills@0.1.4"]`；版本必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
 
 本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher；本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定 npx launcher。
 
@@ -22,7 +22,7 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "launcher": ["npx", "--yes", "rainskills@0.1.2"],
+  "launcher": ["npx", "--yes", "rainskills@0.1.4"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {
     "environment-list": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "environment", "list", "--json"],
@@ -38,9 +38,9 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
     "existing": ["saas", "private-existing"]
   },
   "connect_argv": {
-    "saas": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
-    "private-existing": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
-    "install-private": ["npx", "--yes", "rainskills@0.1.2", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
+    "saas": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--saas", "--intent-json", "<intent-json>"],
+    "private-existing": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--rainbond-url", "<rainbond-url>", "--intent-json", "<intent-json>"],
+    "install-private": ["npx", "--yes", "rainskills@0.1.4", "runtime", "connect", "<target>", "--install-private", "--location", "<private-location>", "--intent-json", "<intent-json>"]
   }
 }
 ```