Unity-Skills: Command for Claude Code

Skill Check — C# 代码与 SKILL.md 一致性审计 + 技能数量同步

你是 UnitySkills 项目的一致性审计助手。扫描所有 [UnitySkill] C# 定义与 skills/*/*.md + skills/*/reference/*.md 文档（模块入口 SKILL.md + 同目录兄弟文件 + reference/ 子目录一层），报告不一致问题；同时统计实际技能数量，与文档中声称的数字对比并修正（原 /skillcount 已并入本命令）。

目标

检测以下问题（这些是 v1.6.8 修复的那类 bug 的根源——文档声称支持的参数在代码中不存在）：

1. 幽灵 Skill：SKILL.md 中记录了但 C# 代码中不存在的 Skill
2. 完全无文档的 Skill：C# 中存在 [UnitySkill] 但在整个 skills/ 文档树中完全无提及的 Skill（注意：本项目为 schema-first 设计——skill 无需逐个写 ### skill_name 定义，故"无 ### 定义"本身不算缺陷，详见步骤 3a）
3. 参数不一致：SKILL.md 文档的参数表与 C# 方法签名不匹配（多余参数、缺失参数、类型不匹配）
4. 元数据缺失：[UnitySkill] 特性中缺少 Category、Operation、Tags、Outputs 等关键元数据
5. 数量失同步：文档（AGENTS.md / README / README_CN / SKILL.md）中声称的技能总数与模块计数表和实际代码不一致

步骤 1：收集 C# Skill 定义

扫描 SkillsForUnity/Editor/Skills/*Skills.cs 中所有 [UnitySkill(...)] 标记的方法：

1. 对每个 Skill 提取：

   • Skill 名称（[UnitySkill("skill_name", ...)] 第一个参数）
   • Description 字符串（[UnitySkill("name", "description string")] 第二个参数，完整保留）
   • 方法签名（参数名、类型、是否可选、默认值）
   • 元数据：Category、Operation、Tags、Outputs、RequiresInput、ReadOnly
   • 所在文件和行号
   • 条件编译宏：检查 Skill 方法是否位于 #if XXX 块内（如 PROBUILDER、XRI、UNITY_NETCODE、CINEMACHINE_2、CINEMACHINE_3 等），记录对应的宏名称；不在任何 #if 块内的标记为"无条件"
   • 返回值字段：解析方法体中 return new { ... } 匿名对象的字段名列表（正则提取即可，不需要完美覆盖所有分支）

2. 解析纪律（历史假绿源头，必须遵守）：

   • 括号配平切分 attribute 块：一个 skill 的元数据只能取它自己 [UnitySkill(...)] 块内的标注，严禁把同文件相邻块的元数据算到本 skill 头上
   • 先剥 // 注释再按逗号切分：带说明注释的 flag 否则会静默读成 false，审计报"零违规"是假绿
   • 按技能名去重：#if/#else 分支下的同名 stub（URP 缺包时 Decal/PostProcess/URP/Volume 四个文件以相同技能名注册 NoURP() 占位实现）会让裸 rg -c "\[UnitySkill\(" 多算 33 个 attribute（如 818 attribute → 785 唯一技能）。一切后续比对和计数都以"按第一个字符串参数去重后的唯一技能名"为准
   • SkillRouter.cs 等非 *Skills.cs 文件中出现的 [UnitySkill( 多为注释/文档文字，不计入

3. Batch Skill 额外处理：对 *_batch 后缀的 Skill，其方法签名通常只有 string items，真正的参数定义在同文件的 BatchXxxItem 内部类中。额外提取该类的所有 public 属性（属性名、类型、默认值），作为 batch skill 的"实际参数列表"。