Skip to content

以自然语言作为协议:规范化 sense payload 与 descriptor schema #18

@xiaoland

Description

@xiaoland

摘要

Sense payload 与 descriptor contract 仍然包含重复信息或放错层的信息。
这个 issue 属于产品层的 natural language as protocol 方向:协议本身应当同时对 runtime code 与 LLM 可读,而不依赖偶然的重复字段或不透明的 transport leakage。

动机

Payload cleanup 与 descriptor semantics 本来就是同一个 contract surface。
重点不只是 schema 更整洁,而是让协议在面向自然语言的 tooling 与 prompts 中也具有可读性,同时继续保持机器侧的 ownership boundaries 明确。

规格 / 验收标准

  • 每一项信息只在正确的 contract layer 出现一次。
  • act_instance_id 之类的 correlation fields 位于 metadata,而不是 payload。
  • descriptor definitions 以及生成出来的 schema / runtime surfaces 包含人类可读的 description
  • 看起来像 transport leakage 或 schema confusion 的字段被移除或迁移。
  • 最终 contract 更容易作为面向自然语言的协议被消费,而不依赖重复 metadata。

技术约束

  • 保持 metadata 与 payload 之间规范性的 ownership split。
  • 优先选择 schema clarity,而不是继续背着遗留重复字段前进。
  • 不要仅仅因为某个实现方便,就把 transport concerns 偷运到 protocol surface 上。

向后兼容

除非明确要求,否则不需要。

参考

  • 来源于 TODO.mdtasks/todo-issue-migration/RESULT.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    type:featureNew capability or user-facing featureunit:coreBeluna core runtime and domain logic

    Projects

    Status

    Backlog

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions