实践指南：智能体运行时文件一览
工作区里 我的智能体 在服务端有一份 运行时材料（你在 Web 各页编辑，不必自己找磁盘路径）。下面用 界面名称 为主，括号内为实现文件名，供对接与排查时对照。
来源 help/guides/runtime-files-map.md
表述：工作区里 我的智能体 在服务端有一份 运行时材料（你在 Web 各页编辑，不必自己找磁盘路径）。下面用 界面名称 为主，括号内为实现文件名，供对接与排查时对照。
总览表
| 用户侧说法 | 实现文件（相对该智能体） | 在哪维护 | 对话里大致作用 |
|---|---|---|---|
| 人格 | SOUL.md | 智能体 → 人格 | 语气、立场、简洁度、表达边界；高优先级 |
| 操作规则 | AGENTS.md | 智能体 → 操作规则 | 怎么做：步骤、工具/技能约束、日期怎么算 |
| 终端用户画像 | USER.md | 智能体 → 记忆 页上方 | 关于 你是谁：称呼、稳定背景（可选） |
| 长期记忆 | MEMORY.md + memory/entries/*.md | 智能体 → 记忆 页条目；或消息 「记住」；可对话纠正/删除 | 跨会话偏好、决策、项目节点、去哪查 |
| 整理记录 | memory/.maintain/log.jsonl | 智能体 → 记忆 → 自动整理记录 | 夜里/手动清理留下的变更说明（只读） |
| 日笔记 | memory/YYYY-MM-DD.md | 同上（选「日笔记」）或系统自动归档 | 近几日的临时进展 |
| 任务 | TASKS.md | 智能体 → 任务 | 待办、目标、草稿；对话时 节选 注入 |
| 智能体知识文档 | knowledge/*.md | 智能体 → 知识文档 | 角色口径、业务说明；按问题 检索 相关篇 |
| 工作区知识文档 | 工作区侧目录 | 工作区协作 → 管理工作区知识 | 团队共用制度、流程、背景 |
| 技能 | 工作区技能中心（DB） | 技能中心 | 按步骤复现操作（接口、脚本），不是背景知识 |
| 可用数据与技能 | 智能体配置（config_json） | 智能体 → 概览 → 可用数据与技能 | 限定或优先本智能体可用的 数据连接 与 工作区技能（不扩大成员授权） |
帮助智能体 没有上述个人运行时文件；它读 系统知识文档（本 help/ 目录）。
对话时拼装顺序（简化）
发给模型的系统侧材料，大致按此顺序叠加（越靠前越像「硬约束」）：
- 基础系统提示
- 人格（
SOUL.md） - 操作规则（
AGENTS.md） - 用户画像（
USER.md，若有） - 记忆（长期记忆清单 + 少量相关条目全文 + 今/昨日笔记节选）
- 任务节选（若有）
- 检索到的 知识文档 / 技能 片段
- 当前会话消息
因此：禁止瞎编接口 这类 执行约束 应写在 操作规则（并配合技能正文），而不是指望 记忆 或 人格 单独承担。
各文件写什么、不写什么
人格（SOUL.md）
写：怎么说（简洁/正式/先结论后步骤）、对用户的态度、哪些话题要慎重、术语习惯。 不写：具体 API 路径、相对日期计算公式、仅对你个人成立的一次性事实。
操作规则（AGENTS.md）
写：先调哪个工具、日期范围怎么算、缺参数时追问什么、只许用技能里声明的接口、失败时如何向用户说明。 不写：幽默风格、长篇业务背景（放知识文档）。
用户画像（USER.md）
写：稳定身份——「我是财务，不看代码」「请叫我小李」。 不写：会变的项目进度（用 记忆·项目进展 或日笔记）、团队统一制度（用工作区知识）。
长期记忆（MEMORY.md 索引 + 条目）
写：你的 个人 偏好与纠正、已确认决策、个人项目节点、个人常用的「去哪查」。 不写：团队统一口径（工作区知识）、智能体角色设定（智能体知识）、每次都必须遵守的操作步骤（操作规则）。
日笔记
写：今天正在做什么、本轮临时结论。 不写：应长期保留的偏好（应晋升到长期记忆）。
任务（TASKS.md）
写：待办列表、阶段目标、你自己记的草稿提纲。 不写：已完成的稳定决策（应进长期记忆或知识文档）。
知识文档 vs 技能
| 知识文档 | 技能 | |
|---|---|---|
| 回答什么 | 「是什么、为什么、口径如何」 | 「按什么顺序调接口、参数从哪来」 |
| 典型内容 | 制度、产品说明、FAQ | http_request 步骤、脚本、模板 |
| 维护入口 | 工作区 / 智能体 知识文档 | 技能中心 |
下一步
- 拿不准落点 → 写在哪里：决策与案例
- 要模板 → SOUL / AGENTS / USER 与记忆