千问AI平台技能包（Pack）批量安装

适用场景

用户要求一次性安装某个技能包（Pack，包含多个 Skill 的集合）时使用本文档。Pack 名称需事先已知，当前 CLI 无 pack 搜索命令。

安装单个技能请使用 qianwen skills install，参见 skillhub.md。

一、CLI 就绪

command -v qianwen && qianwen --version   # 要求 >= 1.8.0

• 已安装且版本 >= 1.8.0 → 就绪，直接进入「二、安装技能包」。
• 未安装或版本过低 → 执行 npm install -g @qianwenai/qianwen-cli@latest，安装后以 qianwen --version 校验。

pack-install 是 v1.8.0 新增命令，低版本不支持。

二、安装技能包

⚠️ 安装时 必须用 --dir 指向当前 Agent 的 skills 目录，按「三、推荐安装目录」确定。--dir 指定的目录必须已存在且可写，不存在时先 mkdir -p 创建。

qianwen skills pack-install <pack-name> --dir <skills 目录> --format json

• <pack-name>：必填，bare name（不含 /、不以 @ 开头、不含空白）。
• 成员 Skill 按 full slug 安装到 <baseDir>/skillName。
• 目标目录存在同名非托管目录时该成员失败，其余继续。无 --force，建议用户移走冲突目录或换 --dir。
• 退出码：0=成功；非零=失败（详见 stderr）。

三、推荐安装目录

全局目录可跨项目复用；项目级目录仅供当前项目使用或随仓库共享。下表是推荐目录，不是唯一可用目录。

按以下顺序确定 --dir，命中即停：

1. 用户明确指定目录：使用该目录。若当前 Agent 无法自动识别，仍按要求安装，同时提醒用户配置加载路径。
2. 当前 Agent 已配置或正在使用其他有效的 skills 目录：沿用该目录。
3. 当前 Agent 在下表中：默认使用全局目录；用户要求随仓库共享或项目级目录已存在时，使用项目级目录。
4. 当前 Agent 不在下表中：探测 ~ 和 cwd 下已经存在的 .<agent>/skills/ 或 .agents/skills/ 并确定是否可以沿用；无法确定时查询官方约定。
5. 仍无法确定：暂停安装说明原因并让用户二选一：（1）使用 cwd 作为目标目录；（2）明确指定其他目标目录。用户确认后再安装。

确定目标目录后，必须按以下顺序执行：

1. 检查目标目录是否存在。

2. 若不存在，先通过命令行创建完整路径：

   已复制

   mkdir -p "<目标 skills 目录>"
   

3. 确认目录已创建且可写，再使用 --dir 安装 Skill。

--dir 不会自动创建目录，务必先 mkdir -p。创建或安装失败时必须停止并说明原因，不得省略 --dir、改用其他目录或静默回退到 cwd。

四、安装结果汇报

每次安装结束后，用中文向用户交代以下内容：

• 怎么下的：实际执行的命令（包括 mkdir -p）及整体状态（success / partial / failed）。
• 下到哪里：--dir 的绝对路径，说明目录属性（全局 / 项目级 / 自定义）及是否本次新建。
• 下的什么：逐个列出成员 slug、版本和状态（installed=新装，changed=更新，noop=已最新跳过，failed=失败）；changed 给出前后版本；failed 说明错误及下一步建议。

partial 或 failed 时需额外说明失败成员及建议处理方式。需要重启 Agent 才能生效时一并提示。