Skip to content

工作区模板

xopc 使用 bootstrap 目录下的 Markdown 模板定义智能体行为与知识。执行 onboardsetupagents 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):

  1. SOUL.md
  2. IDENTITY.md
  3. USER.md
  4. TOOLS.md
  5. AGENTS.md
  6. HEARTBEAT.md
  7. MEMORY.md

BOOTSTRAP.md 也会在新建智能体时一并复制,但不在上述系统提示链中(仅作首次运行 / 人工说明)。

CONTEXT.mdSKILLS.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_searchmemory_get 工具搜索和读取记忆。

托管记忆(可选):agents/<agentId>/memories/MEMORY.mdUSER.md 存放有上限、可由 curated_memory 维护的条目,与 agents/<id>/bootstrap/ 下的引导用 MEMORY.md 不同。见 托管记忆配置参考agents.defaults.memory)。

编辑建议

  • 使用 Markdown 格式
  • 保持简洁,关键信息放在前面
  • 定期更新 USER.md 和 MEMORY.md
  • 使用清晰的标题结构

基于 MIT 许可证发布