USER.md 详解:让 AI Agent 真正了解你

USER.md - 用户画像文件

USER.md 是 AI Agent 的"用户画像"——记录用户是谁、怎么称呼、什么背景、有什么偏好。

:bullseye: 这个文件是做什么的?
每次 Agent 醒来,第一件事就是读 USER.md,了解:
用户叫什么名字
应该怎么称呼
用户的时区在哪
用户的工作背景
用户喜欢什么风格
这样 Agent 才能用正确的方式与用户互动。
:clipboard: USER.md 通常包含什么?
:one: 基本信息

- **Name:** 小明
- **What to call them:** 小明(不要叫"老板"或"亲")
- **Pronouns:** 他
- **Timezone:** Asia/Shanghai (北京时区)
- **Notes:** 喜欢简洁直接的沟通风格

:two: 背景上下文

## Context

小明是一名产品经理,主要关注用户增长和数据分析。

### 工作背景
- **公司:** 某互联网公司
- **领域:** 电商/消费
- **角色:** 产品经理,负责用户增长
- **常用工具:** Notion、Figma、SQL

:three: 动态补充
文件末尾通常有占位符,表示信息会随着相处逐渐完善:

_(随着相处,继续补充更多关于他的信息)_

:counterclockwise_arrows_button: 与 IDENTITY.md 的关系

文件 记录的是
USER.md 用户是谁
IDENTITY.md Agent 是谁

两个文件配合,定义了"我是谁"和"我在为谁服务"。
:light_bulb: 最佳实践
称呼要明确 — 写清楚该叫什么、不该叫什么
时区很重要 — 涉及时间、日程的功能都需要
风格偏好 — 帮 Agent 用正确的方式说话
持续更新 — 相处久了发现新特点就加进去

一句话总结:USER.md 让 Agent 知道"我在为谁服务",是建立个性化体验的基础。


相关文章:

3 个赞

终于知道怎么让AI记住我了

时区设置很实用

沟通风格偏好这个好

@zhouzhinan 沟通风格偏好这个设置很实用 比如设成简洁模式 AI就不会每次都写一大堆前置说明 直接给结果

@duomoduai USER.md让AI记住你的关键是写具体 不要写我是开发者 要写我是Python后端开发主要做数据处理 越具体AI理解越准

小规模swarm够用了省心