痛点:每次都得从头交代
你有没有发现,每开一个新会话,都要重新告诉 Agent:“我们用两个空格缩进”“提交信息要中文”……烦不烦?
🔆像每天上班都要给新来的实习生重讲一遍公司规矩。不如直接贴一张《新人须知》在墙上。
解法:放一份项目规约文件
在项目根目录放一份规约文件(如 Claude Code 的 CLAUDE.md、Cursor 的 .cursorrules),把项目的固定规矩写进去。支持这套约定的 AI 工具每次开工会自动读它,不用你再重复。
# 项目规矩
- 缩进用 2 个空格
- 提交信息用中文
- 不要直接改 main 分支
- 改完先跑 `npm test`💡把“每次都要叮嘱的话”沉淀进去,这份文件就成了项目的长期记忆。
写什么、不写什么
适合写:稳定的规矩——代码风格、目录约定、提交规范、常用命令。
不适合写:一次性的临时需求(那个直接说就行),以及很快会变的细节。
⚠️别把它写成大杂烩。越长越容易触发上一单元讲的“长上下文翻车”,挑稳定且常用的写。
自测 · 学完检查一下
想真正动手做题、记进度、攒连胜?到互动课里练。
项目规约文件(如 CLAUDE.md)主要解决什么痛点?
答案:省去每次开新会话都重复交代项目规矩
把固定规矩沉淀成文件,Agent 自动读,不用你一遍遍重讲。
判断:没有规约文件时,项目的固定规矩往往要在每个新会话里重新交代。
答案:对
正是这个重复劳动的痛点,催生了把规矩写进文件的做法。
下面哪条最适合写进项目规约文件?
答案:“本项目缩进统一用 2 个空格、提交信息用中文”
稳定、反复适用的规矩才值得写进规约文件;一次性需求当场说即可。
判断:一次性的临时需求也应该全部塞进规约文件,越多越好。
答案:错
临时需求当场说就行;文件越臃肿越容易触发长上下文翻车,应只放稳定规矩。
规约文件的关键特性是:Agent 每次开工都会 ___ 它,不用你重复交代。
答案:自动读
正因为每次自动读取,写进去的规矩才能持续生效。
判断:规约文件越长越好,把所有能想到的都写进去最稳妥。
答案:错
过长会稀释重点、触发长上下文翻车,应挑稳定且常用的精炼内容。