rainskills 0.1.9 → 0.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/SKILL.md +1 -1
- package/bin/rainskills-tools.js +19 -11
- package/marketplace/rainskills/.claude-plugin/plugin.json +1 -1
- package/marketplace/rainskills/.codex-plugin/plugin.json +1 -1
- package/marketplace/rainskills/skills/rainskills/SKILL.md +2 -2
- package/package.json +1 -1
- package/rainbond-app-assistant/SKILL.md +9 -5
- package/rainbond-app-version-assistant/SKILL.md +9 -5
- package/rainbond-delivery-verifier/SKILL.md +9 -5
- package/rainbond-env-sync/SKILL.md +9 -5
- package/rainbond-fullstack-bootstrap/SKILL.md +9 -5
- package/rainbond-fullstack-troubleshooter/SKILL.md +9 -5
- package/rainbond-opensource-app-deploy/SKILL.md +6 -2
- package/rainbond-platform-installer/SKILL.md +1 -1
- package/rainbond-platform-installer/scripts/installed-version.js +1 -1
- package/rainbond-platform-installer/scripts/runtime-intents.js +3 -0
- package/rainbond-platform-query/SKILL.md +8 -2
- package/rainbond-project-init/SKILL.md +9 -5
- package/rainbond-template-installer/SKILL.md +9 -5
package/README.md
CHANGED
|
@@ -228,7 +228,7 @@ node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-
|
|
|
228
228
|
|
|
229
229
|
Rainskills 会在用户下一次发起业务动作时,由本地运行时立即返回环境查询结果,并另行启动后台任务静默检查更新。更新只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级;npm 上的新 RC 版本也不参与正式版自动升级。
|
|
230
230
|
|
|
231
|
-
发现更高的正式版后,后台任务只委托到经过校验的精确版本,例如 `rainskills@0.1.
|
|
231
|
+
发现更高的正式版后,后台任务只委托到经过校验的精确版本,例如 `rainskills@0.1.10`,不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills;当前业务继续使用启动时已经加载的版本,最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本,且不会阻塞或改变当前操作。
|
|
232
232
|
|
|
233
233
|
升级只更新 Rainskills 自身,不触发 Rainbond 安装、运行环境选择、登录授权或重新对接,也不会新增 Agent MCP 配置。更新内容仅包括 Skills 和本地 CLI。原始业务操作会继续执行;只有该业务操作本身需要运行环境时,才按既有门禁检查当前连接。可用连接直接复用,401 只重新授权一次,403 立即停止,从未连接过运行环境时才进入环境选择。
|
|
234
234
|
|
package/SKILL.md
CHANGED
|
@@ -38,7 +38,7 @@ Rainskills 安装完成,下一条消息即可直接使用。
|
|
|
38
38
|
|
|
39
39
|
## Manage Runtime Environments
|
|
40
40
|
|
|
41
|
-
环境是全局列表,不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后通过 `node` 以 argv 数组执行;不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`(运行包版本 `rainskills@0.1.
|
|
41
|
+
环境是全局列表,不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后通过 `node` 以 argv 数组执行;不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`(运行包版本 `rainskills@0.1.10`)。
|
|
42
42
|
|
|
43
43
|
- 列表:用本地 launcher 执行 `environment list --json`,只展示名称、类型、状态、是否默认和最近验证时间。
|
|
44
44
|
- 重命名:用本地 launcher 执行 `environment rename --environment-id <uuid> --name <name>`。
|
package/bin/rainskills-tools.js
CHANGED
|
@@ -35,6 +35,11 @@ const RISK_POLICY = Object.freeze({
|
|
|
35
35
|
],
|
|
36
36
|
destructiveFragments: ["delete", "remove", "purge", "destroy"],
|
|
37
37
|
});
|
|
38
|
+
const CALL_OPTION_DEFINITIONS = Object.freeze({
|
|
39
|
+
"--confirm": Object.freeze({ property: "confirmation", pattern: OPERATION_ID_PATTERN }),
|
|
40
|
+
"--skill-id": Object.freeze({ property: "skillId", pattern: SKILL_ID_PATTERN }),
|
|
41
|
+
"--root-skill-id": Object.freeze({ property: "rootSkillId", pattern: SKILL_ID_PATTERN }),
|
|
42
|
+
});
|
|
38
43
|
|
|
39
44
|
const EXIT = Object.freeze({
|
|
40
45
|
USAGE: 2,
|
|
@@ -249,22 +254,25 @@ function parseCommand(args) {
|
|
|
249
254
|
}
|
|
250
255
|
if (command === "call" && remaining.length >= 4 && remaining[1] && remaining[2] === "--input" && remaining[3] === "-") {
|
|
251
256
|
const parsed = { command, toolName: remaining[1], input: remaining[3], operationId };
|
|
252
|
-
const allowed = new Set(["--confirm", "--skill-id", "--root-skill-id"]);
|
|
253
257
|
for (let index = 4; index < remaining.length; index += 2) {
|
|
254
258
|
const option = remaining[index];
|
|
255
259
|
const value = remaining[index + 1];
|
|
256
|
-
|
|
257
|
-
if (
|
|
258
|
-
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
260
|
+
const definition = CALL_OPTION_DEFINITIONS[option];
|
|
261
|
+
if (!definition) {
|
|
262
|
+
throw new BridgeError(`unsupported call option: ${String(option)}`, EXIT.USAGE);
|
|
263
|
+
}
|
|
264
|
+
if (!value || value.startsWith("--")) {
|
|
265
|
+
throw new BridgeError(`call option ${option} requires a value`, EXIT.USAGE);
|
|
266
|
+
}
|
|
267
|
+
if (parsed[definition.property]) {
|
|
268
|
+
throw new BridgeError(`call option ${option} may be provided only once`, EXIT.USAGE);
|
|
269
|
+
}
|
|
270
|
+
if (!definition.pattern.test(value)) {
|
|
271
|
+
throw new BridgeError(`call option ${option} has an invalid value`, EXIT.USAGE);
|
|
265
272
|
}
|
|
266
|
-
|
|
273
|
+
parsed[definition.property] = value;
|
|
267
274
|
}
|
|
275
|
+
return parsed;
|
|
268
276
|
}
|
|
269
277
|
throw new BridgeError("invalid command; use status, list, describe, read, or call", EXIT.USAGE);
|
|
270
278
|
}
|
|
@@ -14,7 +14,7 @@ This is the single marketplace entry for the complete Rainskills product. The in
|
|
|
14
14
|
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.
|
|
15
15
|
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.
|
|
16
16
|
|
|
17
|
-
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.
|
|
17
|
+
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.10 <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.
|
|
18
18
|
|
|
19
19
|
Skills-only 安装不需要 Node.js;CDN fallback 只负责安装 Skill 文件,不代表运行环境连接、应用部署或平台安装已经可执行。用户首次提出需要运行环境的动作时,对应业务 Skill 才检查 Node.js;固定 Rainskills launcher 需要 Node.js 18 或更高版本。缺失或版本过低时保留原始 intent 并停止,等待用户或 agent 明确同意安装或升级 Node.js,安装完成消息不得提前提示 Node.js。
|
|
20
20
|
|
|
@@ -38,7 +38,7 @@ Rainskills 安装完成,下一条消息即可直接使用。
|
|
|
38
38
|
|
|
39
39
|
## Manage Runtime Environments
|
|
40
40
|
|
|
41
|
-
环境是全局列表,不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后通过 `node` 以 argv 数组执行;不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`(运行包版本 `rainskills@0.1.
|
|
41
|
+
环境是全局列表,不是项目绑定。本地状态命令必须定位已安装的同级 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后通过 `node` 以 argv 数组执行;不得为了查询本地环境访问 npm。只有连接或安装环境时才使用与当前技能包一致的固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`(运行包版本 `rainskills@0.1.10`)。
|
|
42
42
|
|
|
43
43
|
- 列表:用本地 launcher 执行 `environment list --json`,只展示名称、类型、状态、是否默认和最近验证时间。
|
|
44
44
|
- 重命名:用本地 launcher 执行 `environment rename --environment-id <uuid> --name <name>`。
|
package/package.json
CHANGED
|
@@ -87,10 +87,14 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
|
|
|
87
87
|
只有“解决办法”确实存在并且可执行时才输出该项。默认用户回复不得出现 `Problem Judgment`、`Actions Taken`、`Verification Result`、`Follow-up Advice`、`Structured Output` 等诊断标题;不得展示内部状态码、枚举、对象字段、YAML、JSON、工具调用记录或英文状态表。只有用户明确要求结构化结果,或者自动化/评测明确要求结构化契约时,才允许输出后文的结构化格式。
|
|
88
88
|
<!-- rainskills-user-result:end -->
|
|
89
89
|
|
|
90
|
-
|
|
91
|
-
|
|
90
|
+
<!-- rainskills-runtime-gate:start -->
|
|
91
|
+
## 运行环境门禁(最高优先级)
|
|
92
92
|
|
|
93
|
-
|
|
93
|
+
### CLI 调用格式(强制)
|
|
94
|
+
|
|
95
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-app-assistant`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
96
|
+
|
|
97
|
+
### 多运行环境操作契约
|
|
94
98
|
|
|
95
99
|
Node.js 前置检查通过后,每次用户业务请求都创建独立操作,不把项目绑定到任何环境、团队或应用。先执行本地 launcher + `["environment", "list", "--json"]`:用户明确说“运行环境/平台”时按环境名选择;明确说“团队”时表示默认环境中的团队;裸名称同时匹配环境和团队时必须让用户确认。未指定环境时使用全局默认环境;默认环境不可用时停止,禁止自动切换到其他环境。
|
|
96
100
|
|
|
@@ -98,7 +102,7 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
|
|
|
98
102
|
|
|
99
103
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
100
104
|
|
|
101
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
105
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止使用 `rainskills@latest`,禁止拼接或执行 shell 字符串。
|
|
102
106
|
|
|
103
107
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后,才使用上面的固定本地 launcher。
|
|
104
108
|
|
|
@@ -110,7 +114,7 @@ description: "Use whenever a user asks to deploy, run, deliver, publish, inspect
|
|
|
110
114
|
```json
|
|
111
115
|
{
|
|
112
116
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
113
|
-
"package_version": "rainskills@0.1.
|
|
117
|
+
"package_version": "rainskills@0.1.10",
|
|
114
118
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
115
119
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
116
120
|
"local_argv": {
|
|
@@ -5,16 +5,20 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
|
|
|
5
5
|
|
|
6
6
|
# Rainbond App Version Assistant
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
<!-- rainskills-runtime-gate:start -->
|
|
9
|
+
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-app-version-assistant`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
15
|
+
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
14
18
|
|
|
15
19
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
20
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
21
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
18
22
|
|
|
19
23
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接运行环境后,才使用上面的固定本地 launcher。
|
|
20
24
|
|
|
@@ -26,7 +30,7 @@ description: "Use when a user explicitly asks for an existing Rainbond app versi
|
|
|
26
30
|
```json
|
|
27
31
|
{
|
|
28
32
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
33
|
+
"package_version": "rainskills@0.1.10",
|
|
30
34
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
35
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
36
|
"local_argv": {
|
|
@@ -37,16 +37,20 @@ description: "Use only when the user explicitly asks for final delivery or acces
|
|
|
37
37
|
只有“解决办法”确实存在并且可执行时才输出该项。默认用户回复不得出现 `Problem Judgment`、`Actions Taken`、`Verification Result`、`Follow-up Advice`、`Structured Output` 等诊断标题;不得展示内部状态码、枚举、对象字段、YAML、JSON、工具调用记录或英文状态表。只有用户明确要求结构化结果,或者自动化/评测明确要求结构化契约时,才允许输出后文的结构化格式。
|
|
38
38
|
<!-- rainskills-user-result:end -->
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
40
|
+
<!-- rainskills-runtime-gate:start -->
|
|
41
|
+
## 运行环境门禁(最高优先级)
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
### CLI 调用格式(强制)
|
|
44
|
+
|
|
45
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-delivery-verifier`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
46
|
+
|
|
47
|
+
### 多运行环境操作契约
|
|
44
48
|
|
|
45
49
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
46
50
|
|
|
47
51
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
48
52
|
|
|
49
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
53
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
50
54
|
|
|
51
55
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接运行环境后,才使用上面的固定本地 launcher。
|
|
52
56
|
|
|
@@ -58,7 +62,7 @@ description: "Use only when the user explicitly asks for final delivery or acces
|
|
|
58
62
|
```json
|
|
59
63
|
{
|
|
60
64
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
61
|
-
"package_version": "rainskills@0.1.
|
|
65
|
+
"package_version": "rainskills@0.1.10",
|
|
62
66
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
63
67
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
64
68
|
"local_argv": {
|
|
@@ -5,16 +5,20 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
|
|
|
5
5
|
|
|
6
6
|
# Rainbond Env Sync
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
<!-- rainskills-runtime-gate:start -->
|
|
9
|
+
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-env-sync`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
15
|
+
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
14
18
|
|
|
15
19
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
20
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
21
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
18
22
|
|
|
19
23
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接运行环境后,才使用上面的固定本地 launcher。
|
|
20
24
|
|
|
@@ -26,7 +30,7 @@ description: "Use when a user explicitly asks to sync non-sensitive preview or p
|
|
|
26
30
|
```json
|
|
27
31
|
{
|
|
28
32
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
33
|
+
"package_version": "rainskills@0.1.10",
|
|
30
34
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
35
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
36
|
"local_argv": {
|
|
@@ -5,16 +5,20 @@ description: "Use only when the user explicitly asks to create the Rainbond app
|
|
|
5
5
|
|
|
6
6
|
# Rainbond Fullstack Bootstrap
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
<!-- rainskills-runtime-gate:start -->
|
|
9
|
+
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-fullstack-bootstrap`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
15
|
+
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
14
18
|
|
|
15
19
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
20
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
21
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
18
22
|
|
|
19
23
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后,才使用上面的固定本地 launcher。
|
|
20
24
|
|
|
@@ -26,7 +30,7 @@ description: "Use only when the user explicitly asks to create the Rainbond app
|
|
|
26
30
|
```json
|
|
27
31
|
{
|
|
28
32
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
33
|
+
"package_version": "rainskills@0.1.10",
|
|
30
34
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
35
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
36
|
"local_argv": {
|
|
@@ -37,16 +37,20 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
|
|
|
37
37
|
只有“解决办法”确实存在并且可执行时才输出该项。默认用户回复不得出现 `Problem Judgment`、`Actions Taken`、`Verification Result`、`Follow-up Advice`、`Structured Output` 等诊断标题;不得展示内部状态码、枚举、对象字段、YAML、JSON、工具调用记录或英文状态表。只有用户明确要求结构化结果,或者自动化/评测明确要求结构化契约时,才允许输出后文的结构化格式。
|
|
38
38
|
<!-- rainskills-user-result:end -->
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
40
|
+
<!-- rainskills-runtime-gate:start -->
|
|
41
|
+
## 运行环境门禁(最高优先级)
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
### CLI 调用格式(强制)
|
|
44
|
+
|
|
45
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-fullstack-troubleshooter`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
46
|
+
|
|
47
|
+
### 多运行环境操作契约
|
|
44
48
|
|
|
45
49
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
46
50
|
|
|
47
51
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
48
52
|
|
|
49
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
53
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
50
54
|
|
|
51
55
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接运行环境后,才使用上面的固定本地 launcher。
|
|
52
56
|
|
|
@@ -58,7 +62,7 @@ description: "Use only when the user explicitly asks for a bounded build, runtim
|
|
|
58
62
|
```json
|
|
59
63
|
{
|
|
60
64
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
61
|
-
"package_version": "rainskills@0.1.
|
|
65
|
+
"package_version": "rainskills@0.1.10",
|
|
62
66
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
63
67
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
64
68
|
"local_argv": {
|
|
@@ -8,13 +8,17 @@ description: "Use when a user wants to deploy an open-source application that is
|
|
|
8
8
|
<!-- rainskills-runtime-gate:start -->
|
|
9
9
|
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-opensource-app-deploy`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
11
15
|
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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` 写入审计元数据。环境、团队和应用只属于本次操作,禁止保存项目级绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问确认。
|
|
14
18
|
|
|
15
19
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
20
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
21
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest`,禁止拼接或执行 shell 字符串。
|
|
18
22
|
|
|
19
23
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后,才使用固定 launcher。
|
|
20
24
|
|
|
@@ -26,7 +30,7 @@ Node.js 前置检查通过后,每次请求先执行本地 launcher + `["enviro
|
|
|
26
30
|
```json
|
|
27
31
|
{
|
|
28
32
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
33
|
+
"package_version": "rainskills@0.1.10",
|
|
30
34
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
35
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
36
|
"local_argv": {
|
|
@@ -31,7 +31,7 @@ Do not use it to deploy an application to an existing Rainbond. Route those requ
|
|
|
31
31
|
## Workflow
|
|
32
32
|
|
|
33
33
|
1. Read [installation-policy.md](references/installation-policy.md).
|
|
34
|
-
2. Use the installed local launcher `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`; its protected runtime package marker is `rainskills@0.1.
|
|
34
|
+
2. Use the installed local launcher `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`; its protected runtime package marker is `rainskills@0.1.10` 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.
|
|
35
35
|
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。
|
|
36
36
|
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.
|
|
37
37
|
5. Obtain explicit confirmation before sending `y` to the waiting process or rerunning the exact command with `--yes`.
|
|
@@ -175,6 +175,9 @@ function validateIntent(input, { pathApi = path } = {}) {
|
|
|
175
175
|
if (CREDENTIAL_KEY_PATTERN.test(key)) throw new Error(`intent 不能包含凭据字段:${key}`);
|
|
176
176
|
}
|
|
177
177
|
const type = input.type;
|
|
178
|
+
if (type === undefined || type === null || type === "") {
|
|
179
|
+
throw new Error("intent 缺少必填字段:type");
|
|
180
|
+
}
|
|
178
181
|
if (!Object.hasOwn(INTENT_DEFINITIONS, type)) throw new Error(`未知 intent type:${String(type)}`);
|
|
179
182
|
const definition = INTENT_DEFINITIONS[type];
|
|
180
183
|
const allowed = new Set(["type", ...definition.required, ...definition.optional]);
|
|
@@ -8,13 +8,19 @@ description: Use for a user-requested, read-only Rainbond platform query about t
|
|
|
8
8
|
<!-- rainskills-runtime-gate:start -->
|
|
9
9
|
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-platform-query`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
11
15
|
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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`。环境、团队和应用只属于本次操作,禁止保存项目级默认环境或绑定;同一项目可以在多个环境中查询。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
14
18
|
|
|
19
|
+
构造命令前必须先创建完整 intent,并把同一 JSON 原样用于 `operation begin` 和 `runtime connect`。例如查询当前企业时固定为 `{"type":"platform-query","resource":"current-enterprise"}`;不得只传 `resource`。本地 intent 校验失败表示命令尚未发起连接或授权,必须如实报告参数错误,不得表述为授权被拒绝。
|
|
20
|
+
|
|
15
21
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
22
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
23
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
18
24
|
|
|
19
25
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接运行环境后,才使用上面的固定本地 launcher。
|
|
20
26
|
|
|
@@ -26,7 +32,7 @@ Node.js 前置检查通过后,每次请求先执行本地 launcher + `["enviro
|
|
|
26
32
|
```json
|
|
27
33
|
{
|
|
28
34
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
35
|
+
"package_version": "rainskills@0.1.10",
|
|
30
36
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
37
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
38
|
"local_argv": {
|
|
@@ -5,16 +5,20 @@ description: "Use only when the user explicitly asks to initialize or link a loc
|
|
|
5
5
|
|
|
6
6
|
# Rainbond Project Init
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
<!-- rainskills-runtime-gate:start -->
|
|
9
|
+
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-project-init`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
15
|
+
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
14
18
|
|
|
15
19
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
20
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
21
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
18
22
|
|
|
19
23
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后,才使用上面的固定本地 launcher。
|
|
20
24
|
|
|
@@ -26,7 +30,7 @@ description: "Use only when the user explicitly asks to initialize or link a loc
|
|
|
26
30
|
```json
|
|
27
31
|
{
|
|
28
32
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
33
|
+
"package_version": "rainskills@0.1.10",
|
|
30
34
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
35
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
36
|
"local_argv": {
|
|
@@ -5,16 +5,20 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
|
|
|
5
5
|
|
|
6
6
|
# Rainbond Template Installer
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
<!-- rainskills-runtime-gate:start -->
|
|
9
|
+
## 运行环境门禁(最高优先级)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
### CLI 调用格式(强制)
|
|
12
|
+
|
|
13
|
+
所有可变 `call` 都必须使用完整 argv:`call <tool> --input - --operation-id <uuid> --skill-id rainbond-template-installer`。CLI 返回确认 ID 后,只能在同一 argv 末尾加入 `--confirm <confirmation-id>`;不得省略 `--skill-id`、猜测参数,或根据泛化错误反复重试。
|
|
14
|
+
|
|
15
|
+
### 多运行环境操作契约
|
|
12
16
|
|
|
13
17
|
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`。环境、团队和应用只属于本次操作,禁止保存项目绑定;同一项目可以部署到多个环境。明确“团队”表示环境内团队;明确“运行环境/平台”表示环境;裸名称同时匹配环境和团队时必须询问。
|
|
14
18
|
|
|
15
19
|
第一步检查 Node.js 是否存在且主版本不低于 18。Node.js 缺失或低于 18 时,只说明“Rainskills 执行组件需要 Node.js 18 或更高版本”并停止:不选择运行环境,不调用 MCP,不猜测替代命令。只有用户或 agent 明确同意后才安装或升级 Node.js,再从同一原始 intent 继续。
|
|
16
20
|
|
|
17
|
-
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.
|
|
21
|
+
固定 launcher 是 `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`;运行包版本标记为 `rainskills@0.1.10`,且必须与本技能包 `package.json` 一致。把 launcher 与参数拼成 argv 数组直接执行,禁止 `rainskills@latest` 或执行 shell 字符串。
|
|
18
22
|
|
|
19
23
|
本地 launcher 必须从当前 Skill 所在目录的同级目录定位 `rainbond-platform-installer/scripts/local-runtime.js`,解析为绝对路径后使用 `["node", "<绝对路径>"]` 执行。`environment list`、`operation begin`、`operation complete` 和 `runtime message` 只能使用本地 launcher;本地 launcher 只读取已安装文件和本机受保护状态,不得访问 npm 或其它网络。只有用户选定连接或安装运行环境后,才使用上面的固定本地 launcher。
|
|
20
24
|
|
|
@@ -26,7 +30,7 @@ description: "Use when the user explicitly asks to install a local or cloud Rain
|
|
|
26
30
|
```json
|
|
27
31
|
{
|
|
28
32
|
"schema": "rainskills.skill-runtime-contract.v1",
|
|
29
|
-
"package_version": "rainskills@0.1.
|
|
33
|
+
"package_version": "rainskills@0.1.10",
|
|
30
34
|
"launcher": ["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"],
|
|
31
35
|
"local_launcher": ["node", "<installed-skills-root>/rainbond-platform-installer/scripts/local-runtime.js"],
|
|
32
36
|
"local_argv": {
|