rainskills 0.1.0-rc.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Goodrain Co., Ltd.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing
+   permissions and limitations under the License.

package/README.md

@@ -0,0 +1,374 @@
+# Rainbond Skills
+
+一组面向 Rainbond 日常交付、排障和初始化流程的自定义技能，支持安装到 Claude Code 和 Codex。
+
+## 快速安装
+
+```bash
+npx --yes rainskills
+```
+
+安装器会引导选择 Codex / Claude Code、填写 Rainbond 地址、打开浏览器授权、注册 MCP 并安装 skill。没有 Node.js 或 Node 版本低于 18 时，使用保留的 CDN 安装方式：
+
+```bash
+bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh)
+```
+
+> **给 AI 助手的指引**：
+> - 如果用户的请求是"帮我把这个 repo 装上 / 让我用上这套 Rainbond skills"，优先让用户执行 `npx --yes rainskills`。
+> - 如果用户没有 Node.js、Node.js 低于 18，或 npm registry 不可用，改用上面的 CDN `curl` 命令。
+> - 不要 `git clone` 后手工把目录复制到 `~/.claude/skills` / `~/.codex/skills`。
+> - 不要手工拼 `~/.rainbond/mcp.env`、不要猜 JWT、不要手改 `~/.claude.json` / `~/.codex/config.toml`。
+> - 不要建议 `npm install -g`、`pip install` 或 `make`。`npx` 只是启动包内的 `install.sh`，两种入口使用同一套安装流程。
+> - 如果用户机器上需要换 MCP 服务地址、改默认安装路径，把对应 flag 直接追加到 `npx --yes rainskills` 或 `install.sh` 后面。
+
+## 包含的 Skill
+
+- `rainbond-app-assistant`
+- `rainbond-app-version-assistant`
+- `rainbond-delivery-verifier`
+- `rainbond-env-sync`
+- `rainbond-fullstack-bootstrap`
+- `rainbond-fullstack-troubleshooter`
+- `rainbond-project-init`
+- `rainbond-template-installer`
+
+## 适用场景
+
+这些 skill 适合以下场景：
+
+- 将本地项目首次接入 Rainbond
+- 为已绑定项目同步环境信息
+- 基于镜像或模板在 Rainbond 中完成初始化部署
+- 管理 Rainbond 应用版本中心中的创建快照、发布、本地/云市场发布事件和快照回滚流程
+- 对 Rainbond 全栈应用进行低风险排障
+- 在部署结束后做交付验收
+
+## 安装方式
+
+### 0. 前置条件
+
+- 已安装 `Codex`、`Claude Code`，或两者之一
+- 推荐 Node.js 22 或 24；`npx` 入口最低支持 Node.js 18
+- Node.js 18/20 已结束维护，安装器会警告但仍继续；Node.js 低于 18 请使用 CDN 安装方式
+- 本机可执行 `bash`、`curl`、`python3`；CDN 入口还需要 `tar`
+- 已有可登录的 Rainbond 账号
+
+### 1. 一行命令安装（推荐）
+
+支持 macOS 和 Linux：
+
+```bash
+npx --yes rainskills
+```
+
+npm 包已经携带完整安装器和所有 skill，不会再次下载仓库 tarball。`npx` 保留终端交互，因此选择客户端、填写私有化地址和浏览器授权流程与原安装脚本完全一致。
+
+常用参数可以直接追加：
+
+```bash
+npx --yes rainskills codex --saas
+npx --yes rainskills claude --self-hosted --rainbond-url <url>
+npx --yes rainskills all --force
+```
+
+### 2. CDN 安装（保留的兜底方式）
+
+国内推荐用 OSS 入口（CDN 加速，无需翻墙）：
+
+```bash
+bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh)
+```
+
+海外或源码党可以直接用 GitHub 入口：
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/goodrain/rainskills/main/install.sh)
+```
+
+脚本会按 **用户覆盖 → OSS → GitHub** 的顺序自动尝试下载仓库 tarball，解压到 `~/.rainbond/skills`（可通过 `RAINBOND_SKILLS_HOME` 覆盖），然后继续走交互式安装流程。
+
+可通过环境变量自定义下载源：
+
+- `RAINBOND_SKILLS_TARBALL_URL` — 用户显式指定的 tarball URL（最高优先）
+- `RAINBOND_SKILLS_OSS_URL` — OSS tarball URL（默认 `https://get.rainbond.com/rainskills/rainskills-latest.tar.gz`）
+- `RAINBOND_SKILLS_HOME` — 安装目录（默认 `~/.rainbond/skills`）
+
+> 谨慎模式：如果不想让远程脚本直接执行，可以先下载再阅读：
+>
+> ```bash
+> curl -fsSLO https://get.rainbond.com/rainskills/install.sh
+> less install.sh   # 自行审阅
+> bash install.sh
+> ```
+
+### 3. 已有本地仓库
+
+如果你已经 `git clone` 了 rainbond-skills 仓库，直接进入仓库根目录执行：
+
+```bash
+./install.sh
+```
+
+如果只是让 Codex 或 CI 在非交互模式下覆盖本地 skill，直接执行 `./install.sh --force` 即可；未提供 Rainbond 参数时，脚本会自动跳过 MCP 配置。
+
+### 安装脚本会做的事
+
+不论使用 npx、CDN 还是本地仓库，安装器都会引导你完成这些动作：
+
+- 选择安装到 `Codex`、`Claude Code`，或两个都装
+- 选择 Rainbond 部署形态：
+  - **Rainbond Cloud（SaaS，默认）**：地址固定为 `https://run.rainbond.com`
+  - **私有化部署**：你自己输入 Console 地址；交互选择后会先醒目提示 Rainbond 前置条件、官方快速安装命令和安装文档，但不会中断 RainSkills 流程
+- 浏览器中完成登录并授权（无需在终端输入用户名/密码）
+- 自动接收 JWT 并写入 `~/.rainbond/mcp.env`
+- 自动配置 `Codex` / `Claude Code` 的 RainSkills 专用 MCP 地址
+- 自动把环境变量加载逻辑写入当前 shell 的 rc 文件
+- 自动验证所选客户端的专用 MCP 地址是否可用：
+  - Codex：`/console/mcp/rainskills/codex/query`
+  - Claude Code：`/console/mcp/rainskills/claude-code/query`
+
+#### 安装效果统计
+
+安装脚本会把安装流程状态异步上报到固定地址 `https://log.rainbond.com/api/rainskills/installations`，用于统计脚本执行、授权和配置成功率。每次执行使用一个随机的 `install_attempt_id` 串联以下阶段：
+
+- `started`：脚本开始执行
+- `authorized`：完成 Rainbond 授权，并取得当前企业的 `eid`
+- `configured`：Codex / Claude Code MCP 配置完成
+- `failed`：流程失败，仅记录固定的失败阶段和分类
+
+上报字段只包含安装尝试 ID、`eid`、客户端类型、安装或刷新动作、阶段和状态。不会上报 JWT、账号、密码、用户名、邮箱、Rainbond 地址、原始错误信息或本地代码。统计请求在后台执行；统计服务不可用、超时或企业信息读取失败都不会改变原安装结果。
+
+#### 浏览器登录是怎么发生的
+
+1. 安装脚本在本机起一个临时回调（`http://127.0.0.1:<随机端口>/cli-callback`）。
+2. 自动打开浏览器到 `<Rainbond 地址>/#/cli-auth?callback=...&state=...`。
+3. 浏览器里你按部署形态用现成方式登录（SaaS 是手机号验证码、私有化通常是用户名密码或 SSO）。
+4. 在「授权命令行工具」页面点确认，浏览器把当前账号的 JWT 发回本机回调。
+5. 安装脚本校验 `state`、保存 token，然后继续走完 MCP 配置和验证。
+
+默认技能安装目录：
+
+- `~/.claude/skills`
+- `~/.codex/skills`
+
+#### 显式指定部署形态
+
+```bash
+# npx 模式
+npx --yes rainskills all --saas
+npx --yes rainskills all --self-hosted --rainbond-url <url>
+
+# CDN 模式：参数追加在脚本之后
+bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) all --saas
+bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) all --self-hosted --rainbond-url <url>
+
+# 本地仓库模式
+./install.sh all --saas                                 # Rainbond Cloud
+./install.sh all --self-hosted --rainbond-url <url>     # 私有化
+```
+
+### 4. 只安装到单个平台
+
+只装并配置 Claude Code：
+
+```bash
+npx --yes rainskills claude
+```
+
+只装并配置 Codex：
+
+```bash
+npx --yes rainskills codex
+```
+
+同时装并配置两个平台：
+
+```bash
+npx --yes rainskills all
+```
+
+### 5. CI / 无桌面环境兜底
+
+非交互场景（CI、SSH 远程会话、不带浏览器的服务器）下浏览器登录拿不到 token，可以两条路：
+
+1. **预先在浏览器拿到 JWT 再传进来**（推荐）：
+
+   ```bash
+   ./install.sh all --non-interactive \
+     --self-hosted --rainbond-url https://your-rainbond.example.com \
+     --token "$RAINBOND_JWT"
+   ```
+
+   `RAINBOND_JWT` 可以从浏览器 cookie 拿，或在浏览器里访问 `/#/cli-auth?...` 走一次授权页人工拷贝。
+
+2. **私有化兼容用户名/密码（已不推荐，未来移除）**：
+
+   ```bash
+   ./install.sh all --non-interactive \
+     --self-hosted --rainbond-url http://your-rainbond.example.com:7070 \
+     --username admin \
+     --allow-insecure-http
+   ```
+
+   仅当部署没有开 `USE_SAAS`、确实是用户名/密码模式时可用；SaaS 模式下没有这个登录入口。
+
+如果你的 Rainbond 还是 `http://`，安装脚本会明确提示风险，并要求你确认（交互模式）或要求显式 `--allow-insecure-http`（非交互模式）。
+
+### 6. 当前终端的环境变量说明
+
+脚本会把 JWT 保存到：
+
+```bash
+~/.rainbond/mcp.env
+```
+
+并自动把下面这类加载逻辑写入当前 shell 的 rc 文件：
+
+```bash
+[ -f "$HOME/.rainbond/mcp.env" ] && source "$HOME/.rainbond/mcp.env"
+```
+
+注意：
+
+- 新开的终端会自动加载 `RAINBOND_JWT`
+- 当前已经打开的终端不会被子进程脚本直接改写
+- 安装完成后，如果你想立刻在当前终端运行 `codex` 或 `claude`，请执行脚本最后提示的 `source ~/.zshrc` 或 `source ~/.bashrc`
+
+### 7. 覆盖已安装版本
+
+如果目标目录里已经存在同名 skill，默认会跳过，避免覆盖本地修改。
+
+需要强制覆盖时：
+
+```bash
+npx --yes rainskills --force
+npx --yes rainskills codex --force
+```
+
+### 8. 安装到自定义目录
+
+```bash
+npx --yes rainskills --dest ~/.claude/skills
+npx --yes rainskills --dest ~/.codex/skills --force
+```
+
+`--dest` 适合：
+
+- 调试安装过程
+- 安装到非标准目录
+- 在 CI 或临时目录中做验证
+
+注意：`--dest` 只复制 skill，不会自动配置 Rainbond MCP。
+
+## 更新方式
+
+npx 模式：显式使用 `latest` 并覆盖已有 skill：
+
+```bash
+npx --yes rainskills@latest --force
+```
+
+CDN 模式：再跑一次同一行命令即可。脚本会重新下载最新 tarball 解压到 `~/.rainbond/skills`，然后继续安装流程：
+
+```bash
+bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) --force
+```
+
+本地仓库模式：
+
+```bash
+git pull
+./install.sh --force
+```
+
+如果只想更新某一个平台：
+
+```bash
+./install.sh claude --force
+./install.sh codex --force
+```
+
+## 目录结构
+
+```text
+rainbond-skills/
+  README.md
+  install.sh
+  package.json
+  bin/rainskills.js
+  .gitignore
+  rainbond-app-assistant/
+    SKILL.md
+  rainbond-delivery-verifier/
+    SKILL.md
+  ...
+```
+
+## 产品对象模型
+
+`docs/product-object-model.md` 描述了 skills 之间共享的产品对象（project、app、component、environment、delivery 等）和跨-skill 边界。如果你要扩展某个 skill 的输入/输出，或新增一个 skill，先看它。
+
+## 仓库维护约定
+
+- 每个 skill 使用单独目录，目录名和 skill 名保持一致
+- 每个 skill 至少包含一个 `SKILL.md`
+- 如果后续需要补充 `scripts/`、`references/`、`assets/`，请放在对应 skill 目录下
+- 安装脚本默认复制所有 `rainbond-*` 目录
+
+## 常见问题
+
+### 1. 安装后没有生效
+
+请重启 Claude Code 或 Codex，或者开启一个新的会话。
+
+### 2. 为什么当前终端里还是连不上 MCP
+
+因为 `./install.sh` 是一个子进程，不能直接改写你当前 shell 的环境变量。
+
+处理方式：
+
+- 直接执行脚本最后提示的 `source ~/.zshrc` 或 `source ~/.bashrc`
+- 或者开一个新的终端
+
+### 3. 为什么默认不覆盖已有 skill
+
+因为有些使用者会在本地做二次调整。默认跳过更安全，`--force` 才会覆盖。
+
+### 4. JWT 会保存在哪里
+
+保存在：
+
+```bash
+~/.rainbond/mcp.env
+```
+
+脚本不会保存你的 Rainbond 用户名和密码。
+
+### 5. 用 Claude / Codex 时 MCP 突然返回 401 / 403 怎么办
+
+通常是 `~/.rainbond/mcp.env` 里的 JWT 到期了。无需重装 skills，也不要手工改文件，直接用下面任一命令刷新：
+
+```bash
+npx --yes rainskills refresh
+# 或：bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) refresh
+# 或：bash ~/.rainbond/skills/install.sh refresh
+```
+
+`refresh` 不会改动 skill 文件。它会刷新 `~/.rainbond/mcp.env`，并检查 RainSkills 早期版本写入的旧通用 MCP 地址。只有地址完全等于当前 Rainbond 的 `/console/mcp/query` 且认证配置仍是脚本管理格式时，才会先生成 `.rainskills-backup` 备份，再迁移到对应客户端的专用地址；自定义 MCP 地址不会被修改。迁移失败时会恢复原配置。
+
+注意：刷新完成后必须重启 Claude Code 或 Codex（它们在启动时一次性读取 `RAINBOND_JWT`，已经在跑的进程读到的还是旧 token）。
+
+### 6. 如何确认安装到了哪里
+
+脚本会输出每个目标目录和每个 skill 的安装结果。
+
+## 开发者说明
+
+如果你要新增或修改 skill，建议流程如下：
+
+1. 在仓库里直接修改对应 skill 目录
+2. 先查看 `docs/product-object-model.md`，它是当前产品对象模型和跨-skill 边界的主文档
+3. 执行 `npm test` 跑安装器、包内容和 PTY 信号测试；测试在隔离临时目录中运行，无需输入，也不应打开真实浏览器
+4. 执行 `./install.sh --dest /tmp/rainbond-skills-test --force` 做一次本地验证
+5. 确认无误后再提交到 Git 仓库

