Agent Skills
返回列表
旺小宝多租户/项目切换

旺小宝多租户/项目切换

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2d5fa379/wangxiaobao-switch-project。

技能介绍

要解决什么问题

旺小宝相关 CLI 与技能在跑业务命令前,都需要知道当前激活的租户与项目。账号下往往挂着多个租户、每个租户下又有多个项目;若靠手改 .env 或自己写状态文件,容易和 xiaobao-cli 的权限、路径约定脱节,后续命令还会出现 NO_ACTIVE_PROJECT。

本技能把「列项目 → 选人确认 → 落地激活态」收成一条可重复流程,状态统一由 CLI 写入 ~/.xiaobao/active-project.json。

技能如何工作

  1. 列清单:执行 xiaobao-cli project list;用户已说出目标名(如「盛世禧悦」)时用 --keyword 做大小写不敏感的包含过滤,避免从一长串里盲选。
  2. 展示与确认:按「租户 → 项目」分组编号;多个项目时必须让用户选编号或名称,并二次确认「即将激活的租户/项目」;仅一个项目时也只可在用户确认后激活。
  3. 落地:确认后调用 xiaobao-cli project use(四个 flag 必填),由 CLI 写全局状态,供后续命令读取。

查当前激活项应优先用 xiaobao-cli project current,不要为辨认现状而全量 project list。

边界与注意点

  • 执行本技能前须已完成 OAuth 登录(见共享文档 wangxiaobao-shared);token 无效时先 auth login 再重试。
  • 禁止用 fs.writeFile 等方式自写 .env 或状态文件。
  • list 在带 --keyword 且 count == 0 时,应提示换关键字或看全量,勿误判为「账号无项目」。

使用场景

  • 刚登录旺小宝 CLI,准备跑业务命令前,需要先确认并激活正确的租户与项目。
  • 账号下租户和项目很多,只记得小区或案场名,要用关键字过滤 `project list` 再选定目标。
  • 同事让你「切到盛世禧悦」这类具体项目,需要列出匹配项、二次确认后执行 `project use`。
  • 后续命令报 `NO_ACTIVE_PROJECT`,需要查 `project current` 或重新走切换流程写入激活态。

适合人员

  • 日常用 `xiaobao-cli` 对接旺小宝、且会在多个案场/租户间来回切换的实施或集成工程师
  • 负责旺小宝环境联调、需要在测试与生产不同项目上下文间切换的后端或运维工程师
  • 刚接手账号权限、不清楚当前激活的是哪个租户/项目、要先 `project current` 再继续排错的一线支持
  • 用 Agent 代跑旺小宝相关技能、要求 Agent 列全量或带关键字选项目且不能自动选第一个的自动化使用者