NLDClient-yudde/.cursor/rules/cursor-extras.mdc

45 lines
2.1 KiB
Plaintext
Raw Normal View History

---
2026-05-08 13:25:20 +08:00
description: Cursor 专属补充规则 — 核心行为约束、UI Prefab 工作流和 MCP 集成。通用规则见 AGENTS.mdCursor 会自动读取)。
alwaysApply: true
---
# Cursor 专属规则
> 通用编码规范、git 操作规则、项目结构等已在 `AGENTS.md` 中定义Cursor 会自动读取。
2026-05-08 13:25:20 +08:00
> 本文件包含 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 贴图、图标、背景图等)时,可自主决定是否查看图片内容以获取尺寸、颜色、布局等信息