unity-navmesh

1> **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.
2 
3## Triggers
4- Setting up navigation
5- Baking a NavMesh
6- Testing agent paths
7- Tuning bake parameters
8- 搭建导航、烘焙 NavMesh、测试 Agent 路径、调整烘焙参数
9 
10# NavMesh Skills
11 
12Bake / clear NavMesh data, calculate paths, sample positions, and configure NavMeshAgent / NavMeshObstacle components.
13 
14## Operating Mode
15 
16- **Approval**：查询类 skill（`navmesh_calculate_path` / `navmesh_sample_position` / `navmesh_get_settings`，源码标 `SkillMode.SemiAuto`）直接执行；变更类（`navmesh_bake` / `navmesh_add_agent` / `navmesh_set_agent` / `navmesh_add_obstacle` / `navmesh_set_obstacle` / `navmesh_set_area_cost`，标 `SkillMode.FullAuto`）需用户 grant，grant 后服务端一步执行返结果。
17- **Auto / Bypass**：所有未被禁列表拦截的 skill 直接执行。
18- 本模块**含 Delete 类 skill**：`navmesh_clear` 标记为 `SkillOperation.Delete`，会被 `IsForbiddenInSemi` 静态拦截 —— 仅 **Bypass** 模式或将其加入 **Allowlist** 才能调用。
19- `navmesh_bake` 同步阻塞主线程；大场景可能很慢，调用前提醒用户。
20 
21**DO NOT** (common hallucinations):
22- `navmesh_create` does not exist → use `navmesh_bake` to generate NavMesh
23…