编程 Agent 之间交接用 Markdown 还是 JSON？社区激辩交接模板设计

RocketSeven · reddit · 2026-09-07

Reddit 用户提出一个编码智能体协作中的实际问题：当工作在多个 agent 之间切换时，交接文档该用什么格式？两类读者需求不同——下游 agent 需要可校验的显式字段，人类则需要能直接审阅决策、遗留问题、文件位置和证据。

作者给出两个候选方案：一是短 Markdown 简报搭配一个小型 JSON manifest；二是单一带版本控制的 JSON 文档，用 schema 校验并自动生成 Markdown 供人审阅。作者认为交接契约应保留目标、约束、已改动文件、已执行命令、验证结果、资产链接、未决风险和明确的下一步动作，并询问哪些字段应设为必填、如何防止「人类可读摘要」与「机器状态」二者漂移失效。目标是定义一个可复用的编码工作交接模板。