30分钟:从零搭出你的第一个AGENTS.md(附模板)
一句话:AGENTS.md不是写文档,是给AI画边界。这篇给你一个30分钟能填完的模板,附4版迭代对比和姜胡说"中军十二营"的外部验证。
📌 "一人公司AI内容生产系统"系列 第02篇/共48篇
◆ 当前阶段:启动篇 第2篇
◆ 上一篇:为什么你学了那么多AI课,工作流还是一团乱?(第01篇)
◆ 下一篇:知识库从0到500条,我只坚持了3件事
◆ 系列总纲:一个人+AI=一家公司
读者速览
- 适用人群:正在用AI但觉得AI"不太听话"的技术人和创作者
- 核心产出:AGENTS.md完整模板 + 4版迭代对比 + 姜胡说中军十二营对照
- 阅读时长:约8分钟
- 可保存性:模板可直接复制使用

一、是什么卡住了我
同样的AI模型,在不同人手里输出质量能差3倍。差距不在"谁更会写提示词",在**“谁更会给AI定边界”**。
AGENTS.md就是干这件事的——它不是一份文档,是一个明确的边界协议。
我写AGENTS.md写了4版才跑通。V1一句话没用,V2有方向没规则,V3加了一堆"不能"结果AI什么都不敢做。到V4改成画边界,AI才开始主动给建议。(开发的AGENTS还要复杂一些)
二、底层逻辑:边界比规则更重要
AGENTS.md的核心不是告诉AI"怎么做",是告诉AI"什么能做、什么不能做"。
| 维度 | 写规则(V1-V3) | 画边界(V4) |
|---|---|---|
| AI的行为 | 等着你下指令 | 主动给建议 |
| 出错概率 | 要么不干活,要么乱干 | 可控范围内发挥 |
| 迭代频率 | 每次换工具都要重写 | 换工具只改路径 |
三、外部验证
姜胡说的AI内容生产系统里有一个"中军十二营",他把12个AI角色分工,每个角色有明确的职责边界。细作营侦察热点,斥候哨监听问题,锦衣卫做质检——每个AI只做一件事,但有明确的标准。
这和我做AGENTS.md的核心逻辑一致:先画好边界,再让AI发挥。 不给AI写流程,给AI画范围。
四、我是怎么做的
文件放哪
桌面工具(Codex/Cursor): 放在项目文件夹最顶层。
Obsidian知识库: 放在库的根目录(打开Obsidian时默认进去的文件夹)。
手机APP: 用不到。等你在电脑上开始项目了再用。
模板(可直接复制)
# AGENTS.md — 我和AI的协作协议
## 我是谁
- 我是{你的名字},做{你的领域}
- 我的核心方向是{一句话}
- 我的知识库在{路径}
## 我的规则
- 给方案前,先想2种替代思路
- 不确定的事直接说"不确定"
- 引用我的知识库时标注来源
## 我现在在做什么
- 当前项目:{项目名称}
- 本周目标:{本周目标}
- 优先级:{1/2/3}
## 禁止行为
- 不要编案例
- 不要替我决定
- 不确定时不要猜
## 主动提议
如果发现以下情况,主动提醒我:
- 某个操作可以固化成模板
- 某个问题跟知识库里已有内容相关
4版迭代对比
| 版本 | 写法 | 结果 | 教训 |
|---|---|---|---|
| V1 | “这是一个说明文件” | AI回了一篇3000字论文 | 没约束等于白写 |
| V2 | “我是谁+做什么” | AI知道方向但不会配合 | 有身份没规则 |
| V3 | 全是"不能" | AI什么都不敢做 | 限制太多反而更差 |
| V4 | 边界+方向+空间 | AI既守规矩又主动给建议 | 画边界,不是画牢房 |
五、这篇你可以直接带走的东西
交付物: 上面这份模板,复制粘贴改{}就是你的V1。
填写指南: 打开记事本→粘贴→替换{}→保存为AGENTS.md。3分钟出V1。
填完标准: 把{}全部替换掉之后,读一遍。如果你觉得"这个AI大概知道我是谁、我是什么风格、什么能做、什么不能做"——及格了。
AGENTS.md模板可直接复制使用。资源文件见评论区置顶。
AGENTS.md写好了。文件有了,但往里面放什么?
下一篇: 知识库从0到500条,我只坚持了3件事。
💬 你给AI定过规则吗?评论区分3种情况:
A. 写过类似的AGENTS.md
B. 没写过但正在用AI干活
C. 还没开始用AI
你属于哪种?
更多推荐




所有评论(0)