type
status
date
slug
summary
tags
category
icon
password
 
Cursor 结合 AI 是很好用的，尤其是使用 Claude opus 模型的时候，简直不能更酷。人生苦短，我用 Claude。
只是使用 Cursor 还是需要注意一些技巧的。
一个问题是，在 Cursor 中该如何更好地使用 .cursorrules、copilot-instructions（如果使用 github copilot 的话）、AGEN ？
.cursorrules、copilot-instructions、AGEN，这三份文件，本质上是在 “驯化 Cursor 里的 AI”让它像一个熟悉你代码风格的高级工程师，而不是一个会乱改的实习生。
.cursorrules 使用场景，如：Swift / UIKit / 偏好的写法; copilot-instructions 使用场景，如：给模型节省 token，但不丢关键信息; AGEN 使用场景，如：行为边界，防止乱改代码 。

功能对比

文件
核心作用
给谁看
关键目标
.cursorrules
编码风格 & 技术偏好
Cursor 内置模型
写得像你、用你认可的方案
copilot-instructions.md
项目上下文压缩包
Copilot / Cursor
省 token、不反复解释
AGENTS.md
Agent 行为边界
Cursor Agent
防止“顺手重构整个项目”
推荐优先级：.cursorrules > AGENTS.md > copilot-instructions.md

一、.cursorrules —— 控制「怎么写代码」

它解决什么问题？

以 iOS 开发为例：
  • Swift 写法乱（UIKit / SwiftUI 混用）
  • ViewController 被 Agent 改成你根本没用到的 MVVM+RxSwift 模式
  • 风格不统一（guard / if let / 命名）
简而言之，.cursorrules = 编码“宪法”

Swift / UIKit 推荐写法示例

使用方法

✅ 生效场景
  • Cursor 的 Edit / Ask / Agent
  • 会自动注入 prompt（你不用管）
❌ 不生效
  • GitHub Copilot 原生（除非 Cursor 接管）
💡 经验
.cursorrules 越具体，Agent 越“听话”

二、copilot-instructions.md —— 给模型省 token 的「项目压缩包」

它是干嘛的？

不是风格，而是项目事实：
  • 架构是什么
  • 用了哪些库
  • 哪些是不能动的约定
目的只有一个：减少重复解释

正确写法示例

常见反例（千万别这么写）

❌ 把 README 全贴进来 ❌ 写成「团队文化宣言」 ❌ 写 Prompt 技巧（模型看不懂）
口诀： 事实 + 约束 + 禁区，不写动机、不写感受

三、AGENTS.md —— 防止 Agent「顺手帮你重写人生」

为什么需要它？

只要你用过 Cursor Agent，就会遇到：
  • “我只是让你改个按钮，你为什么动了 12 个文件？”
  • “你怎么把我 VC 拆成 5 层？”
AGENTS.md = “你只被授权干这些”

强烈推荐模板示例

Agent 什么时候会读它？

✅ 只有在 Agent 模式下 ❌ Ask / Edit 不一定遵守
💡 所以：
架构 & 风格 → .cursorrules行为边界 → AGENTS.md

四、三者怎么配合

日常改代码

  • 用 .cursorrules
  • 不开 Agent

小范围自动改

  • Agent + AGENTS.md
  • 明确点名文件

新人 / 新模型接手

  • copilot-instructions.md
  • 少解释 80%

小结

Cursor 不是“更聪明的 Copilot”， 它是一个“必须被立法约束的工程师”。