rainskills 0.1.41 → 0.1.43

package/README.md

@@ -1,285 +1,165 @@
-# Rainskills
+# RainSkills
 
-Rainskills 是一组面向应用识别、部署、排障和交付的 AI Skills，支持 Codex、Claude Code、Pi Agent、DeepSeek Harness、WorkBuddy 和 Hermes Agent。用户在市场中只会看到一个 `Rainskills` 产品，安装后 11 个 `rainbond-*` Skill 仍会独立触发。
+> 让你的 AI Agent 把当前项目部署上线，并验证页面和 API。
 
-## 安装
+RainSkills 是一组开源 Agent Skills，让 Codex、Claude Code、Pi Agent、
+DeepSeek Harness、WorkBuddy 和 Hermes Agent 能够继续完成应用部署、
+故障排查、交付验证、版本管理和回滚。
 
-从 Skill 市场安装：
+它从 Agent 已经理解的当前项目出发，把前端、后端、数据库、缓存、
+端口和存储组织成 Rainbond 应用。应用可以运行在 Rainbond Cloud、
+你自己的服务器或 Kubernetes 中。
 
-```bash
-npx skills add goodrain/rainskills
-```
-
-Skill 市场当前要求 Node.js 22.20.0 或更高版本。直接运行 npx 安装器最低支持 Node.js 18：
-
-```bash
-npx --yes rainskills
-```
-
-没有合适的 Node.js 时可使用 CDN 入口：
+**AI 负责生成，RainSkills 负责交付，Rainbond 负责持续运行。**
 
