问题根源在于AI缺乏对项目专属约束的明确感知；可通过五种方法实现规范对齐：一、配置.project/rules文件强制约束；二、用/generate rules动态生成规则初稿；三、在Prompt中嵌入Mini-Spec式技术约束；四、启用YOLO模式并绑定规则校验流程；五、通过@符号注入上下文并施加规则锚定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Cursor AI 生成代码时发现输出风格与公司编码规范不一致，例如命名不符合 lowerCamelCase、缺少必要注释、模块路径错误或引入了禁用库，则问题根源在于 AI 缺乏对项目专属约束的明确感知。以下是实现规范对齐的多种可行方法：
一、配置项目级 .cursor/rules 文件
该方式通过静态规则文件向 Cursor 注入强制性约束，AI 在每次生成前自动读取并执行，是保障长期一致性最稳定的方法。
1、在项目根目录下创建隐藏文件夹 .cursor，并在其中新建子目录 rules。
2、在 .cursor/rules/ 下创建纯文本文件 project_rules.md，内容需包含明确、无歧义的条目。
3、写入至少5条可执行规则，例如：
“所有 Kotlin 函数名必须使用 lowerCamelCase，禁止出现下划线”；
“网络请求类必须统一继承 BaseRemoteService，且存放于 data/remote/impl 目录”；
“每个公共函数必须包含 KDoc 注释，首行说明功能，后续 @param/@return 不可省略”。
4、保存后重启 Cursor，或执行 /reload rules 命令使新规则立即生效。
二、使用 /generate rules 指令动态生成初稿
该方法适用于缺乏规则起草经验的团队，利用 Cursor 自身能力快速产出结构化草案，再人工校验与精简，避免规则冗余或模糊。
1、在任意代码文件中按下 Ctrl + L（Mac 为 Cmd + L）打开 Chat 窗口。
2、输入指令：/generate rules for Android Kotlin project using Jetpack Compose, with naming, package structure, and error handling requirements。
3、等待 AI 返回 Markdown 格式的规则建议，复制全部内容到 .cursor/rules/project_rules.md 中。
4、人工审查每一条规则，删除无法验证或表述宽泛的条目（如“保持代码整洁”），替换为可判定的语句（如“每行代码长度 ≤ 100 字符”）。
三、在 Prompt 中嵌入 Mini-Spec 式技术约束
当单次生成任务对规范敏感度极高（如核心模块开发），可在提示语中显式声明关键约束，形成临时但强效的上下文锚点。
1、在编辑器中选中目标区域或光标置于空行，按下 Ctrl + K 调出 Composer。
2、输入完整提示，格式须含技术栈、行为限制与结构要求，例如：
用 Kotlin + Jetpack Compose 实现 SettingsScreen。要求：① 使用 Material3 组件；② 所有可点击项必须带 ripple 效果；③ ViewModel 必须继承 BaseViewModel；④ 所有字符串资源从 strings.xml 引用；⑤ 遵循 .cursor/rules/project_rules.md 中定义的命名与包结构规则。
3、按 Ctrl + Enter 提交，AI 将优先匹配已加载的 rules 文件，并在无法覆盖时以提示语为准。
四、启用 YOLO 模式并绑定规则校验流程
YOLO 模式提升输出完整性，但默认不校验规范符合性；结合手动触发规则检查，可形成“生成→验证→修正”闭环。
1、进入设置界面，导航至 实验性功能（Features），开启 YOLO 模式 开关。
2、生成代码后，在 Chat 窗口中输入：/check compliance against .cursor/rules/project_rules.md。
3、AI 将逐条比对当前文件与规则文件的冲突点，例如：“检测到函数名 useDarkModeSwitcher 含大写字母，违反 lowerCamelCase 规则”。
4、根据反馈直接调用 Ctrl + K 并输入修正指令：rename this function to useDarkModeSwitcher → useDarkModeswitcher。
五、通过 @ 符号注入已有代码上下文并施加规则锚定
该方式适用于重构场景，让 AI 在理解现有结构的基础上，严格遵循既定规范进行局部重写，避免破坏整体一致性。
1、选中待重构的代码块（如一个旧版 XML 布局对应的 Activity 类）。
2、右键选择 Ask Cursor，或按 Ctrl + K。
3、输入指令：refactor this Activity into a Jetpack Compose Screen, using same state logic, and strictly follow the package structure and naming rules in .cursor/rules/project_rules.md。
4、AI 将解析所选代码语义，并在生成结果中确保：UI 代码存于 ui/screen/ 目录、ViewModel 类名以 ScreenNameViewModel 结尾、状态变量命名符合 state_xxx 模式。
