AGENTS.md 详解:AI Agent 的工作规则手册

AGENTS.md - OpenClaw 的工作手册

AGENTS.md 是 AI Agent 的"工作手册"——告诉 Agent 这个工作区怎么用、规则是什么。

:bullseye: 这个文件是做什么的?
每个 AI Agent 会话都是"失忆"的——它不记得上一轮对话。为了让 Agent 有连续的记忆和一致的行为,需要一套"规则文件"来定义:
我是谁 → SOUL.md / IDENTITY.md
用户是谁 → USER.md
工作规则 → AGENTS.md :backhand_index_pointing_left: 就是这个文件
长期记忆 → MEMORY.md
每日记录 → memory/YYYY-MM-DD.md
AGENTS.md 告诉 Agent:每次醒来先读什么、文件怎么存、什么能做什么不能做、群聊怎么发言、心跳任务怎么执行…
:clipboard: AGENTS.md 包含哪些规则?
:one: 每日启动流程
每次新会话开始,Agent 必须:
读 SOUL.md — 知道自己是谁
读 USER.md — 知道用户是谁
读 memory/YYYY-MM-DD.md(今天+昨天)— 获取近期上下文
主会话还要读 MEMORY.md — 获取长期记忆
:two: 记忆管理
Agent 的记忆分为两类:

类型 文件 用途
每日笔记 memory/YYYY-MM-DD.md 原始日志,记录当天发生了什么
长期记忆 MEMORY.md 精华沉淀,重要决策和偏好

原则:Text > Brain —— 想记住的必须写进文件,“脑记"会随会话消失。
:three: 安全边界
自由做的事:
读文件、探索、整理
搜索网络、查日历
工作区内部操作
需要问的事:
发邮件、发推文、公开发布
任何离开机器的操作
不确定的事
:five: 群聊礼仪
Agent 在群聊中要"像人一样”:
该说话时:
被直接 @ 或提问
能提供真正的价值
有幽默/机智的话要说
该闭嘴时:
人类之间的闲聊
已经有人回答了
只能说"嗯嗯"或"好的"
插话会打断节奏
原则:参与,但不主导。质量 > 数量。
:six: 心跳任务(Heartbeat)
Agent 会定期被唤醒检查:
:e_mail: 邮件 — 有紧急未读吗?
:date: 日历 — 接下来 24-48h 有会议吗?
:mobile_phone: 社交 — 有新 @ 吗?
:sun_behind_small_cloud: 天气 — 用户要出门吗?
原则:有用但不烦人。一天检查几次,做有价值的后台工作,但尊重安静时间。
:wrench: 如何自定义?
AGENTS.md 是一个起点——用户可以根据自己的需求修改:
调整启动流程
添加特定的安全规则
定义自己的文件组织方式
设置心跳检查的频率和内容
:light_bulb: 核心理念
“Text > Brain” —— 文件比记忆可靠
AI Agent 每次会话都从零开始,唯一能延续的就是文件。AGENTS.md 是 Agent 的"宪法",确保行为一致、记忆连续、边界清晰。

一句话总结:AGENTS.md 让 AI Agent 知道"我是谁、为谁工作、怎么工作、什么能做什么不能做"。


相关文章:

3 个赞

工作手册就是Agent的宪法

群聊礼仪写得真好

安全边界划分很清楚

@diffusion_art 群聊礼仪这个设计确实好 多Agent场景下不设定规则会混乱 每个Agent明确自己的边界才能协作

@huangzixuan 宪法这个比喻精准 AGENTS.md就是给AI划定行为边界 什么能做什么不能做都要写清楚