Skill文件修复与失效清理
扫描本地技能目录中的元数据缺陷与损坏软链接,以预演模式展示变更并在确认后自动补全缺失字段与清除无效目录。
功能与用途
专为 Claude Code 和 Agent 技能生态打造的文件维护功能。它能够自动检测用户与项目级技能库中的 frontmatter 格式问题(如缺少分隔符、缺失版本号或描述为空),通过标准模板进行安全补齐;在开启清理模式时,可精准识别并删除指向已失效源路径的软链接、空文件夹及孤立副本。默认采用演练模式防止误改,并提供全量变更日志保障回溯安全。
适用场景
- 技能元数据缺陷修复:自动修复SKILL.md中缺失的分隔符,按标准规范补齐空白描述与默认版本号等必要前置信息。
- 无效软链接与空目录清理:安全清理指向已删除源路径的损坏软链接、无描述文件的空文件夹及本地冗余副本,保持环境整洁。
- 变更安全预演与回溯:在正式修改前以演练模式输出预估变更项,经人工核准后执行并在日志中完整记录操作时间线。
适用人群
- Claude Code 深度用户
- AI Agent 技能开发者
- 本地技能库管理者
使用步骤
- 运行 /janitor-fix(或加 --prune)执行安全预览,查看待修复或待清理的文件清单。
- 仔细确认演练模式下打印的 [DRY RUN] 条目与影响范围。
- 确认无误后追加 --apply 参数执行实际修复或清理操作。
- 若需回滚或核对,查阅插件目录下 data/changelog.log 中的操作记录。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-24
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
依赖与权限
- 读取用户主动提供的内容