工作区模板
xopc 使用 profile Markdown 模板定义智能体行为与知识。执行 onboard、setup 或 agents add 时,会将缺失的模板 复制(不会覆盖已有文件)到该智能体 解析后的 Markdown 工作空间根(见 磁盘与目录布局)。下文列出标准文件名与用途,便于对照编辑。
运行时选取模板的顺序:XOPC_TEMPLATE_PATH(若设置且存在)→ 从安装目录向上查找 docs/reference/templates → 否则使用与 workspace-seed 同目录打包的 workspace-templates/。文档站中的 docs/zh/reference/templates/*.md 仅用于中文路由展示,与运行时种子无直接关系(正文目前与英文模板相同)。
模板文件列表
| 文件 | 用途 |
|---|---|
| SOUL.md | 智能体的核心身份、个性与价值观 |
| TOOLS.md | 工具使用说明和最佳实践 |
| AGENTS.md | 多智能体协作说明 |
| IDENTITY.md | 身份和边界定义 |
| HEARTBEAT.md | 主动监控配置 |
系统提示加载顺序
以下文件从智能体 profile 根读取,并按此顺序写入智能体系统提示。全局个人资料会从 user/PROFILE.md 单独读取,并排在智能体 profile 前。
- SOUL.md
- IDENTITY.md
- TOOLS.md
- AGENTS.md
- HEARTBEAT.md
CONTEXT.md、SKILLS.md 不在默认写入系统提示的列表中。xopc init 不会在工作区根下创建这两个文件;需要时可自行放在工作区根。onboard / agents add 的种子流程只复制上文列表,不会自动从本文档目录带入 CONTEXT.md / SKILLS.md(需自行放入工作区根)。
记忆系统
记忆不属于 Agent profile 模板。所有 Agent 使用同一份用户存储:user/MEMORY.md 与 user/memories/MEMORY.md。通过顶层 userContext 统一配置,并在运行时使用 memory_search、memory_get 和 curated_memory。见 共享用户记忆。
编辑建议
- 使用 Markdown 格式
- 保持简洁,关键信息放在前面
- 定期更新全局个人资料与共享用户记忆
- 使用清晰的标题结构