写作 agent 什么时候应该让页面一张图都没有
在本站，写文章或文档的 agent 不是先去生图。它先锁定论证，再问：这篇里有没有哪个位置，需要一张图，才能让认真读的人更快或更稳地看懂？
很多时候答案是不需要。这不是「内容不够丰富」，而是我们想要的默认。
当答案是需要时，agent 不即兴发挥，而是走写作 skill 里的小流水线。
流水线
文字回退： 大纲 → visual-plan → 零个或多个按 kind 的 skill（visual-diagram / visual-illustration / visual-screenshot）→ 正文（含 fallback）→ 发布。
SVG 由已提交的结构化 graph 生成；graph 是权威源。
各 skill 做什么
| Skill | 职责 | 不做 |
|---|---|---|
visual-plan | 是否配图；写 visuals/plan.yaml | 不生成像素 |
visual-diagram | 结构化 graph → 清洗 SVG | 不把 AI 手绘当架构真相 |
visual-illustration | brief → 候选图；人工审后发布 | 不编码指标、假 UI、架构 |
visual-screenshot | 真实采集 + 版本 + 日期 | 不用 AI 假界面 |
本文即该流水线的测试：plan 含两个 slot、一张由 graph 生成的结构图、一张由 brief 生成的装饰插画。
什么时候图说得通
写清：读者要弄懂 X；没有图会漏 Y；权威来源 Z；失败时仍可读 W。然后只选一个 kind（diagram / chart / screenshot / illustration / embed）。
什么时候 0 图正确
表格或列表已够用；定义更适合散文；只是装饰；唯一来源是模型在发明架构或产品壳；只想给旧文「好看」——则不要图。存量批量配图不在范围。
写作时怎么跑
- 完成大纲
visual-plan→plan.yaml（可空）- 为每个 slot 先写 fallback
- 按 kind 跑 skill，提交 graph/brief、rendition、manifest
- 仓内保留
visuals/renditions/文件，上传后把公开https://URL 写进 Markdown（文章路由上相对路径目前会 404）。 - 插画保持
candidate直到 PR 上人工确认
这不是什么
不是每篇必杂志排版；不是任意 HTML/脚本 SVG/iframe；不是宣称所有 chart 路径已完工。它是可运行的写作闸门：显式规划、按 kind 渲染、保留 fallback，并允许「没有图」算成功。