-```bash
-bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh)
-```
+[产品介绍](https://www.rainbond.com/rainskills) ·
+[安装与使用](https://www.rainbond.com/docs/ai/rainskills) ·
+[视频教程](https://www.rainbond.com/videos/rainskills-ai-deploy) ·
+[Rainbond Cloud](https://run.rainbond.com)
 
-仅安装 Skills 文件不需要 Node.js，CDN 入口在无 Node.js 时仍可完成这部分安装；这不代表应用部署、运行环境连接或私有平台安装已经可执行。用户首次提出需要运行环境的动作时，Rainskills 执行组件才要求 Node.js 18 或更高版本。
+## 为什么使用 RainSkills
 
-也可以使用客户端 Plugin 市场。
+AI Agent 已经理解了代码、依赖和项目结构。进入部署阶段后，如果改用临时脚本或直接 SSH，
+这些上下文通常需要重新整理，部署结果也很难沉淀为可以持续维护的应用。
 
-Codex：
+| 对比维度 | Agent 直接 SSH / 临时脚本 | RainSkills + Rainbond |
+| --- | --- | --- |
+| 工作起点 | 重新整理服务器、端口、依赖和命令 | 直接复用当前项目上下文 |
+| 应用结构 | 人工拼装进程、数据库、网络和存储 | 用应用拓扑管理组件与依赖 |
+| 失败排查 | 手工寻找构建、容器和网关日志 | Agent 读取构建日志、运行日志、Pod 和平台事件 |
+| 完成标准 | 命令成功或进程已经启动 | 页面和 API 完成实际访问验证 |
+| 权限边界 | Agent 通常直接持有 SSH 或生产凭据 | 浏览器授权、受控工具调用和高风险操作确认 |
+| 后续维护 | 继续维护脚本和服务器差异 | 在同一应用上升级、快照、发布和回滚 |
 
-```bash
-codex plugin marketplace add goodrain/rainskills
-codex plugin add rainskills@goodrain
-```
+RainSkills 更适合多组件应用、自托管环境、私有化交付，以及需要持续排障和版本管理的项目。
 
-Claude Code：
+## RainSkills 如何工作
 
 ```text
-/plugin marketplace add goodrain/rainskills
-/plugin install rainskills@goodrain
-/reload-plugins
+当前项目或部署目标
+  → Codex、Claude Code 等 AI Agent
+  → RainSkills 选择对应的部署、排障或验证 Skill
+  → 首次需要时选择并连接一个 Rainbond 运行环境
+  → Rainbond 构建并运行应用
+  → RainSkills 验证页面、API 和最终访问地址
 ```
 
-DeepSeek Harness：
-
-```bash
-npx --yes rainskills dsh
-```
-
-默认安装到 `${DSH_HOME:-~/.dsh}/skills`。DeepSeek Harness 使用原生 Skill catalog 和 `skill` loader 加载，不配置客户端 MCP。
-
-WorkBuddy：
+RainSkills 安装与运行环境连接是两个阶段。安装完成后可以直接提出部署任务；
+第一次需要 Rainbond 时，Agent 再引导你选择 Cloud、已有私有环境、本机或服务器。
 
-```bash
-npx --yes rainskills workbuddy
-```
+![RainSkills 在 AI Agent 中完成应用部署并返回访问地址](https://grstatic.tos-cn-beijing.volces.com/wechat/rainskills/rainskills-deploy.png)
 
-默认安装到 `${WORKBUDDY_CONFIG_DIR:-~/.workbuddy-ai}/skills`。如果安装发生在一个已经打开的 WorkBuddy 任务中，先刷新 Skill 列表或新建任务；部署时明确指定 Rainbond/Rainskills，或让项目保留 `rainbond.app.json`、`.rainbond/local.json` 标记，以避免被内置 Sites 路由抢占。
+## 快速开始
 
-Hermes Agent：
+使用 Skill 市场安装：
 
 ```bash
-npx --yes rainskills hermes
-```
-
-默认安装到 `${HERMES_HOME:-~/.hermes}/skills`，与其他宿主共用同一 CLI profile 和本地 Rainskills CLI，不配置客户端 MCP。如果安装发生在一个已经打开的 Hermes 会话中，执行 `/reset` 或新建会话后再使用新安装的 Skills。
-
-安装流程支持 Codex、Claude Code、Pi Agent、DeepSeek Harness、WorkBuddy 和 Hermes Agent；所有 Agent 共用同一组 Skills、CLI profile 和本地 Rainskills CLI，不提供单独的客户端 MCP adapter。macOS、Linux 和 WSL 不支持 OpenClaw 安装。不要手工复制 Skill、拼接凭据或修改 Agent 配置。
-
-测试或发布烟测可在安装命令末尾追加 `--no-telemetry`，仅关闭当前进程的匿名安装遥测；普通安装不传该参数时保持默认遥测行为。
-
-非交互安装必须明确指定 `codex`、`claude`、`pi`、`dsh`、`workbuddy`、`hermes` 或 `all`；`all` 不再作为无 target 时的默认值。发布后验证统一执行 `npm run verify:published -- <version>`，该脚本会在临时 HOME 中显式安装全部目标并强制关闭遥测。
-
-## 安装完成时用户会看到什么
-
-安装完成后只完成 Skills 和受保护本地 CLI 的安装并展示能力列表，不选择运行环境、不登录 Rainbond，也不配置 Agent MCP：
-
-```text
-Rainskills 安装完成，下一条消息即可直接使用。
-
-下一步可以直接说：
-
-- 帮我部署当前项目
-- 帮我部署一个 Git 仓库
-- 帮我通过镜像或安装包部署应用
-- 帮我安装一个应用模板
-- 帮我分析当前项目应该如何部署
-
-也可以直接告诉我你想部署什么应用。
-```
-
-用户第一次提出部署、查询、排障、验证、快照或模板安装等需要运行环境的动作时，Rainskills 才检查和连接运行环境。
-
-## 按需连接应用运行环境
-
-每个业务 Skill 都必须先通过相同门禁：
-
-0. 第一步检查 Node.js 是否存在且主版本不低于 18。缺失或低于 18 时，只说明 Rainskills 执行组件需要 Node.js 18 或更高版本并停止；不连接运行环境、不调用 CLI、不猜测替代命令。
-
-固定 launcher 来自当前 `package.json` 版本：
-
-```json
-["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]
+npx skills add goodrain/rainskills
 ```
 
-所有调用都把 launcher 与参数合并成 argv 数组后直接执行；不得使用 `rainskills@latest`，不得把参数拼成 shell 字符串。
-
-1. 本会话首次使用时执行 launcher + `["runtime", "status", "--json"]`。只有返回 `connected` 且 `usable=true` 才进入业务流程。
-2. 本机只保存一个 Rainbond 运行环境。没有环境时使用 `runtime connect` 连接 Cloud、已有私有 Rainbond，或安装一个私有 Rainbond；重新授权使用 `runtime reconnect <target>`。
-3. 所有 Rainbond 查询和变更都直接通过 `~/.rainbond/bin/rainskills-tools.js`。不配置客户端 MCP，不创建业务 runtime operation，不传环境 ID、operation ID 或 intent JSON。
-4. 写操作仍由 CLI 生成 confirmation ID；只有完全相同的输入追加 `--confirm` 后才执行一次。
-5. 安装私有环境时，只消费完成 schema、action、onboarding id 和参数边界校验的 `rainskills.next-action.v1.argv`；onboarding id 只属于平台安装断点。
-
-`deploy`/`create` 允许先只保存动作类型。选择私有环境后，先完整完成本地单机、服务器单机、主机集群或已有 Kubernetes 的平台安装和验收；此阶段不得询问本地项目路径、Git 仓库 URL、镜像地址或安装包路径。恢复到 `project-analysis` 后才识别当前项目或询问缺失的应用来源。
-
-### 新应用环境选择
-
-新应用场景使用以下说明：
-
-> 可以，我会帮你完成应用识别、构建、部署和访问验证。
->
-> 不过目前还没有可用的应用运行环境。
->
-> 你刚安装的 Rainskills 是负责“部署”的 AI 助手，它会分析项目并执行部署流程；Rainbond 负责为应用提供稳定运行环境。
->
-#### 选择运行环境
-
-提示“请选择应用要运行的环境：”，并只显示：
-
-1) 云端环境（免费体验）
-2) 本机环境
-3) 独立服务器
-4) 已有 Rainbond
-
-选择 1 时执行 `saas` route；选择 2 时执行 `install-private` route 并传入 `--location local`；选择 3 时执行 `install-private` route 并传入 `--location server`；选择 4 时询问已有 Rainbond 地址并执行 `private-existing` route。不得显示“私有环境”中间层，不得在进入平台安装器后重复询问部署位置，也不得在环境准备完成前询问应用来源。
-
-选择“部署到独立服务器”后，只显示：
-
-请选择服务器类型：
-
-1、单台服务器（Linux）
-2、三台及以上服务器（Linux）
-3、已有 Kubernetes 集群
-
-### 服务器 SSH 固定流程
-
-部署到独立服务器或主机集群时，流程不再根据 Agent 是否提供可见终端而变化：
-
-1. Rainskills 先使用 `BatchMode=yes` 检查 SSH 免密连接。
-2. 已可连接时直接继续安装流程；不可连接时固定停止，不在 Agent 任务终端里等待密码。
-3. 单台服务器时，用户在系统终端执行一条版本锁定的 `ssh prepare --ssh <user@host> --ssh-port <port>` 命令。
-4. 主机集群时，Rainskills 先检查全部节点，一次列出所有待处理节点的名称、IP 和端口，再只给出一条版本锁定的 `ssh prepare-cluster --cluster-config <path>` 命令。该命令依次处理全部节点，已可免密连接的节点自动跳过；不得逐台显示命令或逐台等待用户回复。
-5. 指纹和一次服务器密码均由系统 SSH 读取；两种命令都只准备公钥连接，不安装 Rainbond。全部节点处理完后，用户统一回复一次“已完成”。
-6. Agent 使用同一版本、同一 `onboarding-id` 和原安装参数继续。不得重新询问环境、安装模式、节点或应用来源。
-7. 后续传输、安装和验收全部使用免密 SSH；系统终端不会继续安装或授权。
-8. Rainbond 验收通过后只进行一次浏览器授权；授权成功后由当前 Agent 会话继续应用任务。
-
-主机密钥发生变化时直接阻断并要求人工核对，不自动替换 `known_hosts`。聊天中永远不接收密码、私钥或 Token。
-
-## 单运行环境
-
-- 本机只保存一个 Rainbond Console origin 和对应凭据。
-- 更换环境时，新凭据通过 live probe 后才覆盖当前运行环境。
-- 连接和重新授权始终进入浏览器 Device Flow，不复用 Shell 中缓存的 JWT。
-- Agent 始终执行受保护的本地 Rainskills CLI，不配置或直接调用客户端 MCP。
-- 项目的 preview/production 配置仍属于应用配置投影，与本机连接的 Rainbond 运行环境不是同一概念。
-
-业务 CLI 默认忽略 Shell 中遗留的 `RAINBOND_URL` / `RAINBOND_JWT`。CI 需要使用环境变量凭据时，显式设置：
+或者直接运行官方安装器：
 
 ```bash
-RAINSKILLS_CREDENTIAL_SOURCE=environment \
-RAINBOND_URL=https://rainbond.example.com \
-RAINBOND_JWT="$RAINBOND_JWT" \
-node ~/.rainbond/bin/rainskills-tools.js status --skill-id rainbond-platform-query
+npx --yes rainskills
 ```
 
-常用命令：
+DeepSeek Harness 用户也可以把 RainSkills bootstrap 作为 profile bundle 安装：
 
 ```bash
-node ~/.rainbond/lib/rainskills/bin/rainskills.js runtime status --json
-node ~/.rainbond/lib/rainskills/bin/rainskills.js runtime reconnect codex
+dsh plugin --profile web add rainskills
 ```
 
-`runtime status` 会通过当前唯一环境执行 live probe。业务 Tool 继续通过 `~/.rainbond/bin/rainskills-tools.js` 调用。
+安装后调用 `/rainskills`，或直接告诉 Agent“安装 RainSkills”。该 bundle 只注册
+bootstrap Skill；完整的 `rainbond-*` Skills 仍由官方安装器统一安装和更新。
 
-### 已有应用环境选择
+`npx` 安装方式需要 Node.js 18 或更高版本。建议使用仍在维护的 Node.js 22 或 24。
 
-查询、排障、修改、交付验证、快照、发布和回滚属于已有应用操作，只让用户选择 Rainbond Cloud 或承载目标应用的已有私有 Rainbond，绝不执行 `install-private`，也不安装一个空的新平台代替目标应用。每个 Skill 的第一句话应匹配当前动作，例如“验证应用交付状态和访问地址”，不要全部写成“部署当前项目”。
+安装完成后，在项目目录告诉 Agent：
 
-### 认证与权限恢复
-
-Rainbond CLI 返回 401 时执行：
-
-```json
-["runtime", "reconnect", "<target>"]
+```text
+帮我部署当前项目，并验证页面和 API。
 ```
 
-只读调用可在重新授权后重试一次。写调用不得自动重放，必须先查询平台真实状态。403 立即停止，不 reconnect。
-
-凭据只由受保护的本地状态和客户端配置处理。不要在聊天、intent、日志或命令行参数中发送密码、JWT、Token 或私钥。
+如果还没有可用的 Rainbond，Agent 会在第一次需要运行环境时让你选择 Cloud、
+已有私有环境、本机或服务器，不会在安装 Skill 时替你决定目标环境。
 
-## 私有 Rainbond 安装
+## 可以直接告诉 Agent 什么
 
-环境选择按渐进流程展示：
+- `帮我部署当前项目`
+- `帮我部署这个 Git 仓库`
+- `帮我通过镜像或安装包部署应用`
+- `帮我安装一个应用模板`
+- `帮我部署 Dify、n8n 或 Harbor`
+- `帮我检查 backend 为什么构建失败`
+- `确认当前应用是否已经交付成功，并给我访问地址`
+- `给当前应用创建快照`
+- `把当前应用回滚到上一个快照`
 
-1. 用户选择“私有环境”后，直接选择部署到本机、独立服务器或已有 Rainbond。
-2. 部署到已有 Rainbond 只询问环境地址，不执行平台安装。
-3. 部署到本机直接进入单机版，不展示 ROI 或 Kubernetes；只有选择独立服务器后，再选择单台 Linux、三台及以上 Linux 或已有 Kubernetes。
+## 支持范围
 
-主机集群支持 1、2 或 N 台 Linux 服务器，不要求固定三台；etcd 节点数必须是正奇数。首次进入该分支时，Rainskills 会生成一份受保护的 `cluster.yaml` 示例文件。用户一次性修改服务器地址、SSH 端口和节点角色后回复“已完成”，Rainskills 会一次列出全部可确定的配置问题；校验通过后只准备全部节点的 SSH 免密连接，再展示拓扑和安装变更供用户确认，不再执行额外的 CPU、内存、磁盘、端口、网络或已有安装检查。生成的文件中不得填写密码、私钥或 Token，SSH 密码仍只由系统 `ssh` 在终端中读取。确认后仅查询 bootstrap 节点架构以选择对应的 ROI 文件，实际安装条件由 ROI 判断。已有 Kubernetes 分支使用指定 kubeconfig 和 context 安装，要求 Kubernetes 1.24 或更高版本。
-
-Windows 本地安装是预览能力，也可以改选 Linux 服务器。它要求 Windows 10 build 19041+ 或 Windows 11 x64、已开启虚拟化并允许 UAC；安装器使用受管 WSL2 环境。macOS 本地路径使用 OrbStack。用户不需要理解这些底层实现。
-
-常用固定参数：
-
-```bash
-# 本地单机
-node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-id <id> \
-  --location local --mode single-node
-
-# Linux 服务器单机
-node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-id <id> \
-  --location server --mode single-node --ssh <user@host>
-
-# 服务器主机集群（自动生成受保护示例文件）
-node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-id <id> \
-  --location server --mode host-cluster
-
-# 已有高级 ROI cluster.yaml 才追加：--cluster-config <path>
-
-# 已有 Kubernetes
-node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-id <id> \
-  --location server --mode existing-kubernetes \
-  --kubeconfig <path> --kube-context <name> --chart-version <version>
-```
+### AI Agent
 
-可以为已有 Kubernetes 追加 `--values <path>`。非交互流程只有在展示预检和系统变更、用户明确同意后才追加 `--yes`。
+- Codex
+- Claude Code
+- Pi Agent
+- DeepSeek Harness
+- WorkBuddy
+- Hermes Agent
 
-### 安全与恢复边界
+### 项目来源
 
-- Console origin 会先规范化、探测并锁定。HTTPS 跨 origin 跳转必须重新确认；明文 HTTP 只允许用户明确确认的可信内网。
-- ROI 和 Helm 制品只从固定官方 HTTPS 来源获取，限制跳转和大小，并锁定版本与摘要；恢复时复用已验证字节。
-- kubeconfig、values、ROI 配置和断点使用受保护文件；所有 kubectl/Helm 调用都绑定固定 kubeconfig、context 和集群 identity。
-- 执行安装前必须完成只读预检和 dry-run（适用时），并单独确认真实下载/安装效果。
-- 取消会停止活动子进程但保留断点。失败或取消后只执行安装器输出的固定重试 argv；不要凭记忆改写命令。
-- 检测到目标、配置、集群 identity、版本或摘要漂移时停止，不静默换目标。
+- 当前本地项目
+- 普通 Git 仓库
+- 本地软件包
+- 私有容器镜像或单镜像组件
+- Compose、Helm 或多镜像描述
+- Dify、n8n、Harbor 等第三方开源应用
+- Rainbond 应用模板
 
-平台安装成功必须验证节点/平台组件、`rbd-app-ui` 和 Console 可访问，再恢复原始应用动作。详细规则见 `rainbond-platform-installer/references/installation-policy.md`。
+Compose、Helm 和第三方应用中的特权容器、Operator、CRD、Job、主机网络或主机目录等语义，
+需要根据当前 Rainbond 能力单独判断，不承诺原样转换所有 Kubernetes 配置。
 
-## 更新
+### 运行环境
 
-Rainskills 会在用户下一次发起业务动作时，由本地运行时立即返回环境查询结果，并另行启动后台任务静默检查更新。更新只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级；npm 上的新 RC 版本也不参与正式版自动升级。
+- Rainbond Cloud
+- 已经运行的私有 Rainbond
+- 本机 Rainbond
+- 独立服务器上的 Rainbond
+- 已有 Kubernetes 集群中的 Rainbond
 
-发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.41`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
+## 安全和权限边界
 
-升级只更新 Rainskills 自身，不触发 Rainbond 安装、运行环境选择、登录授权或重新对接，也不会新增 Agent MCP 配置。更新内容仅包括 Skills 和本地 CLI。原始业务操作会继续执行；只有该业务操作本身需要运行环境时，才按既有门禁检查当前连接。可用连接直接复用，401 只重新授权一次，403 立即停止，从未连接过运行环境时才进入环境选择。
+- 通过浏览器完成 Rainbond 授权，不要求在聊天中粘贴 JWT、密码或私钥。
+- 创建、更新和删除资源前核对目标企业、团队、应用和组件。
+- 删除资源、平台安装、数据变更和其他高风险操作需要明确确认。
+- Rainbond 授权凭据保存在受保护的本地状态中，不写入项目文件。
+- 部署完成后继续验证组件、页面和 API，不把命令成功当作交付完成。
 
-正在执行的部署、私有平台安装和授权流程继续使用启动时锁定的旧版本，自动升级不会插入这些流程。操作完成后会再次静默调度更新检查；检查进程有固定超时且不向用户输出远程 npx 命令。
+用户明确选择在独立服务器安装 Rainbond 时，受控安装流程可能使用 SSH。
+应用部署和后续管理仍通过 Rainbond 应用模型完成，而不是依赖散落的服务器命令。
 
-如需手工恢复安装，可执行 `npx --yes rainskills@latest --force`；正常使用不需要主动运行更新命令。
+## 适合哪些场景
 
-## 包含的 Skill
+- AI Agent 已经写完或修改了项目，需要继续部署。
+- 项目包含前端、后端、数据库、缓存或异步任务。
+- 应用需要运行在自己的服务器、私有云或 Kubernetes 中。
+- 部署完成后仍需日志、升级、快照、发布和回滚。
+- 团队需要复用私有化或客户现场的交付流程。
 
-- `rainbond-app-assistant`
-- `rainbond-app-version-assistant`
-- `rainbond-delivery-verifier`
-- `rainbond-env-sync`
-- `rainbond-fullstack-bootstrap`
-- `rainbond-fullstack-troubleshooter`
-- `rainbond-opensource-app-deploy`
-- `rainbond-platform-installer`
-- `rainbond-platform-query`
-- `rainbond-project-init`
-- `rainbond-template-installer`
+## 哪些场景可能不需要 RainSkills
 
-## 部署类 skill 怎么选
+- 只发布一个接受完全托管的纯静态页面。
+- 团队已经有成熟的内部开发平台和 GitOps 流程。
+- 只是一次性的本地实验，不需要持续运行、排障或回滚。
 
-- 已确认的 Rainbond 市场模板 → `rainbond-template-installer`（一键安装商店模板）
-- 只说“部署 Harbor / Dify / n8n”等第三方开源套件也可以 → `rainbond-opensource-app-deploy` 会自动联网获取官方仓库、文档和 Release 中的部署资料，固定版本并推导组件拓扑；用户已提供 Compose、Helm 或镜像集合时也走这里
-- 部署当前项目、普通 Git 仓库或私有镜像项目 → `rainbond-app-assistant`
+## 文档与支持
 
-Open-source Deploy 将 Compose、Helm 和安装器生成结果作为建模证据，默认创建独立 Rainbond 镜像组件，不依赖 Helm 黑盒导入或用户手工上传 Compose。当前/本地项目线索优先于同名软件，避免把用户自己的 Harbor fork 误判为上游套件。
+- [RainSkills 产品介绍](https://www.rainbond.com/rainskills)
+- [安装与使用文档](https://www.rainbond.com/docs/ai/rainskills)
+- [安装与连接视频教程](https://www.rainbond.com/videos/rainskills-ai-deploy)
+- [市场上架 Runbook](https://github.com/goodrain/rainskills/blob/main/docs/marketplace-publishing.md)
+- [Rainbond 安装文档](https://www.rainbond.com/docs/installation)
+- [提交问题](https://github.com/goodrain/rainskills/issues)
 
 ## License
 

package/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: rainskills
-description: Use when a user asks to install, set up, initialize, update, repair, start using Rainskills, or connect, reconnect, inspect, or replace the single Rainskills runtime.
+description: Install, update, repair, connect, reconnect, inspect, or replace the single Rainskills runtime. Use for Rainskills setup and onboarding, not application deployment.
 ---
 
 # Rainskills
 
-This is the single marketplace entry for the complete Rainskills product. The installer deploys every bundled `rainbond-*` Skill as an independent Skill with its own trigger and responsibility, including the lightweight read-only `rainbond-platform-query` skill. Do not ask the user to choose only one of them.
+This is the single marketplace entry for the complete Rainskills product. The installer deploys every bundled `rainbond-*` Skill as an independent Skill with its own trigger and responsibility, including `rainbond-platform-plugin-manager`, `rainbond-ai-assistant`, and the lightweight read-only `rainbond-platform-query` skill. Do not ask the user to choose only one of them.
 
 ## Initialize
 
@@ -54,7 +54,7 @@ Hermes Agent 中必须使用 `terminal` 以 `background=true` 启动授权命令
 
 DeepSeek Harness 和 WorkBuddy 也必须保持原命令附着直到退出；如果宿主把长命令转成持久终端或后台任务，只能轮询该原始命令句柄，不得另起 `runtime status` 推测授权结果。WorkBuddy 安装后若当前任务的 Skill 清单尚未刷新，在下一条业务动作前先刷新 Skill 列表或新建任务，不得退回内置 Sites 代替 Rainbond 部署。
 
-Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.41`）：
+Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.43`）：
 
 - 状态：执行 `runtime status --json`。
 - 首次连接：执行 `runtime connect <target> --saas` 或 `runtime connect <target> --rainbond-url <Console origin>`。