Cursor Agent 编码最佳实践(精简版)
一、核心理念
Cursor 的 Agent 由 Instructions(规则)+ Tools(工具)+ User Messages(指令) 组成。Agent 不是“自动写代码机器”,而是需要被清晰引导的协作型工程助手,不同模型在相同指令下表现可能不同。
⸻
二、先规划,再执行(最重要)
优先使用 Plan Mode(Shift+Tab):
• Agent 会先分析代码库、提出澄清问题、生成可审查的实现计划
• 计划是可编辑的 Markdown,可保存复用
• 调整计划比事后反复改代码更高效
• 简单、明确的小任务可直接跳过规划
⸻
三、上下文管理原则
• 让 Agent 自行检索上下文:通过语义搜索和 grep 自动找相关代码
• 只有在你明确知道关键文件时才手动指定
• 避免塞入无关信息,防止噪音干扰
• 任务切换或 Agent 明显跑偏时,开启新对话
• 使用
@PAST Chats 引用历史,而非复制粘贴
⸻
四、Rules 与 Skills
Rules(静态规则)
• 存在 .cursor/rules/
• 只写关键约束:构建方式、测试命令、编码规范、常见错误
• 规则应短、稳定、可版本化,适合团队共享
Skills(工作流能力)
• 封装常用任务和自动化流程
• 如:运行测试直到通过、UI 迭代、集成外部系统
• 本质是让 Agent 学会“怎么干活”,而不仅是“写代码”
⸻
五、图像也是上下文
Agent 可直接理解截图、设计稿:
• 从设计稿生成 UI
• 通过错误截图进行可视化调试
• 比纯文字描述更高效
⸻
六、高效工作流模式
TDD 模式
1. 先写测试
2. 确认测试失败
3. 再实现代码
4. 直到测试通过
→ 为 Agent 提供明确、可验证目标
代码理解
• 直接提问模块职责、数据流、设计动机
• Agent 会自动定位相关代码并解释
Git 自动化
• 自动建分支、提交、提 PR
• 将常用流程沉淀为可复用命令
⸻
七、质量保障
• 实时观察 Diff,必要时中断
• 使用 Agent Review 查问题
• PR 后用 Bugbot 自动审查
• 复杂逻辑可让 Agent 生成架构图辅助评审
⸻
八、并行与多 Agent
• 支持 Git worktree,多 Agent 并行尝试不同方案
• 可对同一任务用多个模型对比结果,择优合并
⸻
九、云端 Agent 与 Debug
• 云端 Agent 可异步处理修复、重构、测试、文档
• Debug 模式适合复杂问题:提出假设、加日志、复现、定位并修复
⸻
十、总体原则
• 明确目标 + 可验证机制
• 人始终负责决策与审查
• 从简单开始,逐步沉淀规则和流程
• 把 Agent 当“高级工程协作者”,而不是替代品