【免费下载链接】asm
The universal skill manager for AI coding agents.
asm(agent-skill-manager)是面向 Claude Code、Codex、Cursor 等 20 多款 AI 编码 Agent 的通用技能管理器。用得多之后,技能库难免堆积出重复技能、"同干一份活"的语义重叠技能,白白挤占 Agent 的上下文空间。今天教你用asm audit一键完成技能库大扫除:扫描重复、揪出重叠、自动清理,几分钟给 AI Agent 技能库瘦身。
为什么技能库需要定期瘦身?
很多用户不知道:每个已安装技能的description都会常驻在 Agent 的系统提示里,无论这个技能是否真正被触发。技能越堆越多,后果有两个:
- 📈上下文成本悄悄上涨:几十个技能的描述叠加,每条消息都在"付费";
- 🧩重复与冗余:同一个技能被复制进
~/.claude/skills/、~/.codex/skills/等多个目录,或者从不同仓库装了功能几乎一样的技能,Agent 分不清该听谁的。
先看一个典型的"技能库脏乱差"现场——asm list一眼扫过去,code-review、docx、devops-pipeline出现了不止一次:
好消息是,asm audit就是为这种场景准备的"大扫除"命令,四条子命令各司其职:
| 子命令 | 作用 | 是否自动删除 |
|---|---|---|
asm audit(默认duplicates) | 找出同名/同内容的重复技能,可加-y一键清除 | ✅ 支持 |
asm audit overlap | 找出"不同名字、干同一份活"的语义重叠技能 | ❌ 只报告 |
asm audit security <目标> | 对已安装或远程技能做安全扫描 | ❌ 只报告 |
asm audit residency | 排名"占着常驻上下文却很少干活"的技能,给出降级建议 | ❌ 只报告 |
命令入口在 src/commands/audit.ts,重复检测算法在 src/auditor.ts。
三步完成技能库大扫除
第一步:一键安装 asm
npm install -g agent-skill-manager需要 Node.js 22+,安装后无需任何账号。
第二步:扫描重复技能(默认子命令)
asm audit它会扫描全局和项目两级范围(global+project)下所有 Provider 的技能,按三条规则分组:
- 目录名相同:
Code-Review、code_review、code review这类大小写/分隔符变体会被归为同一组; - frontmatter 名称相同:目录不同但
name:一样,也算重复; - 内容指纹相同:连名字都改了,但
SKILL.md正文逐字节一致,同样揪出来(指纹算法见 src/auditor.ts)。
报告会为每组标出[keep]保留项(优先全局作用域),其余为待清除副本;如果组内版本不一致还会标红提醒"可能是升级残留,不是简单重复"。
第三步:自动清除重复
看完报告满意了,加一个-y就能一键大扫除:
asm audit -y这里有个贴心的安全护栏:只有内容指纹与保留副本完全一致的副本才会被删除;内容已经分叉(diverged)的副本会被跳过并提示,除非你显式加上--force。也就是说,asm audit -y在绝大多数情况下是"零风险清理",详见实现 src/commands/audit.ts。
揪出"同干一份活"的技能:asm audit overlap
重复检测只抓"名字一样"的明面重复。更隐蔽的坑是:名字不同、描述大同小异,干的却是同一份活。比如从不同仓库装了code-review、code-review-excellence、receiving-code-review:
asm audit overlap它会对本地已安装技能做离线的语义相似度分析(无需联网、不调用任何模型服务):
- 对每个技能的名称和描述做分词,剔除"Use this skill to…"这类模板废话;
- 用 IDF 降权:几乎所有技能描述里都有的词(如
skill、agent)几乎不贡献分数,真正有区分度的词才决定得分; - 得分 ≥ 0.35 判为重叠,≥ 0.55 标红为高置信度冗余(likely redundant),并列出共享的关键词供你判断。
实现细节在 src/installed-overlap.ts,算法文档可参考 docs/semantic-overlap.md。该子命令只报告、绝不删除——保留哪个、合并哪个,最终由你拍板。想接脚本处理可加--json:
asm audit overlap --json顺手给技能库做个安全体检
瘦身之余,建议顺手扫一眼技能安全。对单个已安装技能:
asm audit security code-review也可以在安装远程技能之前先审计(先克隆到临时目录扫描,不落地安装):
asm audit security github:owner/repo报告会标注网络访问、凭据暴露、shell 执行等风险项,并给出safe / caution / warning / dangerous四级判定。全量体检一条命令:
asm audit security --all找出"占着 Context 不干活"的技能
最后一步瘦身:有些技能没重复、也不重叠,但常年不触发,description 却一直在常驻上下文中"挂名收费"。
asm audit residency它会排名这些"不挣回自己上下文开销"的技能,并为每个候选附上真正可用的降级命令:
| 层级 | 对应命令 | 常驻成本 |
|---|---|---|
| 已安装(自动触发) | — | 每条消息都在付费 |
| 存入本地库 | asm deactivate | 激活前为零 |
| 禁用(保留在磁盘) | asm disable(可用asm enable恢复) | 零 |
| 临时引用 | asm get <skill>读取正文,不安装 | 零 |
注意它完全只读:不删除、不禁用任何东西,降级动作由你手动执行——这正是 src/commands/audit.ts 中刻意的设计。
小结:一条命令线,还技能库一个清爽状态
给 AI Agent 技能库瘦身的完整流程,其实就是四条命令:
npm install -g agent-skill-manager # 1. 安装 asm audit -y # 2. 一键清除重复技能 asm audit overlap # 3. 揪出语义重叠,人工裁决 asm audit residency # 4. 找出占 Context 不干活的可降级技能建议把asm audit放进每两周一次的例行维护里:重复用-y自动清理,重叠和安全靠报告辅助决策。技能库越清爽,Agent 的上下文预算就越能打在高价值技能上。更多命令参考 README.md,架构说明见 docs/ARCHITECTURE.md。
【免费下载链接】asm
The universal skill manager for AI coding agents.
相关推荐
安装前先扫一遍:asm audit security如何守住AI Agent技能的供应链安全防线
安装前先扫一遍:asm audit security如何守住AI Agent技能的供应链安全防线 asm(agent skill manager)是面向 AI
gbrain Soul Audit 技能实战:以单一答案库重跑 Agent 身份访谈与渲染管线
gbrain Soul Audit 技能实战:以单一答案库重跑 Agent 身份访谈与渲染管线 Soul Audit( plugin/skills/soul a
人工智能RAGAI 应用Agent 记忆知识库MCP 服务skills之audit技能:一键生成AGENTS.md,给AI编码Agent装上项目上下文记忆
skills之audit技能:一键生成AGENTS.md,给AI编码Agent装上项目上下文记忆 skills 是一套面向 AI 编码 Agent 的工程工作流
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考