agency-agents-zh 实测：328 个技能 2.2 秒装完，但 Windows 默认跑不了脚本

这套角色库在 Windows 上装一次只要 2.2 秒，但它自带的安装脚本默认跑不起来：Windows 的脚本执行策略会直接拦住 ps1 文件。

我把它装进了自己正在用的工具，skills 目录从 42 个变成 370 个，正好多出 328 个，总体积 11 MB。装完我清理掉了，下面是完整过程。

仓库是 jnMetaCode/agency-agents-zh，21,429 星，一套中文 AI 角色库。每个角色有独立的身份定义、工作规则和交付标准。

Windows 上能直接装吗

不能，要先改一次策略。直接跑安装脚本，系统给的是：

无法加载文件 ...\scripts\install.ps1，因为在此系统上禁止运行脚本。

这是 Windows 默认的 Restricted 执行策略，跟项目本身无关。要把当前进程临时放开：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force

关键是 -Scope Process 这个参数，只对当前窗口有效，关掉就恢复原样，不会改系统设置。如果你不想动策略，也可以直接把 md 文件手动复制到目标目录。

到底有多少个角色

三个地方给的数字不一样，我实测下来是这样：

• README 声明 328 个
• 我按 24 个角色目录数 md 文件，得到 317 个
• 转换脚本跑完输出「已转换 328 个智能体」

差额这 11 个在哪，我这次没有逐个核对。比较可能的情况是脚本把角色目录外的文件也算进去了。

317 个角色的分布，前几名是这样：

剩下 14 个目录每个 1 到 9 个，覆盖财务、销售、法务这些方向。

装的时候分几步

两步，都很短。

第一步先转格式。仓库自带的 integrations 目录里已经有 claude-code，cursor，copilot 这几个，却没有 workbuddy 这一份，得自己生成：

.\scripts\convert.ps1 -Tool workbuddy

2.4 秒跑完，在 integrations 下生成 328 个子目录。

第二步才是安装：

.\scripts\install.ps1 -Tool workbuddy

2.2 秒装完。我的 skills 目录从 42 个涨到 370 个。

装进去的每个技能是什么样

每个技能只有一个 SKILL.md，没有其它文件。

开头是 YAML frontmatter，三个字段：

• name：比如 academic-anthropologist
• description：一句话说明这个角色擅长什么
• allowed-tools：Read Write Edit Bash Grep Glob

正文分成「身份与记忆」「核心使命」这样的小节，不是一段连续的提示词。以人类学家那个为例，里面写了它研究什么，用什么理论框架，以及什么情况会让它不适，还列了具体的交付要求。

328 个加起来一共 11 MB，平均每个 34 KB 左右。

能装进哪些工具

脚本里写死了 20 个工具，装到不同位置：

不传 -Tool 参数的话，脚本会自动检测本机装了哪些工具，全装一遍。这次我只测了 workbuddy 这一个分支，其它 19 个没测。

常见问题

为什么装完不能用

常见原因是策略没放开，脚本根本没跑完。先确认执行策略，再检查目标目录里有没有多出那 328 个文件夹。

装这么多会不会拖慢工具

328 个技能目录加起来 11 MB，体积不大。但工具启动时要不要扫描全部技能、会不会拖慢加载，这次没有测。

能只装某一个分类吗

脚本对 Hermes 有 -Category 参数可以按分类装，但 workbuddy 分支我看到的逻辑是整目录复制，没有按分类筛选的参数。

装完能直接对话激活吗

这次没测。我装完就清理了，没在对话里试过实际调用某一个角色，所以不能替你保证效果。

不用脚本能装吗

能。把角色 md 文件按目标工具的格式要求手动放进去就行，本质就是复制文件。

适合谁

如果你在用 Claude Code、Cursor 这类工具，想给它们一套现成的角色定义，这套东西省事。317 个角色覆盖工程和营销这些方向，不用自己从零写。

如果你只用一两个角色，没必要整包装。挑需要的几个 md 手动放进去就行，省得占目录。