跳到主要内容

Templates

MushroomAgent 通过加载工作区上下文文件来定制 agent 的行为、人格和操作边界。将这些文件放在工作区目录中，agent 会在每次会话启动时读取它们。

工作原理​

Agent 启动会话时，会扫描工作区中的已识别文件名并加载为上下文。每个文件有特定用途 — agent 使用它们来理解自身的规则、身份和操作边界。

已识别的文件​

文件用途
AGENTS.md项目规则、操作约束和执行边界
SOUL.md人格与语调 — 语气、风格和角色
IDENTITY.md规范的自我身份、角色和自我介绍
HEARTBEAT.md心跳检查清单和心跳特定操作指导

文件是可选的 — agent 只加载工作区中存在的文件，在 think 阶段将其作为原始上下文在相关时应用。

文件位置​

~/.MushroomAgent/
├── config.yaml
├── prompts/            # init 生成的工作区上下文文件
│   ├── AGENTS.md       # 规则与约束
│   ├── SOUL.md         # 人格与语调
│   └── IDENTITY.md     # 自我身份
├── HEARTBEAT.md        #
├── storage/
├── logs/
└── skills/

根目录下的 AGENTS.md、SOUL.md、IDENTITY.md 仍然受支持；当根目录与 prompts/ 中同时存在同名文件时，根目录文件优先生效。

加载行为​

  • 文件在会话启动时加载，注入到 agent 的上下文 prompt 中
  • 每个文件作为独立的上下文段加载
  • 超过 4000 字符的文件会被截断（可通过 max_file_chars 配置）
  • 所有文件的上下文总上限为 12000 字符（可通过 max_total_chars 配置）
  • 如果存在 IDENTITY.md，agent 将其视为规范的自我身份来源

自定义​

只需在工作区目录中创建这些文件并填入你想要的內容。重启或开启新会话后 agent 会自动加载。