rainskills 0.1.9 → 0.1.11

package/README.md

@@ -228,7 +228,7 @@ node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-
 
 Rainskills 会在用户下一次发起业务动作时，由本地运行时立即返回环境查询结果，并另行启动后台任务静默检查更新。更新只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级；npm 上的新 RC 版本也不参与正式版自动升级。
 
-发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.9`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
+发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.11`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
 
 升级只更新 Rainskills 自身，不触发 Rainbond 安装、运行环境选择、登录授权或重新对接，也不会新增 Agent MCP 配置。更新内容仅包括 Skills 和本地 CLI。原始业务操作会继续执行；只有该业务操作本身需要运行环境时，才按既有门禁检查当前连接。可用连接直接复用，401 只重新授权一次，403 立即停止，从未连接过运行环境时才进入环境选择。
 

package/SKILL.md

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

package/bin/rainskills-tools.js

@@ -6,6 +6,7 @@ const https = require("node:https");
 const os = require("node:os");
 const path = require("node:path");
 const { createHash, randomUUID } = require("node:crypto");
+const { spawnSync } = require("node:child_process");
 
 const REQUEST_TIMEOUT_MS = 180_000;
 const INPUT_MAX_BYTES = 1024 * 1024;
@@ -35,6 +36,24 @@ const RISK_POLICY = Object.freeze({
   ],
   destructiveFragments: ["delete", "remove", "purge", "destroy"],
 });
