Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Gathering context before editing
• Understanding unfamiliar scene/project
• Auditing structure without changes
• 编辑前收集上下文、理解陌生场景或项目、在不改动的前提下审查结构

Unity Perception Skills

Use this module for read-only scene and project analysis.

Operating Mode

• Approval / Auto / Bypass: 本模块 18 个 skill 里有 17 个标 Mode = SkillMode.SemiAuto，三档模式下直接执行无需 grant。其中 16 个是纯读（ReadOnly = true）：scene_analyze / scene_summarize / scene_health_check / scene_component_stats / scene_find_hotspots / scene_tag_layer_stats / scene_performance_hints / scene_diff / hierarchy_describe / scene_context / scene_spatial_query / scene_materials / scene_contract_validate / project_stack_detect / script_analyze / script_dependency_graph。
• scene_dependency_analyze 是第 17 个 SemiAuto，但它不是纯读：传 savePath 会 Directory.CreateDirectory + File.WriteAllText + ImportAsset 落一个新工程资产，所以它标 MutatesAssets = true 而不再标 ReadOnly。仍然无需 grant，但它会进 router 的 diff 捕获，schema/flags 里也会带 mutatesAssets —— 不传 savePath 时才真的什么都不写。
• 特别说明：scene_export_report 写 markdown 文件到磁盘（Operation = Analyze | Execute，标 MutatesAssets = true），因此不是 SemiAuto——它走默认 SkillMode.FullAuto，Approval 模式下需要 grant 才能执行。
• 本模块不含 Delete / PlayMode / Reload / RiskLevel=high 类 skill —— 没有 IsForbiddenInSemi 拦截。