Claude技能健康体检
扫描 Claude 本地技能与插件目录,检测格式错误、失效软链接与重复定义,生成分级的健康状态清单与修复建议。
功能与用途
该功能专为 Claude Code 用户设计,用于一键排查本地安装的 Skills、Agents 和 Plugins 的运行状态。通过扫描用户目录、项目级配置以及插件源,系统能够自动发现断开的软链接、缺失的前置元数据、过短或无效的描述,以及相似度过高的重复技能(特别是用户自定义技能与插件自带技能冲突),并最终输出带有严重级别标注与针对性解决指令的健康报告。
适用场景
- 技能库全量健康检查:一键扫描用户目录、项目级与插件下的技能,检测格式缺陷、失效软链接与缺失元数据并生成报告。
- 同名与高相似技能查重:比对不同作用域的技能名称与描述相似度,精准识别用户自定义技能与官方插件之间的重复冲突。
- 已安装技能清单轻量盘点:以简报模式快速列出当前环境加载的全部Skills、Agents与Plugins,展示归属作用域与更新状态。
适用人群
- Claude Code 重度使用者
- 本地安装了大量自定义技能与插件的开发者
- AI Agent 工作流维护人员
使用步骤
- 执行 /janitor-report 命令启动全量体检,或添加 --brief 参数仅获取库存统计
- 系统调用 scan.sh、lint.sh 和 detect_dupes.sh 进行元数据扫描、质量检查与相似度计算
- 查看合并后的健康状态表格,识别 CRITICAL、WARNING 与 DUPLICATE 等状态标识
- 根据报告中推荐的指令(如 /janitor-fix 或 /plugin update)执行修复或卸载冲突项
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-24
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
依赖与权限
- 读取用户主动提供的内容