企企 CLI 安装指引
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @77hub/qiqi-cli-installation。
技能介绍
要解决什么问题
在本地或沙箱里接入企企服务业 ERP 的 qiqi CLI 时,常见问题不是「会不会装」,而是装完找不到命令、npm 拉包失败、升级与重装路径不一致,以及首次授权后凭证能否持续可用。本技能面向这些安装与授权前置场景,把诊断和步骤收敛到可复用的文档路径,避免和业务查询、领域动作混在一起。
技能如何工作
技能按场景按需读取文档:安装类(首次安装、升级、重装、npm 取包失败、CLI 缺失或 PATH 恢复)走 installation.md;授权类(首次授权、新增登录身份、凭证存储选择、登录恢复、在线身份验证)走 authorization.md。首次使用应同时覆盖两条线:先验证 qiqi --version 的可执行性,再完成授权并检查 qiqi auth status,并分别汇报结果。
安装与授权就绪后,身份管理、查询、动作与结果核验应交给 qiqi-cli 技能;具体业务语义交给对应领域 Skill。
适用边界
用户明确要求测试环境、联调或验收时,应使用对应的测试环境适配 Skill,而不是本安装指引。其余安装与授权相关诉求,使用本 Skill。
使用场景
- 在新机器或 Agent 沙箱里首次安装 qiqi CLI,先跑通 `qiqi --version` 再完成授权与 `qiqi auth status` 校验。
- 升级或重装后 shell 找不到 `qiqi`,需要按指引恢复 PATH 并确认沙箱内命令可见、可执行。
- 安装过程中 npm 拉取企企相关包失败,需要恢复取包流程并重新完成 CLI 安装。
- 首次接入企企 ERP 或要增加第二个登录身份时,完成授权、选择凭证存储方式并验证在线身份。
适合人员
- 在 CI 或受限沙箱里编排 Agent 的集成工程师,必须先完成 qiqi 安装与可持续授权再交给 qiqi-cli。
- 为客户部署企企 qiqi 的实施或运维人员,经常遇到 PATH 未生效、npm 取包失败等环境问题。
- 本地已装旧版 qiqi、计划升级或重装的后端开发,需要保证升级后命令与登录凭证仍可用。
- 多租户或多身份对接企企时负责凭证管理的开发,需要新增登录身份并确认 `qiqi auth status` 正常。