---
description: Cursor 专属补充规则 — 核心行为约束、UI Prefab 工作流和 MCP 集成。通用规则见 AGENTS.md（Cursor 会自动读取）。
alwaysApply: true
---

# Cursor 专属规则

> 通用编码规范、git 操作规则、项目结构等已在 `AGENTS.md` 中定义，Cursor 会自动读取。
> 本文件包含 Cursor 独有的工作流和核心行为约束的嵌入摘要。

## 核心行为约束（嵌入自 .ai/protocols/）

以下规则摘自 `.ai/protocols/`，嵌入此处确保 Cursor 能直接加载：

- **确认再行动**：除非用户要求特别清晰，开始编码前将计划描述给用户并获得确认（收集信息和编写计划不需要）
- **Unity 约定**：不要生成 .meta 文件；不要主动编译项目；可以做静态代码检查
- **Git 安全**：除非用户要求，不做任何 git 操作；git 操作有风险，须提醒用户；本项目有三个关联仓库（NLDClient / NLDMisc / GamePlay），任何 git 操作须读取 `batch-git-ops` 技能后执行

## 技能引用
- 技能源位于 `.ai/skills/`（同步副本在 `.cursor/skills/`）
- 协议源位于 `.ai/protocols/`（同步副本在 `.cursor/protocols/`）
- 新增或更新后运行 `.ai/sync-all.sh` 同步到各平台

## 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（避免读取旧数据）

**适用场景**：
- 需要理解某个 UI 界面的布局结构
- 需要了解 UI 组件的具体属性配置
- 需要分析或修改 UI Prefab 相关代码

## 图片资源查看
- 当任务涉及图片资源（UI 贴图、图标、背景图等）时，可自主决定是否查看图片内容以获取尺寸、颜色、布局等信息