用途:对本地所有技能做整体健康检查,把清单、质量、重复和损坏项合并为一份报告。适用于排查错误、寻找重复、发现失效技能。
覆盖范围:user、project、codex、plugin、source 各作用域的技能;插件技能以完整调用名出现;扫描 JSON 还含 agents 数组与逐插件 update_available。
模式:/janitor-report(默认,完整检查:清单+lint+重复+损坏);/janitor-report --brief(仅清单,替代旧 /janitor-audit)。
前置条件:已安装 skills-janitor 插件的 Claude Code(提供 scripts/scan.sh、lint.sh、detect_dupes.sh);bash 3.2+;对 ~/.claude/skills、~/.claude/agents 及插件元数据有读权限;无需认证或 API key,脚本只读本地文件。
用法:完整报告依次执行 bash ~/.claude/skills/skills-janitor/scripts/scan.sh bash ~/.claude/skills/skills-janitor/scripts/lint.sh bash ~/.claude/skills/skills-janitor/scripts/detect_dupes.sh 简报模式只执行 scan.sh。
各脚本:scan.sh 覆盖各作用域技能、符号链接状态、frontmatter 字段、行数,以及 agents、plugins(含 update_available)和 broken_symlinks 计数。lint.sh 分级:Critical 为损坏符号链接、缺 SKILL.md、缺 frontmatter;Warning 为 name/description 缺失或为空、描述过短或过长、缺 version;Info 为无正文、无 Gotchas 段、文件过大。detect_dupes.sh 检测重名(同名不同路径)和描述重叠(Jaccard 相似度 >30%),并显式列出跨作用域的用户对插件对。
输出:合并为带严重级别的表格,并按问题类型给建议动作:损坏符号链接→/janitor-fix --prune;质量问题→/janitor-fix;用户与插件重复→卸载用户侧副本或反之;插件过期(update_available: true)→/plugin update <name>;token 浪费→/janitor-value;可疑内容→/janitor-security;未使用 MCP 服务器(运行 scripts/mcp.sh 获取清单)→删除配置项或 /janitor-swipe。
错误处理:脚本路径不存在时用 ls ~/.claude/skills 定位实际位置;扫描输出非 JSON 时保留 stderr 重跑并报告出错行;plugins 数组为空时检查 ~/.claude/plugins/installed_plugins.json。
限制:依赖本地文件与插件安装;需读权限;不涉及远程认证。价格为暂未提供。