用途与模式:janitor-discover 是 skills-janitor 插件的统一入口,按参数形态自动分派模式。关键词(如 seo、n8n workflows)进入发现模式,用 search.sh 在 GitHub 搜索匹配技能;--compare <skill-name> 进入比较模式,查找本地技能的可替代方案;完整 URL(https://github.com/user/skill)、短仓库名(user/skill)或本地路径(~/path/to/skill)进入安装前检查模式,用 precheck.sh 分析。发现结果先按相关性过滤(仓库名、描述、话题中需含技能信号)再按相关性排序,星级次之。
主要能力:安装前模式执行两项检查——与已安装技能的重叠分析(按描述比较,分 HIGH≥60%、MODERATE 30–59%、LOW<30%),以及自 v1.6 起的候选技能安全扫描(security.sh,与 /janitor-security 相同的启发式)。输出含重叠分桶、共享关键词、最终判定(HIGH_OVERLAP / MODERATE_OVERLAP / SAFE)与安全块;--json 时数据归入 security 键(verdict、scope、findings)。
用法与依赖:需安装 Claude Code 与 skills-janitor 插件(提供 discover.sh、search.sh、precheck.sh、compare.sh),bash 3.2+ 与 curl,能访问 api.github.com(匿名可用,设 GITHUB_TOKEN 提升限流与代码搜索)。示例:discover.sh seo;discover.sh n8n --limit 20;discover.sh --compare marketing-seo-audit;discover.sh https://github.com/user/my-skill;discover.sh user/my-skill。
适用场景:按主题寻找技能、在安装前评估某仓库或本地目录、查找已有技能的替代品。
限制:安全扫描范围随来源不同——本地路径扫描整个目录(含捆绑脚本),URL 或 user/repo 仅抓取 SKILL.md,不下载脚本,因此远端 PASS 只代表可见文本无明显可疑,不代表仓库安全,若候选含脚本需克隆后重扫。重叠与安全判定为启发式,不等同恶意软件结论。已知错误:GitHub API 限流可设 GITHUB_TOKEN;SKILL.md 非标准路径无法抓取可传直链或本地克隆路径;有效主题无结果因相关性过滤,可放宽关键词,结果缓存 24 小时于 data/search-cache.json;安全扫描不可用(UNKNOWN)时重叠结果仍有效但不得宣称已做安全检查。