前言

当你开始同时使用多个 AI Agent 客户端时，一个新的问题会很快出现：技能到底应该放在哪里？

Gemini 有自己的技能目录，Codex 有自己的技能目录，Antigravity 有自己的目录，Claude 也可能有一套。一个技能想多端复用，就要到处复制；一个技能想更新，就要担心漏同步；一个技能想删除，又怕删错系统目录。

Skill-Manage 就是为了解决这个问题发布的工具。

项目地址：darer5/skill-manage

项目简介

Skill-Manage 是一个多 Agent 技能同步与隔离管理器。

它的目标不是创造新的 skill 格式，而是管理已有 skill 在不同 Agent 客户端之间的分发、同步、审计和删除。

当前版本是 v2.3.0，核心特点包括：

  1. 多 Agent 技能目录自动发现。
  2. 双通道物理隔离同步。
  3. 技能同步率看板。
  4. 级联删除。
  5. 系统级安全拦截。
  6. 零 NPM 依赖。

为什么需要这个工具

如果只使用一个 Agent 客户端，技能管理并不复杂。

但当你同时使用多个 Agent，问题就会变成：

  1. 同一个 skill 多处复制，版本不一致。
  2. 插件内置 skill 和用户自定义 skill 混在一起，容易重复加载。
  3. 删除一个 skill 时，不知道哪些目录还有残留。
  4. 系统隐藏目录可能被误操作。
  5. 手动维护成本越来越高。

Skill-Manage 的出发点是：多 Agent 时代，需要一个元技能管理器。

核心设计：双通道物理隔离同步

Skill-Manage 最重要的设计是“双通道物理隔离”。

它把技能目录分为两类：

Skill-Manage 双通道物理隔离同步架构图

通道 管理对象 同步原则
插件共享通道 插件内部自带的技能 只在插件共享组内同步
全局自定义通道 用户自己安装或创建的技能 只在全局自定义目录间同步

这样做的好处是很直接的：插件技能不会被复制到全局目录，自定义技能也不会被错误塞进插件目录。

从物理目录层面隔离之后，就能避免多路径扫描带来的重复加载问题。

主要功能

1. list：查看技能同步状态

1
node skill-manage.js list

这个命令会按通道列出当前所有技能，并显示每个技能在对应目录组里的同步率。

比如某个技能在 3 个目标目录中已经同步到 3 个，就可以显示为 [3/3]。

这比手动打开多个目录检查要直观得多。

2. sync：同步指定技能

1
node skill-manage.js sync a11y-debugging

sync 会识别这个技能属于哪个通道，然后只在对应通道内补齐同步。

这避免了“为了同步一个技能，把它复制到所有可能目录”的粗暴做法。

3. remove：级联删除技能

1
node skill-manage.js remove my-old-tool

当一个技能不再需要时，可以通过 remove 在所有活跃目录中清理它。

这对经常试验不同 skill 的用户很有用，可以避免旧技能长期残留。

4. sync-all：全量同步

1
node skill-manage.js sync-all

这个命令适合在新增、迁移或整理技能目录后使用。它会自动分类并补齐未完全同步的技能。

5. audit：全局审计

1
node skill-manage.js audit

audit 会对技能元数据和触发定义进行检查，并导出 Markdown 报告。

当 skill 数量变多以后，审计能力会变得很重要。否则你很难知道哪些技能描述重复、触发词冲突、元数据缺失。

安全机制

Skill-Manage 内置了几类安全保护。

第一，隐藏目录保护。

凡是以 . 开头的系统敏感目录，比如 .system、.agents，都会被写入和删除操作拦截。

第二，管理器自我保护。

不能通过 remove skill-manage 把管理器自身级联删除。

第三，权限降级。

当某些目录没有写权限时，工具会尽量退化为扫描和展示，而不是直接崩溃。

这些设计说明它不是一个简单复制脚本，而是考虑了真实使用中的误操作风险。

安装与运行要求

Skill-Manage 使用原生 Node.js 编写，不需要额外安装 NPM 依赖。

基础要求：

  1. Node.js 14 或以上。
  2. 推荐 macOS 或 Linux 环境。
  3. 已经有 Gemini、Codex、Antigravity、Claude 等 Agent 技能目录。

运行方式：

1
node skill-manage.js <command> [skill-name]

适合谁

Skill-Manage 适合这些用户：

  1. 同时使用多个 AI Agent 客户端的人。
  2. 经常安装、修改、删除 skill 的人。
  3. 想把自定义技能在多端复用的人。
  4. 想避免技能重复加载和目录污染的人。

如果你只使用一个 Agent，暂时可能用不到它。但只要你的技能体系开始跨工具、跨目录、跨客户端，手动管理就会很快失控。

小结

Skill-Manage 是一个典型的基础设施型工具。

它不直接帮你写内容，也不直接帮你完成业务任务，但它解决了多 Agent 工作流里一个很底层、很实际的问题：技能如何安全、清晰、可控地同步。

随着 AI Agent 工具体系越来越复杂，skill 不再只是几个 Markdown 文件，而会逐渐变成个人工作流的一部分。这个时候，一个可靠的技能管理器就很有必要。