用途：cursor-rules 说明如何把上下文写入项目，使每次 Agent 运行都从正确指令开始。SDK 通过 local.settingSources 读取这些规则。
主要能力：支持仓库级编码约定、按目录嵌套的 AGENTS.md 上下文、从 .cursorrules 迁移到 .cursor/rules/*.mdc，以及在 always-on、auto-attached、agent-requested、manual 四种规则类型间选择。
文件位置与优先级：涉及 .cursor/rules/、AGENTS.md 和旧版 .cursorrules，并区分团队、项目、用户的层级与优先级。
编写 .mdc 规则：frontmatter 包含 description、globs、alwaysApply；规则类型分 Always、Auto-attached、Agent-requested、Manual；glob 模式支持 **/*.tsx 及逗号分隔列表。
AGENTS.md：仅用 Markdown，可按目录嵌套，并说明何时选 AGENTS.md、何时选 rules。
SDK 集成：settingSources 决定加载哪些规则及加载位置。
限制：Tab 和 Inline Edit 不读取规则。相关功能可参考同属 .cursor/ 的 Hooks 与 Skills。