技能名称: skill-dedup-scanner

详细描述:

技能去重扫描器 🔍

检测可能导致模型混淆的重复或相似技能。

使用场景

• - 发布新技能之前
• 技能触发异常时
• 审计现有技能集合
• 解决命名冲突
• 检查相似的技能名称/描述

使用方法

基础扫描

bash

自动检测语言

python3 scripts/main.py ~/.openclaw/workspace/skills/

指定语言

python3 scripts/main.py ~/.openclaw/workspace/skills/ --lang en python3 scripts/main.py ~/.openclaw/workspace/skills/ --lang zh

高级选项

bash

自定义阈值（0-1）

python3 scripts/main.py ~/.openclaw/workspace/skills/ --threshold 0.8

输出到文件

python3 scripts/main.py ~/.openclaw/workspace/skills/ -o audit_report.md

JSON 输出

python3 scripts/main.py ~/.openclaw/workspace/skills/ --json

详细模式

python3 scripts/main.py ~/.openclaw/workspace/skills/ -v

选项

选项	简写	描述	默认值
--lang	-l	语言：en, zh, auto	auto
--threshold

-t | 相似度阈值（0-1） | 0.7 | | --output | -o | 输出文件路径 | stdout | | --json | -j | 以 JSON 格式输出 | false | | --verbose | -v | 详细输出 | false |

输出

生成包含以下内容的详细报告：

• - 相似度评分（名称 + 描述）
• 冲突分析
• 可操作的建议
• 安全/唯一技能列表

相似度阈值

评分	级别	操作
> 0.85	🔴 高	考虑合并或重命名
0.7-0.85

🟡 中 | 明确描述 | | < 0.7 | ✅ 安全 | 无需操作 |

语言支持

• - 英语（--lang en）
• 中文（--lang zh）
• 自动检测（--lang auto）- 检测系统区域设置

示例

示例 1：快速扫描

bash
$ python3 scripts/main.py ~/.openclaw/workspace/skills/
🔍 扫描目录：/home/user/.openclaw/workspace/skills
📦 技能总数：15

✅ 未发现重复技能

所有技能均具有独特的名称和描述。无需优化。

示例 2：查找冲突

bash
$ python3 scripts/main.py ~/.openclaw/workspace/skills/ --threshold 0.6
🔍 扫描目录：/home/user/.openclaw/workspace/skills
📦 技能总数：15

⚠️ 发现 2 组相似技能

1. 🔴 高相似度警告

技能 A： tushare-finance
技能 B： stock-analyzer

相似度评分： 85%

分析：

• - 名称相似度：60%
• 描述相似度：85%

建议：

• - 在描述中明确区分
• 重命名以使目的更加明确

项目结构

skill-dedup-scanner/
├── scripts/
│ ├── main.py # 主入口
│ ├── skill_scanner.py # 技能扫描器
│ ├── similarity_checker.py # 相似度计算器
│ ├── report_generator.py # 报告生成器
│ └── locale_loader.py # 多语言支持
├── locales/
│ ├── en.json # 英文翻译
│ └── zh.json # 中文翻译
├── references/
│ └── best_practices.md # 技能命名最佳实践
└── output/ # 生成的报告

环境要求

• - Python 3.7+
• PyYAML（pip install pyyaml）

许可证

MIT