部分参考资料：https://zhuanlan.zhihu.com/p/1900338212569854320

本文内容来自网络参考资料以及个人的实践理解，仅作为个人学习记录。

最近用Trae比较多（因为免费），所以相应的实践记录会更多。

Trae地址：https://www.trae.com.cn/

建议遵守的规则

Rule 的优先级遵循以下规则：用户输入>自定义 Agent Prompt > user_rules.md > project_rules.md

1. 在一开始就设定5-10条清晰的项目规则，让Cursor了解你的结构和约束。尝试为现有代码库执行/generate rules。

为什么是5-10条：项目规则应该给予代码规模来进行设计。

项目规则包括什么：通用规则+编程语言规则+框架规则

注意还可以设置个人规则，比如：“请总是使用中文回复”

如果是全新项目，建议先从通用规则开始，比如：

• 1. 项目结构规范：
  • 目录结构
  • 组织原则
• 2. 代码规范
  • 命名规范
  • ......

规则的编写应该清晰，指明主语，否则出现歧义AI可能无法正确识别。

如果已经完成了项目脚手架，可以在Agent模式输入中执行 /generate rules

小tip：

• 偷懒的同学，可以直接让AI挨个阅读项目里面重要的目录，让它给你梳理出一个比较合理的project rules。
• 或者通过上传package.json、requirement.txt等项目配置文件让AI生成rule
• 或者在https://cursor.directory/generate通过上传package.json、requirement.txt等项目配置文件让AI生成

2. 在提示中要具体。详细说明技术栈、行为和约束，就像一个迷你规范

在规则1的影响下，已经有了个人规则、项目规则。提示词是在这基础上的进一步约束。提示词越仔细，生成优秀代码的概率越高。

项目实践中，最好详细编写技术文档（绘制类图）：

• 如果类图上属性和方法定义比较清晰，可以直接复制类图给Gemini作为上下文（个人感觉使用Gemini效果更好），节省写提示词的时间。然后在对话时使用@Builder直接生成类的文件。
• 每轮对话最好只生成一个文件，然后针对这个类提出具体要求，比如：
  • 用xxx实现这个类，并且满足以下要求：1. xxx 2. xxx......
  • 附带类图的截图

3. 按文件逐个工作；在小块、集中的部分生成、测试和审查

如果只做功能简单的小项目，可以一次性生成全部代码。

如果涉及到复杂的中大型项目，需要学会拆解项目：核心就是功能模块化，然后按照逐个模块解决。

一个例子是：

阶段1:构建核心功能

        实现【用户登录-浏览商品-加购-下单-查单】的核心流程

        数据库：设计核心表结构

        商品：商品列表API，详情API

        用户：登录/注册

        购物车：增删改查

        订单：创建订单/查看订单        

阶段2:核心验证与调试

        手动验证全流程，修改API格式响应格式错误。

阶段3:模块化扩展

        按照优先级，逐步添加功能，每个模块独立测试。

        支付集成：处理订单支付

        后台商品管理：管理员增删改查商品

        订单状态流：支持发货、取消

4. 先写测试，锁定它们，然后生成代码，直到所有测试通过

Agent可能会修改测试文件去让测试通过。所以在测试前，建议使用.cursorignore去防止Agent修改测试文件。

5. 总是审查AI输出，并对任何错误的内容进行硬修复，然后告诉Cursor将其作为示例使用

每次输出均需要人工审查

有一个很好用的功能是，在Trae IDE中左侧有文件的「时间线」，如果觉得生成的代码质量不高，可以自行回退版本。

6. 使用@file、@folder、@git，将Cursor的关注点定位到代码库的正确部分

搭配第三点，将Agent的注意力集中到开发的模块上

7. 将设计文档和检查清单保存在.cursor/中，以便Agent能够全面了解下一步要做什么

.cursor/目录一般包含项目规则（第1点提到的），以及代码的索引。

使用Trae：目录是.trae/rules

8. 如果代码错误，就自己写。Cursor从编辑中学习比从解释中学习更快

如果Cursor在某个问题上纠缠不清，最好手动进行coding

这是显然的，AI生成的质量很大程度依赖于提示词，工具到底只是工具，最终仍需要人工审核。

9. 使用聊天记录来迭代旧的提示，而不需要从头开始

一个功能，尽量在一个对话窗口来完成

10. 有意选择模型。Gemini用于精确，Claude用于广度

国内可以使用deepseek r1，准确度也很高

11. 在新的或不熟悉的技术栈中，粘贴文档链接。让Cursor逐行解释所有错误和修复

使用Agent的联网功能

12. 让大型项目整夜索引，并限制上下文范围以保持性能敏捷

构建索引比较耗时，最好在夜间运行