SuperAPI AI 工具集

find-orphaned-meta

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

用途:检测 Unity 项目中孤立(orphaned)的 .meta 文件,即对应文件或文件夹已不存在、但 .meta 仍留在仓库中的情况。Unity 会为每个资源生成 .meta 文件,资源被删除而 .meta 残留时会触发警告并污染仓库。

适用场景:文件或文件夹删除后查找遗留的 .meta;诊断“存在 .meta 元数据文件,但找不到其文件夹/资源”这类 Unity 警告;在 git 操作(切换分支、合并、变基)后清理可能产生的孤立 .meta。

使用方式:

  1. 运行检测脚本 .claude/skills/find-orphaned-meta/scripts/find-orphaned-meta.sh,默认扫描 Assets/ 与 Packages/,也可传入目录参数扫描指定路径。输出为每行一个孤立 .meta 路径,无输出表示未发现。
  2. 报告结果:未发现时报告“No orphaned .meta files found.”;发现时列出并询问用户是否删除。
  3. 经用户确认后删除:rm -- "<orphaned-meta-path>",随后运行 uloop compile 验证 Unity 不再报告缺失资源相关警告。

限制:资料未提供脚本实现细节、支持的参数全集、平台要求、错误处理方式及性能说明,均暂未提供。