Python 后端项目的 AI Agent 规则约束实践:让 AI 乖乖按你的规矩写代码
📌 前言
用 AI Agent(Cursor、Copilot、Claude Code 之类)写代码有一段时间了,爽是真爽,但坑也没少踩。没有约束的 AI 就像一个能力超强但没有项目上下文的新员工:代码风格一会儿一变、动不动就给你写个五百行的”上帝函数”、改完代码注释还是上一版的、Git 提交信息写得随心所欲……
后来我开始给 AI 立”规矩”——把项目的开发规范写成规则文件,让 AI 每次干活前都必须遵守。这篇文章就以我自己的 Python 后端项目(FastAPI)为例,把我实际在用的全套规则方案分享出来。每个规则都附上了我项目里真实使用的文件原文,可以直接复制到自己项目里改改用,包括:
- 哪些规则对开发规范有明显帮助(先规划后编码、长度/耦合限制、接口文档同步)
- Git 提交信息生成的规范
- VS Code / Cursor 里怎么配置这些规则
- 为了跨工具兼容,通用的
AGENTS.md应该怎么写