技能介绍

要解决什么问题

技能库一多，「该用哪个」和「要不要新写一个」会变成重复劳动：名字相近、描述重叠，靠肉眼翻目录很难区分「直接命中」和「只是关键词像」。本技能面向已有 skills/ 目录的场景，把意图理解、相似检索、聚类视图和建 skill 前的查重放在同一套工作流里。

如何工作

默认流程会先对齐你的目标：是精确功能、相邻用例、重复检查，还是只要一份排序后的推荐。接着扫描指定目录下的 skill，按 name、description、keywords 与领域词做匹配；必要时把高度相似的条目聚类，避免列表里全是近义重复。

Bundled 脚本按触发语分工：

scripts/recommend_skills.js：用户问「找同类 skill」「哪个更适合」时，在当前工作区用相对路径指向 skills_dir 做 ranked 推荐。
scripts/cluster_skills.js：需要分组视图、看重叠类别或疑似重复时使用。
scripts/check_skill_dedup.js：准备新建 skill 前查是否已有覆盖、是否应复用或合并扩展。

输出默认包含：目标功能理解、推荐 skill、推荐理由、相近但次优、可合并/避免重复、下一步建议。排序规则强调具体任务贴合度高于纯关键词重叠，并区分 direct match 与 adjacent match；重叠严重时会在文案里点明，置信度低时会保留歧义。

边界与注意

skills_dir 必须是当前工作区内的相对路径；脚本从含 skills/ 的 workspace 运行。
推荐质量依赖各 skill 的 name/description 是否写清楚；目录结构或元数据缺失时，结果可能偏「相邻匹配」。
细粒度排序与查重模式可对照 references/recommendation-rules.md、references/output-schema.md、references/dedup-mode.md。

截图预览

使用场景

团队仓库里已有几十个 skill，用户说「找同类 skill」或「这几个哪个更适合某条工作流」，需要在当前 workspace 的 `skills/` 目录里扫一遍并给出排序理由。
准备新增一个 skill 前，想确认目录里是否已有功能重叠项，并判断该复用、扩展合并还是仍要新建。
技能目录里名称和描述相近的条目太多，需要按相似度聚类成组，看清重复类别与边界重叠。
Agent 接到模糊需求时，要先区分「精确功能命中」与「仅关键词相近的相邻 skill」，再输出推荐、次优备选和下一步建议。