Agent 输出格式

Agent 输出格式是指智能体在完成任务时选择用 Markdown、HTML、纯文本、JSON、CSV、幻灯片、Canvas 或专用 UI 交付结果的策略。Thariq 的文章把这个问题从“Markdown 是否足够”推进到“输出物到底服务谁”：如果文档主要给 agent 存取和继续加工，Markdown/结构化文本通常更高效；如果主要给人阅读、评审、分享或交互，HTML-Artifacts 可能更有效。

判断维度

1. 读者是谁：给 agent 的上下文偏向 Markdown、JSON、YAML 等易解析格式；给人类决策者的规格、报告、PR 解释更适合 HTML、deck 或图形化页面。
2. 是否需要交互：如果用户要调参、拖拽排序、比较方案、导出选择结果，HTML 比 Markdown 更自然。
3. 是否长期维护：需要版本控制、可 diff、可搜索、可迁移的知识资产仍应保留 Markdown 源；HTML 可以作为编译/呈现产物。
4. 是否需要分享：普通链接分享、移动端阅读、跨组织阅览时，HTML 的打开成本低于 Markdown 附件。
5. 是否需要机器复用：若后续 agent 要继续消费，输出应包含可复制的 JSON、prompt、diff 或 Markdown 摘要，避免只有视觉层没有结构化数据。

实践模式

• 源文档 + 呈现层：让 agent 先产出 Markdown/JSON 事实层，再生成 HTML Artifact 作为人类阅读层，兼顾 token 效率与可读性。
• 一次性 UI + 导出按钮：临时 HTML 编辑器必须提供“copy as JSON / copy as prompt / copy diff”，把人的选择重新转回 agent 可处理格式。
• 评审优先格式：PR、incident、研究报告、方案对比等需要别人真正读完的材料，优先考虑 HTML 化。
• 长期知识库格式：像 Andrej-Karpathy 的 LLM Wiki 这类可累积知识库，Markdown 仍是更适合的源格式；必要时再渲染为网站。

对 Agent 工作流的启发

格式选择正在变成工作流路由的一部分。Claude-Code 不只是“写代码的工具”，也可以根据任务阶段生成不同格式：探索阶段用 HTML 对比方案，执行阶段用 Markdown 计划和 TODO，验收阶段用 HTML 报告或可交互检查页，长期沉淀则回写 Markdown wiki。这个分层能减少“人不读计划、agent 自己跑偏”的风险，让人重新进入 loop。

相关概念

• HTML-Artifacts：面向人类阅读、交互和分享的 HTML 输出物。
• Claude-Code：具备文件系统、MCP、浏览器和 git history 上下文，可按任务生成不同输出格式。
• Prompt-Engineering：提示词中要明确输出格式、读者、用途和导出要求。
• Agentic-Coding：智能体编码场景中格式选择直接影响审查、协作和验收。