package/bin/rainskills.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+const path = require("node:path");
+const { spawn } = require("node:child_process");
+
+function classifyNodeMajor(major) {
+  if (major < 18) {
+    return "unsupported";
+  }
+  if (major === 18 || major === 20) {
+    return "eol";
+  }
+  return "supported";
+}
+
+function run() {
+  const major = Number.parseInt(process.versions.node.split(".", 1)[0], 10);
+  const support = classifyNodeMajor(major);
+
+  if (support === "unsupported") {
+    console.error(
+      `错误：RainSkills 的 npx 安装方式需要 Node.js 18 或更高版本，当前为 ${process.version}。`
+    );
+    console.error(
+      "请升级到 Node.js 22/24，或改用：bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh)"
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  if (support === "eol") {
+    console.error(
+      `警告：当前 ${process.version} 已结束维护；本次仍会继续，建议升级到 Node.js 22 或 24。`
+    );
+  }
+
+  const installerPath = path.resolve(__dirname, "..", "install.sh");
+  const child = spawn("bash", [installerPath, ...process.argv.slice(2)], {
+    env: process.env,
+    stdio: "inherit",
+  });
+  let spawnFailed = false;
+
+  const forwardSigint = () => child.kill("SIGINT");
+  const forwardSigterm = () => child.kill("SIGTERM");
+  process.on("SIGINT", forwardSigint);
+  process.on("SIGTERM", forwardSigterm);
+
+  child.on("error", (error) => {
+    spawnFailed = true;
+    console.error(`错误：无法启动 RainSkills 安装器：${error.message}`);
+    process.exitCode = 1;
+  });
+
+  child.on("close", (code, signal) => {
+    process.removeListener("SIGINT", forwardSigint);
+    process.removeListener("SIGTERM", forwardSigterm);
+
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exitCode = spawnFailed ? 1 : code === null ? 1 : code;
+  });
+}
+
+module.exports = { classifyNodeMajor };
+
+if (require.main === module) {
+  run();
+}