旺小宝多租户/项目切换
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2d5fa379/wangxiaobao-switch-project。
技能介绍
要解决什么问题
旺小宝相关 CLI 与技能在跑业务命令前,都需要知道当前激活的租户与项目。账号下往往挂着多个租户、每个租户下又有多个项目;若靠手改 .env 或自己写状态文件,容易和 xiaobao-cli 的权限、路径约定脱节,后续命令还会出现 NO_ACTIVE_PROJECT。
本技能把「列项目 → 选人确认 → 落地激活态」收成一条可重复流程,状态统一由 CLI 写入 ~/.xiaobao/active-project.json。
技能如何工作
- 列清单:执行
xiaobao-cli project list;用户已说出目标名(如「盛世禧悦」)时用--keyword做大小写不敏感的包含过滤,避免从一长串里盲选。 - 展示与确认:按「租户 → 项目」分组编号;多个项目时必须让用户选编号或名称,并二次确认「即将激活的租户/项目」;仅一个项目时也只可在用户确认后激活。
- 落地:确认后调用
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 列全量或带关键字选项目且不能自动选第一个的自动化使用者