Agent Skills
返回列表
💻

Unity AI 导航初始化

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/unity-technologies-skills-initialize-ai-navigation。

技能介绍

要解决什么问题

在 Unity 里做角色寻路,常见卡点不是「会不会调 NavMeshAgent.SetDestination」,而是:包没装对、场景里已有哪些导航组件不清楚、用户说一句「加个导航」其实涵盖从烘焙到脚本的一整串差异场景。此外,若通过 Editor 的 eval 跑 C#,还把带 using UnityEngine; 的整文件贴进去,会直接踩 CS0210 / CS0246——因为 eval 编译的是语句块,不是完整源文件。

技能如何工作

技能会先对照用户话术做 路由解释(例如「set up nav」→ 完整流程:NavMeshSurface + bake + NavMeshAgent;「agent won't move」→ 走排障决策树),再按固定工作流推进:

  1. 包安装检查:确认 com.unity.ai.navigation 已在 Packages/manifest.json;版本须从 Unity Registry 读取,避免静默解析失败。
  2. 现状盘点:检索场景/预制体中的 NavMeshSurface、NavMeshAgent、NavMeshObstacle、NavMeshLink、NavMeshModifier,并对照 Window > AI > Navigation > Agents 的 Agent 类型。
  3. 信息补齐: walkable 表面、Agent 尺寸/行为、障碍、Link、区域代价等未说明项会主动追问。
  4. 按序落地:Surface 烘焙 → Agent → Obstacle → Link → Modifier/Volume → 移动/巡逻/点击移动/动画耦合等脚本。
  5. 验收与汇总:蓝层 NavMesh、Agent 与 Surface 类型一致、路径可达、障碍雕刻、Link 两端连通、区域掩码合理;Rigidbody 与 Agent 并存时 Is Kinematic 等细节一并核对。

组件细节、API 与配方见 navigation-system.md。

适用边界与注意点

  • 不负责编造 Unity 包版本号;无 live Editor 时需靠场景/预制体文本搜索替代运行时查询。
  • 交给 eval 的代码片段须 全限定类型名,不要 using 指令。
  • 混合组件、复杂区域代价与 Rigidbody 组合等边缘情况,以参考文档中的 Mixing Components / Troubleshooting 决策树为准,而非一次性通用模板。

使用场景

  • 新项目导入 `com.unity.ai.navigation` 后,要在首个关卡里烘焙可走区域并给主角挂上 NavMeshAgent
  • 角色能寻路但点击地面不移动,需要补射线检测脚本并核对 Agent 的 Area Mask
  • 两个平台之间缺连接,要用 NavMeshLink 搭桥并确认两端 Activated 与双向设置
  • 动态门或可推箱子挡路,需要 NavMeshObstacle 开启 carving 并验证烘焙后路径更新

适合人员

  • Unity gameplay 程序员:首版关卡要一次性把 Surface 烘焙、Agent 参数和移动脚本对齐
  • 技术策划兼 Editor 工具作者:需要用 eval 改导航组件但反复撞上 using/类型全限定编译错误
  • 关卡 TA:多 Agent 体型与 Navigation 窗口里 Agent 类型、区域代价要统一配置
  • 接手的维护工程师:线上反馈「agent won't move」要按组件清单和排障树系统排查