工作区模板
xopc 使用 bootstrap 目录下的 Markdown 模板定义智能体行为与知识。执行 onboard、setup 或 agents add 时,会将缺失的模板 复制 到 ~/.xopc/agents/<agentId>/bootstrap/(已存在则不会覆盖)。内容与 src/agent/context/workspace-templates/*.md 一致,并发布在 docs/reference/templates/ 供文档站阅读。
运行时选取模板的顺序:XOPC_TEMPLATE_PATH(若设置且存在)→ 从安装目录向上查找 docs/reference/templates → 否则使用与 workspace-seed 同目录打包的 workspace-templates/。文档站中的 docs/zh/reference/templates/*.md 仅用于中文路由展示,与运行时种子无直接关系(正文目前与英文模板相同)。
模板文件列表
| 文件 | 用途 |
|---|---|
| SOUL.md | 智能体的核心身份、个性与价值观 |
| USER.md | 关于你的信息、偏好与需求 |
| TOOLS.md | 工具使用说明和最佳实践 |
| AGENTS.md | 多智能体协作说明 |
| MEMORY.md | 关键信息存储和记忆索引 |
| IDENTITY.md | 身份和边界定义 |
| HEARTBEAT.md | 主动监控配置 |
| BOOTSTRAP.md | 启动引导配置 |
系统提示加载顺序
以下文件从 bootstrap/ 读取(若存在),并按此顺序写入智能体系统提示(见 src/agent/context/workspace.ts 中的 BOOTSTRAP_FILES):
- SOUL.md
- IDENTITY.md
- USER.md
- TOOLS.md
- AGENTS.md
- HEARTBEAT.md
- MEMORY.md
BOOTSTRAP.md 也会在新建智能体时一并复制,但不在上述系统提示链中(仅作首次运行 / 人工说明)。
CONTEXT.md、SKILLS.md 不在 BOOTSTRAP_FILES 中,因此不会进入默认系统提示。xopc init 仍可能在 bootstrap/ 下生成这两个文件(见 src/cli/commands/init.ts)。而 onboard / agents add 使用的模板种子(workspace-seed.ts)只复制上文列表 + BOOTSTRAP.md,不会从 docs/reference/templates 提供 CONTEXT.md / SKILLS.md。
记忆系统
记忆文件支持动态更新:
- MEMORY.md - 永久记忆的索引
- memory/*.md - 按日期或主题组织的记忆片段
智能体可以通过 memory_search 和 memory_get 工具搜索和读取记忆。
托管记忆(可选):agents/<agentId>/memories/MEMORY.md 与 USER.md 存放有上限、可由 curated_memory 维护的条目,与 agents/<id>/bootstrap/ 下的引导用 MEMORY.md 不同。见 托管记忆 与 配置参考(agents.defaults.memory)。
编辑建议
- 使用 Markdown 格式
- 保持简洁,关键信息放在前面
- 定期更新 USER.md 和 MEMORY.md
- 使用清晰的标题结构