skills-bulk-installer-zh

name	skills-bulk-installer-zh
description	当用户想在新机器上一次性还原所有归档 skill、清空 ~/.claude/skills/ 后批量恢复、或把 claude_workspace/workflow_skills/ 中新加的 skill 同步到 ~/.claude/skills/ 时使用。触发信号 —— "把我的 skill 全装上"、"一键安装所有 skill"、"在这台机器上配 skill"、"恢复 skill"，或者用户指向一个 workflow_skills/ 归档让你全部安装。**不要**用于只装单个 skill（用户直接 cp 那个目录更快）。

skills-bulk-installer-zh

一次性把整个 workflow_skills/ 归档安装到 ~/.claude/skills/。同时遍历 custom/ 和 third_party/，每个 skill 都落到位；遇到必须用 Claude Code 斜杠命令（插件市场）才能装的，会在最后打印命令清单让用户粘贴。

为什么要有它

claude_workspace/workflow_skills/ 是 skill 的源仓库：custom/ 是自己写的，third_party/ 要么整目录拷贝，要么带 INSTALL.md / README.md 写明安装方法。手动一个一个装太慢且容易漏 —— 这个 skill 把整个流程脚本化。

何时用

• 新机器 / 干净环境 —— 从零拉起 ~/.claude/skills/
• ~/.claude/ 被清掉或者容器重建后
• 别人往 workflow_skills/ 里加了新 skill，用户要拉到本地

如果只想装一个具体的 skill，别用这个 —— cp -r workflow_skills/custom/<name> ~/.claude/skills/ 更直接。

安装器如何分类

源目录形态	动作
custom/<name>/	cp -r 到 ~/.claude/skills/<name>/
third_party/<name>/SKILL.md 存在	整目录拷贝（来源未知或带运行时资源）
third_party/<name>/INSTALL.md 或 README.md 含 git clone …	在 ~/.claude/skills/ 下执行该 git clone 块
third_party/<name>/INSTALL.md 或 README.md 含 /plugin marketplace add …	在脚本末尾打印这些斜杠命令 —— 让用户粘贴到 Claude Code 聊天框

默认不覆盖已存在的 skill 目录，加 --force 才会覆盖；重复跑是安全的。

流程

Step 1 — 定位归档目录

用户一般在项目里调用。脚本默认按 <archive>/installer/skills-bulk-installer-zh/scripts/install.sh 的位置往上推，自动找到归档根。如果不确定，先和用户确认路径。

Step 2 — 先 dry-run

动手前一定先让用户看到会发生什么：

bash <archive>/installer/skills-bulk-installer-zh/scripts/install.sh --dry-run

dry-run 会列出每条 COPIED / SKIP / MANUAL / GIT。和用户一起看一遍，确认无误再继续。

Step 3 — 正式安装

bash <archive>/installer/skills-bulk-installer-zh/scripts/install.sh

只有用户明确要覆盖已存在 skill 时才加 --force。脚本在执行 git clone 块前会询问 y/N，得到用户同意再跑。

Step 4 — 手动完成插件市场安装

脚本最后会打印类似这样的一块：

--- ACTION REQUIRED: paste these into Claude Code chat ---
/plugin marketplace add thedotmack/superpowers
/plugin install superpowers@thedotmack
...

把这一块念给用户，并提醒：Claude Code 的斜杠命令工具调用不到，必须人工粘贴到聊天框；粘完后建议重启会话让新插件 skill 生效。

往归档里添加新 skill

用户问"我新写了个 skill，怎么纳入批量安装？"时：

• 自定义 → cp -r ~/.claude/skills/<name> <archive>/custom/<name>，下次批量安装会自动带上
• 第三方且可复现安装 → 在 <archive>/third_party/<name>/ 下建 INSTALL.md（或 README.md），里面写 git clone 或 /plugin 命令；安装器逐行解析
• 第三方来源不明 → 整个目录拷到 third_party/<name>/（SKILL.md 存在即触发全拷贝模式）

备注

• 脚本只用 bash，零依赖，干净机器即开即用
• 永远不删 skill —— 只有 --force 才覆盖（覆盖时为了 cp 语义会先删目标），其它路径下的文件不会动
• 如果某个第三方 README.md 同时含 git clone 和 /plugin 指令，两块都会处理（git 直接跑、plugin 行打印）