用途：把 Ludeo SDK 集成进 Unity（C#）游戏，使用官方 Ludeo Unity 插件与托管 LudeoSDK API，覆盖从包安装到动作映射、对象跟踪、状态恢复和运行时验证的全流程。仅适用于 Unity 项目；C++/自研引擎应改用 ludeo-unreal-integration。若项目无 Assets/、ProjectSettings/、Packages/manifest.json 或 .asmdef/.unity 文件，应停止并转向对应引擎的技能。
主要能力：按 8 个阶段顺序推进——1 安装插件（从 github.com/ludeo-labs/unity-plugin-releases 下载最新版）安装 UPM 包并设置脚本定义与 LudeoSettings、基线及启用 SDK 的编译、执行 KYG（了解游戏）；2 生成项目 CODE_MAP；3 编排式 SDK 生命周期（含 TDD、LudeoController 层与通知注册，编译为人类把关）；4 可跟踪对象普查与波次计划；5 编排式跟踪与恢复波次循环（深挖、捕获、恢复计划、重建、恢复流程）；6 动作映射与实现；7 校验并用 ludeo CLI 上传构建并轮询状态；8 打磨与完成（可回到 4、5 添加新波次）。
使用方式：技能版本 2.0.0，绑定插件 v4.3.0 API。更新可运行 npx skills update ludeo-labs/integration-skills/skills/ludeo-unity，然后开启新的 agent 会话（SKILL.md 按会话缓存）。v4.3.0 为破坏性重写：初始化改为 Initialize()+SessionManager.CreateSession，通知改为 C# 事件，捕获改为 LudeoRoom.Writer 与作用域内 WriteData，游戏会话改为 LudeoPlayer，旧 API（InitLudeoSession、LudeoStateObject/SetAttribute、AddNotify*、LudeoGameplaySession）不再适用。
关键限制：一次只推进一个阶段并需用户确认；每个写代码阶段末尾必须重新编译并运行验证。Unity 在聚焦时重新编译，故编译是每阶段的要求。对象默认按离散类型属性（WriteData）跟踪，仅在明确要求或对象确实不透明时用 blob/byte[]。写读均有作用域，需使用 using EnterObjectScope()。SDK 自身 tick，由插件的 LudeoUnityManager 驱动，不要接入 Update。禁用 Ludeo 主要是运行时行为，通过接口回退到 Dummy*/Disabled* 实现，脚本定义可选。不得在未查文档时断言 SDK 行为；缺失信息暂未提供。