---
inclusion: always
---

# Kiro 专属补充规则

> 通用编码规范、git 操作规则、项目结构等已在 `AGENTS.md` 中定义，Kiro 会自动读取。
> 行为协议的权威定义在 `.ai/protocols/` 目录。
> 本文件仅包含 Kiro 独有的补充说明，不重复 `AGENTS.md` 中已有的内容。

## 技能引用
- 技能定义位于 `.ai/skills/`（同步副本在 `.kiro/skills/`）
- 执行 git 操作前必须读取 `batch-git-ops` 技能的 SKILL.md

## Kiro 专属：Error Handling
- Implement error handling using try-catch blocks where appropriate, especially for file I/O and network operations
- Use DebugUtil class for logging and debugging
- Utilize Unity's profiler and frame debugger to identify and resolve performance issues

## Kiro 专属：UI Prefab 信息获取

当需要了解 UI Prefab 的结构和组件信息时，按以下步骤操作：

1. 通过 Unity MCP 调用 `extract_ui_prefab` 工具：
   ```
   execute_custom_tool: { tool_name: "extract_ui_prefab", parameters: { prefab_path: "Assets/xxx/xxx.prefab" } }
   ```
2. 读取返回的 `json_path` 对应的 JSON 文件
3. 参考 `ExtractedPrefabs/README.md` 理解 JSON 格式含义
4. 基于 JSON 内容分析 UI 层级结构、组件类型和属性

**重要**：每次都需要先调用工具生成 JSON（避免读取旧数据）

## Kiro 专属：编译约定
- 修改 GamePlay 中的 `.cs` 代码后，需通过 Unity 菜单 `Tools/文件与路径/转换为Dll`（快捷键 F1）编译生成 DLL
- 编译前须确保 NLDClient 和 GamePlay 仓库都已更新到最新