上一节,我们刚刚把 Agent 的通用能力拆成了 Skills。
例如:
skills/
├── python-debug/
│ └── SKILL.md
├── flask-project/
│ └── SKILL.md
└── data-analysis/
└── SKILL.md
这样,一个任务遇到 Python Debug 时,可以加载:
python-debug
遇到 Flask 项目时,可以加载:
flask-project
遇到数据分析时,可以加载:
data-analysis
这解决的是,“遇到某类任务,一般应该怎么做?”
但 Coding Agent 真正进入一个具体项目以后,还会遇到另一类问题,“这个项目自己有什么特别规则?”
例如项目 A:
Python 3.9
pytest
允许新增依赖
tests/ 可以改
项目 B:
Python 3.9
只能使用 unittest
不允许新增依赖
绝对不能改 tests/
如果你的 Coding Agent 只有一个通用 python-debug Skill,它并不知道:
当前项目到底遵守哪套规则。
这时候就需要一个项目级规则文件:
AGENTS.md
例如:
# AGENTS.md
- Python 3.9
- 不允许修改 tests/
- 使用 pytest
- 修改代码后必须执行测试
- 不允许新增第三方依赖
Agent 进入项目以后自动读取。
从这一章开始,我们要让 Coding Agent 形成一个很重要的习惯,进入项目,先读规则,再动代码。
这也是 Coding Agent 从“会改代码”变成“会在真实工程里改代码”的关键一步。
开场引入
我们先看一个很真实的场景。
用户说,“帮我修复这个 Flask 项目的一个 Bug。”
Agent 进入项目后,看到了:
app/
tests/
requirements.txt
pyproject.toml
然后它发现:
requests
版本太旧。
模型很自然地想:
升级 requests。
甚至直接修改:
requirements.txt
看起来没问题。
但这个项目可能有一条明确规则:
不允许新增或升级第三方依赖。
因为当前项目处于:
冻结版本阶段
或者:
线上兼容性验证阶段
这时 Agent 的“最佳实践”反而违反项目要求。
再看另一个例子。
用户说,“帮我让测试通过。”
Agent 发现一个测试断言:
assert result == 3
而代码返回:
4
模型可能判断:
测试过时了,我改测试。
结果它直接修改:
tests/test_service.py
但项目规则明明写着:
不允许修改 tests/
因为测试被视为,当前任务的验收标准。
再比如:
修改代码后必须执行 pytest
如果 Agent 只改代码但没有验证,就不能算完成任务。
这些都不是:
通用 Python 调试规则
而是:
当前项目自己的约束。
所以我们要把规则放到:
AGENTS.md
然后 Agent 在进入项目时:
discover AGENTS.md
↓
read AGENTS.md
↓
parse / inject
↓
build context
↓
开始工作
这样,Coding Agent 才真正知道:
这个项目能做什么
不能做什么
怎么验证
什么时候算完成
知识地图
先把“规则从哪里来、又怎样真正影响执行”连成一条线。下面这张图把发现、读取、整理和使用 AGENTS.md 的过程放在了一起,大家后面看到 Loader、Context 或 Middleware 时,就能知道它们各自接在哪一段。
![图片[1]-AGENTS.md:给不同项目定义不同规则-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1735.png)
注意图中“读取规则”和“实际执行检查”是两件事:前者让 Agent 知道项目约定,后者还需要由确定性的程序规则兜底。不能因为模型读过 AGENTS.md,就默认它每一步都会遵守。
![图片[2]-AGENTS.md:给不同项目定义不同规则-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1736.png)
不同规则来源:
![图片[3]-AGENTS.md:给不同项目定义不同规则-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1737.png)
















请登录后查看评论内容