AGENTS.md:给不同项目定义不同规则

上一节,我们刚刚把 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:给不同项目定义不同规则-大赛人网

注意图中“读取规则”和“实际执行检查”是两件事:前者让 Agent 知道项目约定,后者还需要由确定性的程序规则兜底。不能因为模型读过 AGENTS.md,就默认它每一步都会遵守。

图片[2]-AGENTS.md:给不同项目定义不同规则-大赛人网

不同规则来源:

图片[3]-AGENTS.md:给不同项目定义不同规则-大赛人网
© 版权声明
THE END
喜欢就支持一下吧
点赞11 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容