+const CALL_OPTION_DEFINITIONS = Object.freeze({
+  "--confirm": Object.freeze({ property: "confirmation", pattern: OPERATION_ID_PATTERN }),
+  "--skill-id": Object.freeze({ property: "skillId", pattern: SKILL_ID_PATTERN }),
+  "--root-skill-id": Object.freeze({ property: "rootSkillId", pattern: SKILL_ID_PATTERN }),
+});
+const PACKAGE_UPLOAD_FIELDS = Object.freeze([
+  "url", "url_scope", "method", "content_type", "file_field", "authorization",
+]);
+const PACKAGE_UPLOAD_MAX_TIMEOUT_SECONDS = 3600;
+const PLATFORM_QUERY_TO_RESOURCE = Object.freeze({
+  rainbond_get_current_user: "current-user",
+  rainbond_query_enterprises: "current-enterprise",
+  rainbond_query_teams: "teams",
+  rainbond_query_regions: "regions",
+  rainbond_query_apps: "apps",
+  rainbond_get_team_apps: "team-apps",
+  rainbond_query_components: "components",
+});
 
 const EXIT = Object.freeze({
   USAGE: 2,
@@ -124,6 +143,23 @@ function requireRuntimeModule(filename) {
   throw new BridgeError("installed Rainskills CLI runtime is incomplete", EXIT.CONFIG);
 }
 
+function requireRuntimeFile(...segments) {
+  const candidates = [
+    path.resolve(__dirname, "..", ...segments),
+    path.resolve(__dirname, "..", "lib", "rainskills", ...segments),
+    path.resolve(__dirname, "..", "lib", ...segments),
+  ];
+  for (const candidate of candidates) {
+    try {
+      const info = fs.lstatSync(candidate);
+      if (info.isFile() && !info.isSymbolicLink()) return candidate;
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+  }
+  throw new BridgeError("installed Rainskills package upload helper is incomplete", EXIT.CONFIG);
+}
+
 function loadOperationConfig({ homeDir, operationId, includeRuntime }) {
   let operationStore;
   const { createEnvironmentRegistry } = requireRuntimeModule("environment-registry.js");
@@ -219,7 +255,67 @@ function loadConfig({
   return config;
 }
 
+function loadEnvironmentConfig({
+  homeDir = os.homedir(),
+  environmentId,
+} = {}) {
+  const { createEnvironmentRegistry } = requireRuntimeModule("environment-registry.js");
+  const { createEnvironmentCredentialStore } = requireRuntimeModule("environment-credentials.js");
+  const registry = createEnvironmentRegistry({ home: homeDir });
+  const snapshot = registry.read();
+  const selectedId = environmentId || snapshot.default_environment_id;
+  if (!selectedId) {
+    throw new BridgeError("no default Rainbond environment is configured", EXIT.CONFIG);
+  }
+  const environment = snapshot.environments.find((entry) => entry.id === selectedId);
+  if (!environment || environment.connection_state !== "connected") {
+    throw new BridgeError("the selected Rainbond environment is unavailable", EXIT.CONFIG);
+  }
+  let credential;
+  try {
+    credential = createEnvironmentCredentialStore({ home: homeDir }).read({
+      environmentId: environment.id,
+      expectedOrigin: environment.console_origin,
+    });
+  } catch (_error) {
+    throw new BridgeError("the selected Rainbond environment credential is unavailable", EXIT.CONFIG);
+  }
+  const parsed = new URL(environment.console_origin);
+  return {
+    baseUrl: environment.console_origin,
+    jwt: credential.token,
+    environmentId: environment.id,
+    homeDir,
+    allowInsecureHttp: parsed.protocol === "http:",
+    isInsecureHttp: parsed.protocol === "http:",
+  };
+}
+
 function parseCommand(args) {
+  if (args[0] === "query") {
+    const toolName = args[1];
+    if (!Object.hasOwn(PLATFORM_QUERY_TO_RESOURCE, toolName || "")) {
+      throw new BridgeError("platform query tool is not allowed", EXIT.USAGE);
+    }
+    let environmentId;
+    let input;
+    for (let index = 2; index < args.length; index += 2) {
+      const option = args[index];
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new BridgeError("platform query option requires a value", EXIT.USAGE);
+      }
+      if (option === "--environment-id" && !environmentId && OPERATION_ID_PATTERN.test(value)) {
+        environmentId = value;
+      } else if (option === "--input" && input === undefined && value === "-") {
+        input = value;
+      } else {
+        throw new BridgeError("invalid platform query command", EXIT.USAGE);
+      }
+    }
+    if (input !== "-") throw new BridgeError("platform query requires --input -", EXIT.USAGE);
+    return { command: "query", toolName, input, environmentId };
+  }
   const operationIndex = args.indexOf("--operation-id");
   if (
     operationIndex < 0
@@ -244,31 +340,69 @@ function parseCommand(args) {
   if (command === "describe" && remaining.length === 2 && remaining[1]) {
     return { command, toolName: remaining[1], operationId };
   }
+  if (
+    command === "package-upload"
+    && remaining.length === 5
+    && remaining[1] === "--archive"
+    && remaining[2]
+    && !remaining[2].startsWith("--")
+    && remaining[3] === "--input"
+    && remaining[4] === "-"
+  ) {
+    return { command, archive: remaining[2], input: remaining[4], operationId };
+  }
   if (command === "read" && remaining.length === 4 && remaining[1] && remaining[2] === "--input" && remaining[3] === "-") {
     return { command, toolName: remaining[1], input: remaining[3], operationId };
   }
   if (command === "call" && remaining.length >= 4 && remaining[1] && remaining[2] === "--input" && remaining[3] === "-") {
     const parsed = { command, toolName: remaining[1], input: remaining[3], operationId };
-    const allowed = new Set(["--confirm", "--skill-id", "--root-skill-id"]);
     for (let index = 4; index < remaining.length; index += 2) {
       const option = remaining[index];
       const value = remaining[index + 1];
-      if (!allowed.has(option) || !value || value.startsWith("--")) break;
-      if (option === "--confirm" && !parsed.confirmation && OPERATION_ID_PATTERN.test(value)) {
-        parsed.confirmation = value;
-      } else if (option === "--skill-id" && !parsed.skillId && SKILL_ID_PATTERN.test(value)) {
-        parsed.skillId = value;
-      } else if (option === "--root-skill-id" && !parsed.rootSkillId && SKILL_ID_PATTERN.test(value)) {
-        parsed.rootSkillId = value;
-      } else {
-        break;
+      const definition = CALL_OPTION_DEFINITIONS[option];
+      if (!definition) {
+        throw new BridgeError(`unsupported call option: ${String(option)}`, EXIT.USAGE);
+      }
+      if (!value || value.startsWith("--")) {
+        throw new BridgeError(`call option ${option} requires a value`, EXIT.USAGE);
       }
-      if (index + 2 === remaining.length) return parsed;
+      if (parsed[definition.property]) {
+        throw new BridgeError(`call option ${option} may be provided only once`, EXIT.USAGE);
+      }
+      if (!definition.pattern.test(value)) {
+        throw new BridgeError(`call option ${option} has an invalid value`, EXIT.USAGE);
+      }
+      parsed[definition.property] = value;
     }
+    return parsed;
   }
   throw new BridgeError("invalid command; use status, list, describe, read, or call", EXIT.USAGE);
 }
 
+function platformQueryIntent(toolName, argumentsValue) {
+  const resource = PLATFORM_QUERY_TO_RESOURCE[toolName];
+  if (!resource) throw new BridgeError("platform query tool is not allowed", EXIT.USAGE);
+  const intent = { type: "platform-query", resource };
+  for (const field of ["enterprise_id", "team_id"]) {
+    if (argumentsValue[field] !== undefined) intent[field] = argumentsValue[field];
+  }
+  if (argumentsValue.app_id !== undefined) {
+    const value = argumentsValue.app_id;
+    if (!(
+      (Number.isInteger(value) && value > 0)
+      || (typeof value === "string" && /^[1-9][0-9]*$/.test(value))
+    )) {
+      throw new BridgeError("platform query app_id must be a positive integer", EXIT.USAGE);
+    }
+    intent.app_id = String(value);
+  }
+  try {
+    return requireRuntimeModule("runtime-intents.js").validateIntent(intent);
+  } catch (_error) {
+    throw new BridgeError("platform query intent is invalid", EXIT.USAGE);
+  }
+}
+
 function readArguments(input) {
   if (input !== "-") {
     throw new BridgeError("read and call accept JSON only through --input - (stdin)", EXIT.USAGE);
@@ -304,6 +438,80 @@ function readArguments(input) {
   return parsed;
 }
 
+function validatePackageUploadRequest(value) {
+  const allowed = new Set([...PACKAGE_UPLOAD_FIELDS, "timeout"]);
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new BridgeError("package upload request must be an object", EXIT.USAGE);
+  }
+  for (const key of Object.keys(value)) {
+    if (!allowed.has(key)) throw new BridgeError("package upload request has unknown fields", EXIT.USAGE);
+  }
+  if (PACKAGE_UPLOAD_FIELDS.some((key) => typeof value[key] !== "string" || !value[key])) {
+    throw new BridgeError("package upload request is incomplete", EXIT.USAGE);
+  }
+  const timeout = value.timeout === undefined ? 1800 : value.timeout;
+  if (
+    !Number.isInteger(timeout)
+    || timeout < 1
+    || timeout > PACKAGE_UPLOAD_MAX_TIMEOUT_SECONDS
+  ) {
+    throw new BridgeError("package upload timeout is invalid", EXIT.USAGE);
+  }
+  return { ...value, timeout };
+}
+
+function packageUploadEnvironment(baseUrl, source = process.env) {
+  const environment = { RAINBOND_URL: baseUrl };
+  for (const key of [
+    "PATH", "SystemRoot", "WINDIR", "ComSpec", "PATHEXT",
+    "TMPDIR", "TMP", "TEMP", "LANG", "LC_ALL",
+    "HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY",
+    "http_proxy", "https_proxy", "no_proxy",
+    "SSL_CERT_FILE", "SSL_CERT_DIR", "CURL_CA_BUNDLE",
+  ]) {
+    if (typeof source[key] === "string" && source[key]) environment[key] = source[key];
+  }
+  return environment;
+}
+
+function executePackageUpload(command, config, { spawnSyncFn = spawnSync } = {}) {
+  const request = validatePackageUploadRequest(command.argumentsValue);
+  const helper = requireRuntimeFile(
+    "rainbond-fullstack-bootstrap", "scripts", "upload_local_package.py"
+  );
+  const result = spawnSyncFn("python3", [
+    helper,
+    "upload",
+    "--archive", command.archive,
+    "--upload-url", request.url,
+    "--url-scope", request.url_scope,
+    "--method", request.method,
+    "--content-type", request.content_type,
+    "--file-field", request.file_field,
+    "--authorization", request.authorization,
+    "--timeout", String(request.timeout),
+  ], {
+    encoding: "utf8",
+    env: packageUploadEnvironment(config.baseUrl),
+    maxBuffer: 256 * 1024,
+    shell: false,
+    timeout: (request.timeout + 2) * 1000,
+  });
+  if (result.error || result.status !== 0) {
+    throw new BridgeError("package upload failed", EXIT.TOOL);
+  }
+  let payload;
+  try {
+    payload = JSON.parse(result.stdout);
+  } catch {
+    throw new BridgeError("package upload helper returned invalid JSON", EXIT.TRANSPORT);
+  }
+  if (!payload || payload.uploaded !== true || Object.keys(payload).length !== 1) {
+    throw new BridgeError("package upload helper returned an invalid result", EXIT.TRANSPORT);
+  }
+  return payload;
+}
+
 function assertPrivateDirectory(directory) {
   try {
     const stat = fs.lstatSync(directory);
@@ -817,6 +1025,9 @@ async function listTools(config) {
 }
 
 async function execute(command, config) {
+  if (command.command === "package-upload") {
+    return executePackageUpload(command, config);
+  }
   if (command.command === "status") {
     const tools = await listTools(config);
     const cached = loadCachedCatalog(config);
@@ -929,11 +1140,26 @@ async function main(args = process.argv.slice(2)) {
   let argumentRedactions = [];
   try {
     command = parseCommand(args);
-    if (command.command === "read" || command.command === "call") {
+    if (["read", "call", "package-upload", "query"].includes(command.command)) {
       const argumentsValue = readArguments(command.input);
       command.argumentsValue = argumentsValue;
       argumentRedactions = collectArgumentRedactions(argumentsValue);
     }
+    if (command.command === "query") {
+      platformQueryIntent(command.toolName, command.argumentsValue);
+      config = loadEnvironmentConfig({ environmentId: command.environmentId });
+      command = {
+        command: "read",
+        toolName: command.toolName,
+        argumentsValue: command.argumentsValue,
+      };
+      if (config.isInsecureHttp) {
+        process.stderr.write('{"warning":"using insecure HTTP transport"}\n');
+      }
+      const output = await execute(command, config);
+      process.stdout.write(`${JSON.stringify(fitOutput(output))}\n`);
+      return;
+    }
     config = loadConfig({
       includeRuntime: true,
       operationId: command.operationId,
@@ -962,9 +1188,14 @@ module.exports = {
   CATALOG_TTL_MS,
   CLI_VERSION,
   loadConfig,
+  executePackageUpload,
+  packageUploadEnvironment,
   parseEnvFile,
   parseCommand,
+  platformQueryIntent,
+  loadEnvironmentConfig,
   rpcRequest,
+  validatePackageUploadRequest,
 };
 
 if (require.main === module) {

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

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "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.9",
+  "version": "0.1.11",
   "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.9 <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.11 <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 `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.9`）。
+环境是全局列表，不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后通过 `node` 以 argv 数组执行；不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.11`）。
 
 - 列表：用本地 launcher 执行 `environment list --json`，只展示名称、类型、状态、是否默认和最近验证时间。
 - 重命名：用本地 launcher 执行 `environment rename --environment-id <uuid> --name <name>`。

package/package.json

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

package/rainbond-app-assistant/SKILL.md

@@ -87,10 +87,14 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
   只有“解决办法”确实存在并且可执行时才输出该项。默认用户回复不得出现 `Problem Judgment`、`Actions Taken`、`Verification Result`、`Follow-up Advice`、`Structured Output` 等诊断标题；不得展示内部状态码、枚举、对象字段、YAML、JSON、工具调用记录或英文状态表。只有用户明确要求结构化结果，或者自动化/评测明确要求结构化契约时，才允许输出后文的结构化格式。
   <!-- rainskills-user-result:end -->
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-app-assistant`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次用户业务请求都创建独立操作，不把项目绑定到任何环境、团队或应用。先执行本地 launcher + `["environment", "list", "--json"]`：用户明确说“运行环境/平台”时按环境名选择；明确说“团队”时表示默认环境中的团队；裸名称同时匹配环境和团队时必须让用户确认。未指定环境时使用全局默认环境；默认环境不可用时停止，禁止自动切换到其他环境。
 
@@ -98,7 +102,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 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止使用 `rainskills@latest`，禁止拼接或执行 shell 字符串。
+  固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定本地 launcher。
 
@@ -110,7 +114,7 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
   ```json
   {
     "schema": "rainskills.skill-runtime-contract.v1",
-    "package_version": "rainskills@0.1.9",
+    "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
     "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
     "local_argv": {

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

@@ -5,16 +5,20 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
 
 # Rainbond App Version Assistant
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-app-version-assistant`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接运行环境后，才使用上面的固定本地 launcher。
 
@@ -26,7 +30,7 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

package/rainbond-delivery-verifier/SKILL.md

@@ -37,16 +37,20 @@ description: "Use only when the user explicitly asks for final delivery or acces
 只有“解决办法”确实存在并且可执行时才输出该项。默认用户回复不得出现 `Problem Judgment`、`Actions Taken`、`Verification Result`、`Follow-up Advice`、`Structured Output` 等诊断标题；不得展示内部状态码、枚举、对象字段、YAML、JSON、工具调用记录或英文状态表。只有用户明确要求结构化结果，或者自动化/评测明确要求结构化契约时，才允许输出后文的结构化格式。
 <!-- rainskills-user-result:end -->
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-delivery-verifier`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接运行环境后，才使用上面的固定本地 launcher。
 
@@ -58,7 +62,7 @@ description: "Use only when the user explicitly asks for final delivery or acces
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

package/rainbond-env-sync/SKILL.md

@@ -5,16 +5,20 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
 
 # Rainbond Env Sync
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-env-sync`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接运行环境后，才使用上面的固定本地 launcher。
 
@@ -26,7 +30,7 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

package/rainbond-fullstack-bootstrap/SKILL.md

@@ -5,16 +5,20 @@ description: "Use only when the user explicitly asks to create the Rainbond app
 
 # Rainbond Fullstack Bootstrap
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-fullstack-bootstrap`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定本地 launcher。
 
@@ -26,7 +30,7 @@ description: "Use only when the user explicitly asks to create the Rainbond app
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

package/rainbond-fullstack-bootstrap/modules/40-source-and-package-rules.md

@@ -240,19 +240,15 @@ Follow this transaction in the exact order below:
    - capture the helper's `archive_path`, `file_name`, `generated`, and `staging_root` result fields
    - a supported package file is reused directly; a directory is converted to a zip archive by the helper
 2. Call `rainbond_init_package_upload` with Rainbond context only. It must return a non-empty `event_id` and an `upload_request`. Do not continue when either is absent or malformed.
-3. Run `upload_local_package.py upload` locally with `archive_path` plus the exact returned `upload_request` contract:
-   - `upload_request.url` -> `--upload-url`
-   - `upload_request.url_scope` -> `--url-scope`
-   - `upload_request.method` -> `--method`
-   - `upload_request.content_type` -> `--content-type`
-   - `upload_request.file_field` -> `--file-field`
-   - `upload_request.authorization` -> `--authorization`
-   - do not invent a URL, authorization mode, form field, HTTP method, or content type; the helper validates the same-Console-origin upload contract before invoking HTTP
+3. Run the protected local CLI command `package-upload --archive <archive_path> --input - --operation-id <uuid>` using the fixed CLI launcher defined by the active Skill, passing the complete `upload_request` object through stdin as JSON:
+   - the CLI resolves the Console origin from the environment already bound to the protected operation; never ask the user for `RAINBOND_URL` and never take it from the current shell
+   - do not add `RAINBOND_URL`, JWT, upload credentials, or a Console address to argv or stdin
+   - do not invent or rewrite the URL, authorization mode, form field, HTTP method, content type, or timeout; the CLI validates the same-Console-origin upload contract before invoking the local helper
 4. Run `upload_local_package.py cleanup` immediately after the HTTP attempt returns, whether upload succeeded, failed, or timed out. Pass the captured `archive_path`, `staging_root`, and `generated` flag. This cleanup must finish or be reported before any upload-status or component-create call.
 5. If and only if the HTTP upload succeeded, call `rainbond_get_package_upload_status(event_id=...)`. The returned uploaded-file status must be non-empty and must identify at least one uploaded file.
 6. If and only if status is non-empty, call `rainbond_create_component_from_package(event_id=...)`. Package creation is event-based; no local filesystem path belongs in this call.
 
-The helper command is `python3 rainbond-fullstack-bootstrap/scripts/upload_local_package.py <prepare|upload|cleanup> ...`. Preserve its JSON result fields exactly between phases; do not reconstruct paths or upload parameters from memory.
+The helper command is used directly only for `prepare` and `cleanup`: `python3 rainbond-fullstack-bootstrap/scripts/upload_local_package.py <prepare|cleanup> ...`. The HTTP upload must use the protected local CLI `package-upload` command. Preserve JSON result fields exactly between phases; do not reconstruct paths or upload parameters from memory.
 
 ### Cleanup and Stop Rules
 

package/rainbond-fullstack-troubleshooter/SKILL.md

@@ -37,16 +37,20 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
 只有“解决办法”确实存在并且可执行时才输出该项。默认用户回复不得出现 `Problem Judgment`、`Actions Taken`、`Verification Result`、`Follow-up Advice`、`Structured Output` 等诊断标题；不得展示内部状态码、枚举、对象字段、YAML、JSON、工具调用记录或英文状态表。只有用户明确要求结构化结果，或者自动化/评测明确要求结构化契约时，才允许输出后文的结构化格式。
 <!-- rainskills-user-result:end -->
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-fullstack-troubleshooter`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接运行环境后，才使用上面的固定本地 launcher。
 
@@ -58,7 +62,7 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

package/rainbond-opensource-app-deploy/SKILL.md

@@ -8,13 +8,17 @@ description: "Use when a user wants to deploy an open-source application that is
 <!-- rainskills-runtime-gate:start -->
 ## 运行环境门禁（最高优先级）
 
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-opensource-app-deploy`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
 ### 多运行环境操作契约
 
 Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`。此后每个 Rainbond 能力调用只能通过受保护的本地 Rainskills CLI 执行，并携带同一 operation ID；CLI 会将 `rainskills_operation_id` 写入审计元数据。环境、团队和应用只属于本次操作，禁止保存项目级绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问确认。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest`，禁止拼接或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接或安装运行环境后，才使用固定 launcher。
 
@@ -26,7 +30,7 @@ Node.js 前置检查通过后，每次请求先执行本地 launcher + `["enviro
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

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 installed local launcher `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`; its protected runtime package marker is `rainskills@0.1.9` and 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 installed local launcher `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`; its protected runtime package marker is `rainskills@0.1.11` and 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/installed-version.js

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

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

@@ -175,6 +175,9 @@ function validateIntent(input, { pathApi = path } = {}) {
     if (CREDENTIAL_KEY_PATTERN.test(key)) throw new Error(`intent 不能包含凭据字段：${key}`);
   }
   const type = input.type;
+  if (type === undefined || type === null || type === "") {
+    throw new Error("intent 缺少必填字段：type");
+  }
   if (!Object.hasOwn(INTENT_DEFINITIONS, type)) throw new Error(`未知 intent type：${String(type)}`);
   const definition = INTENT_DEFINITIONS[type];
   const allowed = new Set(["type", ...definition.required, ...definition.optional]);

package/rainbond-platform-query/SKILL.md

@@ -8,32 +8,38 @@ description: Use for a user-requested, read-only Rainbond platform query about t
 <!-- rainskills-runtime-gate:start -->
 ## 运行环境门禁（最高优先级）
 
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-platform-query`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
 ### 多运行环境操作契约
 
-Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认环境不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目级默认环境或绑定；同一项目可以在多个环境中查询。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
+Node.js 前置检查通过后，平台只读查询只执行一次本地 `rainskills-tools.js query`。用户未指定运行环境时，不得先执行 `environment list`，由 CLI 直接使用全局默认环境；默认环境缺失或不可用时停止且不回退。用户明确指定运行环境时，才允许执行一次本地 launcher + `["environment", "list", "--json"]` 解析不可变环境 ID，随后执行带 `--environment-id` 的单次查询。CLI 直接从受保护环境注册表读取环境与凭据，校验完整 `platform-query` intent 后调用 Rainbond；只读查询不创建 `operation_id` 或 operation 记录。Agent 禁止生成 UUID、禁止传 `--intent-json`，也禁止调用 `operation begin` 或 `operation complete`。环境、团队和应用只属于本次查询，禁止保存项目级默认环境或绑定；同一项目可以在多个环境中查询。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
+
+查询入口只接受固定 Tool 映射：`rainbond_get_current_user`、`rainbond_query_enterprises`、`rainbond_query_teams`、`rainbond_query_regions`、`rainbond_query_apps`、`rainbond_get_team_apps`、`rainbond_query_components`。resource 和 intent 由 CLI 从 Tool 与输入参数构造并校验，Agent 不得自行拼接。CLI 参数校验失败表示命令尚未发起 Rainbond 查询，必须如实报告本地参数错误，不得表述为授权被拒绝。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接运行环境后，才使用上面的固定本地 launcher。
+本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`，解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。仅在用户明确指定环境时使用 `environment list`；`runtime message` 仍使用本地 launcher。本地 launcher 只读取已安装文件和本机受保护状态，不得访问 npm 或其它网络。
 
-所有 Rainbond 查询和变更必须通过本地 `~/.rainbond/bin/rainskills-tools.js` 执行，并绑定本次 operation ID。禁止 Agent 直接调用 Rainbond MCP，也不得启动本地 Rainskills MCP 服务；只允许执行 CLI 返回的结构化结果与确认续接 argv。
+所有 Rainbond 查询必须通过本地 `~/.rainbond/bin/rainskills-tools.js` 的单次 `query` 命令执行。默认环境 argv 固定为 `["node", "<home>/.rainbond/bin/rainskills-tools.js", "query", "<tool>", "--input", "-"]`；明确环境 argv 固定为 `["node", "<home>/.rainbond/bin/rainskills-tools.js", "query", "<tool>", "--environment-id", "<environment-id>", "--input", "-"]`。JSON 只经 stdin 输入。禁止 Agent 直接调用 Rainbond MCP，也不得启动本地 Rainskills MCP 服务；不得把一次查询拆成 `environment list`、`operation begin`、`read`、`operation complete` 四次执行。
 
-只有 CLI 返回并通过校验的 `rainskills.next-action.v1` argv 才能执行续接。普通失败一律禁止自动重试：不得再次执行原命令，不得执行 `--help`、`sleep`、`rg`、`grep`，不得搜索 Rainskills 源码；同一 `operation complete` 最多执行一次。
+只有 CLI 返回并通过校验的 `rainskills.next-action.v1` argv 才能执行续接。普通失败一律禁止自动重试：不得再次执行原命令，不得执行 `--help`、`sleep`、`rg`、`grep`，不得搜索 Rainskills 源码；只读查询不得手工补跑 `operation begin` 或 `operation complete`。
 
 <!-- rainskills-runtime-contract:start -->
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "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"],
-    "operation-begin": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "operation", "begin", "--operation-id", "<uuid>", "--intent-json", "<intent-json>"],
-    "operation-complete": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "operation", "complete", "--operation-id", "<uuid>"],
-    "runtime-message": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "runtime", "message", "--id", "<message-id>"]
+    "runtime-message": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js", "runtime", "message", "--id", "<message-id>"],
+    "platform-query-default": ["node", "<home>/.rainbond/bin/rainskills-tools.js", "query", "<tool>", "--input", "-"],
+    "platform-query-selected": ["node", "<home>/.rainbond/bin/rainskills-tools.js", "query", "<tool>", "--environment-id", "<environment-id>", "--input", "-"]
   },
   "intents": {
     "platform-query": {"required": ["resource"], "optional": ["enterprise_id", "team_id", "app_id"], "enums": {"resource": ["current-user", "current-enterprise", "teams", "regions", "apps", "team-apps", "components"]}}
@@ -79,7 +85,7 @@ Do not expand a narrow question into related resource queries. Never change reso
    - apps in one team/region: `rainbond_get_team_apps({team_name, region_name})`
    - components: `rainbond_query_components({enterprise_id, app_id})`
 5. `enterprise_id`, `team_name`, and `region_name` must come from current session identity, an earlier query result, or explicit user context. `app_id` must be a positive integer; normalize a decimal string before the Tool call and reject values such as `app-123`.
-6. Use the read contract `read <tool> --input -` when using the CLI. Keep stdout JSON separate from stderr; do not use `2>&1`, `grep`, or `head` to process its output.
+6. Use the one-shot contract `query <tool> --input -` when using the CLI. Keep stdout JSON separate from stderr; do not use `2>&1`, `grep`, or `head` to process its output.
 7. Report only fields needed for the question. Avoid email addresses, internal IDs, connection addresses, and configuration unless explicitly requested.
 
 ## Examples

package/rainbond-project-init/SKILL.md

@@ -5,16 +5,20 @@ description: "Use only when the user explicitly asks to initialize or link a loc
 
 # Rainbond Project Init
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-project-init`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定本地 launcher。
 
@@ -26,7 +30,7 @@ description: "Use only when the user explicitly asks to initialize or link a loc
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {

package/rainbond-template-installer/SKILL.md

@@ -5,16 +5,20 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
 
 # Rainbond Template Installer
 
-  <!-- rainskills-runtime-gate:start -->
-  ## 运行环境门禁（最高优先级）
+<!-- rainskills-runtime-gate:start -->
+## 运行环境门禁（最高优先级）
 
-  ### 多运行环境操作契约
+### CLI 调用格式（强制）
+
+所有可变 `call` 都必须使用完整 argv：`call <tool> --input - --operation-id <uuid> --skill-id rainbond-template-installer`。CLI 返回确认 ID 后，只能在同一 argv 末尾加入 `--confirm <confirmation-id>`；不得省略 `--skill-id`、猜测参数，或根据泛化错误反复重试。
+
+### 多运行环境操作契约
 
   Node.js 前置检查通过后，每次请求先执行本地 launcher + `["environment", "list", "--json"]`，按用户明确指定的运行环境选择不可变环境 ID；未指定时只用全局默认环境，默认不可用时停止且不回退。生成 UUID 后执行本地 launcher + `["operation", "begin", "--operation-id", "<uuid>", "--environment-id", "<id>", "--intent-json", "<intent-json>"]`，并在之后每个 Rainbond MCP 调用中加入 `rainskills_operation_id`。环境、团队和应用只属于本次操作，禁止保存项目绑定；同一项目可以部署到多个环境。明确“团队”表示环境内团队；明确“运行环境/平台”表示环境；裸名称同时匹配环境和团队时必须询问。
 
 第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时，只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止：不选择运行环境，不调用 MCP，不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js，再从同一原始 intent 继续。
 
-固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.9`，且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行，禁止 `rainskills@latest` 或执行 shell 字符串。
+固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`；运行包版本标记为 `rainskills@0.1.11`，且必须与本技能包 `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 或其它网络。只有用户选定连接或安装运行环境后，才使用上面的固定本地 launcher。
 
@@ -26,7 +30,7 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
 ```json
 {
   "schema": "rainskills.skill-runtime-contract.v1",
-  "package_version": "rainskills@0.1.9",
+  "package_version": "rainskills@0.1.11",
     "launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
   "local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
   "local_argv": {