SuperAPI AI 工具集

skill-conflict-detector

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

用途:检测两类会让技能静默出问题的冲突。一是名称遮蔽:两个已安装技能的 name 字段相同,OpenClaw 按字典序加载最后一个,另一个静默消失且无警告。二是描述重叠:两个技能描述语义过于相似,导致 OpenClaw 无法可靠区分,错误的技能被触发。

主要能力:扫描全部已安装技能,报告冲突类型、严重程度、重叠分数与解决建议。冲突类型分为 NAME_SHADOW(CRITICAL,一个技能被完全隐藏)、EXACT_DUPLICATE(CRITICAL,描述完全相同)、HIGH_OVERLAP(HIGH,语义相似度大于 75%)、MEDIUM_OVERLAP(MEDIUM,50%–75% 相似)。相似度模型为描述字符串去停用词后的 token 重叠 Jaccard 相似度,快速且确定性,无外部依赖。默认阈值 HIGH ≥ 0.75,MEDIUM ≥ 0.50。

使用方式:命令包括 python3 detect.py --scan(完整扫描)、--scan --skill my-skill(单个技能对比其他全部)、--scan --threshold 0.6(自定义阈值)、--names(仅检查名称遮蔽)、--format json。建议先处理 CRITICAL:NAME_SHADOW 需重命名一个技能的 name 字段及其目录,然后用 bash scripts/validate-skills.sh 确认;EXACT_DUPLICATE 需删除或区分其中一个。HIGH_OVERLAP 需阅读双方描述,判断用户自然语言请求能否明确路由到其中一个,否则通过补充范围或时机加以区分。MEDIUM_OVERLAP 属信息性提示,若语境确实不同可共存,必要时在 SKILL.md 中说明原因。

适用场景:从 ClawHub 安装新技能后;技能触发不稳定或在意外提示上触发时;发布新技能前确认不会遮蔽已有技能;作为 install.sh 安装后验证的一部分。

限制:资料未提供该工具的安装方式、许可、价格与平台支持信息;相似度基于描述文本的词元重叠,非语义模型,阈值仅为默认建议。