Prompt 组织

在 Mister Morph 主 Loop 中，Prompt 的唯一目的是为 Agent 拼装出合理的状态。

Prompt 状态由明确的文件、策略、运行时 metadata 和会话历史组成，不再注入单独的长期或短期记忆。

在 Mister Morph 里，这些语法糖由 agent/prompts/system.md 作为骨架组装。

主循环

静态 Prompt 骨架

这个模板大致长这样：

## Persona
{{ identity }}

## Available Skills
{{ skills }}

## Reference Format
{{ 约定的内部引用格式 }}

## Additional Policies
{{ 附加的大段策略 }}

## Response Format
{{ 约定的输出格式 }}

## Rules
{{ 内置规则 和 附加规则 }}

运行时 Prompt

进入某一次具体运行后，runtime 会把当前上下文继续补进去。

常见来源包括：

本地 persona 文件，比如 persona/identity.yaml 和 persona/soul.md
当前启用的 skill 元数据
附加的策略块

会随着当前任务、当前通道和当前本地状态变化。在 CLI、Telegram、Slack 里跑出来的最终 prompt，不一定完全一样。

Prompt 以外的消息编排

准备好最终 system prompt 之后，主 Agent 还会在请求里编排消息栈。

运行时 metadata 会作为一个 user 角色的 JSON envelope 注入，外层 key 是 mister_morph_meta。常见字段包括已有的 trigger / correlation 信息、运行时钟字段 now_utc / now_local / now_local_weekday，以及 host_os 这类宿主环境事实。

顺序可以理解成：

text

[system] 最终 system prompt
   ->
[user] context checkpoint（如有）
   ->
[user / assistant] 逐条历史消息
   ->
[user] 运行时 metadata
   ->
[user] 当前消息或原始 task

历史保留每条消息的边界。外部输入使用 user，当前 Agent 已发送的回复使用 assistant，并采用 Agent 自己的回复格式（{"type": "final", "output": ...}），避免模型照抄外部消息记录作为回答；其他机器人仍属于外部参与者。压缩会保留运行时 metadata，但不会把它放进总结。

启用缓存时，engine 在请求副本中标记历史或 checkpoint 的末尾。Anthropic 和 OpenAI GPT-5.6（Chat Completions 与 Responses）均保留这个标记和 system 标记。实际命中仍取决于 provider 和前缀是否保持一致。

独立 Prompt

Mister Morph 里还有一类调用不会先拼出主 Agent 的完整 system prompt，也不一定会进入带工具的多步 Loop，而是直接构造一组更小的 prompt，单次调用 llm.Chat。

这类独立 Prompt 会用于：

确定如何介入群聊
任务规划
一些语义判断或语义匹配类的小任务

和主 Loop 的关系

可以简单理解成两条路：

text

主 Agent 主 Loop
  -> 完整 system prompt
  -> checkpoint / history / runtime metadata / current message
  -> 可多步、可调工具

独立 llm.Chat
  -> 专用 system prompt / user prompt
  -> 单次调用
  -> 只解决一个很窄的问题

例如，Agent 在判断如何介入群聊时，会检查：

这条消息是不是在叫我
现在要不要插话
需不需要直接轻量回应（发表情）

这个判断发生在主 Loop 之前，所以它更适合走一个更小、更专用的 Prompt，而不是用整套主 system prompt 去判断。

Prompt 组织 ​

主循环 ​

静态 Prompt 骨架 ​

运行时 Prompt ​

Prompt 以外的消息编排 ​

独立 Prompt ​

和主 Loop 的关系 ​