你的 Skills 库在悄悄腐烂！用这个工具每周”体检”一次，保持健康

最近被拉进一个 Agent 项目，维护了快 30 个 Skills。用了两个月，问题开始冒出来了：

「这个技能描述说能处理 X，但实际触发词根本不是这个」
「有两个 Skills 做的事情几乎一样，到底该用哪个？」
「上周新增的那个技能，现在想不起来了它是干啥的」

这些问题在 Skills 数量少的时候不明显，一旦上了规模，技能库就开始”腐烂”。skills-audit 就是来解决这个的。

它是什么

skills-audit 是 LobeHub 内置的一个技能维护工具，专门给 .agents/skills/ 目录做定期”体检”。每次运行完，你会得到一份清晰的审计报告，告诉你：

• 重复 / 重叠：描述高度相似、实际功能打架的 Skills
• 过时 / 孤立：引用了已删除 Skills 的交叉引用，描述和实际功能脱节的
• 合并 / 删除候选：哪些该保留、哪些该合并、哪些可以直接删掉

GitHub 仓库：https://github.com/lobehub/lobehub

核心工作流：三步走

第一步：清点资产
扫描 .agents/skills/ 下所有 SKILL.md，按领域（DB / UI / agent / testing / workflow 等）分组，统计总数和新添加的 Skills。配合 git log 还能看到这一周新增了哪些。

第二步：检测重复和重叠
对于同一领域内的 Skills 两两对比，判断标准很简单：
– 描述几乎一样 → 大概率是重复（一个是重命名残留）
– 同一任务触发多个描述 → 两者是互补还是竞争？确认边界
– 一个 Skill 写明「see also: foo」→ foo 还活着吗？引用还有效吗？

第三步：验证描述边界
检查每个 Skill 的描述是否说清楚了：做什么、不做什么、触发条件是什么。如果描述写得太宽泛（比如「处理一切和文件相关的事」），会导致 Agent 选错 Skill。

实际场景举例

你维护的 Skills 库里：
– file-manager 和 file-handler 描述几乎一样，实际功能完全重叠 → 建议合并
– db-schema-editor 的描述说「用于数据库迁移」，但实际触发词里没有任何迁移相关字眼 → 描述过时
– agent-runtime-hooks 引用了 agent-signal，但后者三个月前已经改名成 agent-eventbus → 孤立引用

这些问题人工扫要半小时，skills-audit 跑一遍，三分钟出报告。

安装方式

npx skills add lobehub/lobehub --skill skills-audit -g -y

推荐节奏：每周跑一次，或者每次新增 / 重命名多个 Skills 之后跑一次。

总结一下

Skills 库腐烂是个慢性病，等问题多了再清理代价更大。趁技能少的时候养成定期审计的习惯，长期收益很明显。

GitHub：https://github.com/lobehub/lobehub

GitHub: https://github.com/lobehub/lobehub