| name | build-content-layout |
| description | 信息设计与版式方法。适用于 artifact_type 为 document/deck/visual，当产物需要信息层级、阅读路径、构图、媒介适配，或提到"版式""排版""信息架构" |
Content Layout — 信息设计与版式
入口/出口
- 入口: 内容草稿已存在，且 design 已明确版式方向；或当前任务是纯执行型版式落地
- 出口: 信息层级清楚、阅读路径稳定、符合媒介和导出规格的版式或视觉稿
- 指向: 内容问题 →
build-content-writing；视觉审查 → verify-visual-review
- 前置加载: CANON.md
- 输出路径: verify-visual-review（visual 产物）/ verify-content-review（document 产物）
角色定位
你是信息设计师，不是装饰师。你的职责是把内容组织成读者能快速理解的视觉结构。
长期角色边界：
- 版式执行者：把已批准的信息设计落到页面、幻灯片、视觉画布或导出规格
- 不做：在 build 阶段重开版式方向探索、用装饰掩盖结构问题、靠缩小字号硬塞内容
何时不使用
- 只修改纯文本内容，不涉及排版或视觉呈现
- 纯软件后端功能，无用户可见界面或交付物
- 用户提供了不可修改的模板且只允许填充内容
Iron Law
信息层级先于视觉形式。布局如果没有让读者更快看懂，就不是设计，是噪音。
核心原则
- Hierarchy First — 先决定谁最重要，再决定字号、位置、颜色。
- Gestalt Grouping — 用接近、相似、连续、图底关系组织信息。
- One Primary Path — 每页、每屏或每个视觉稿只能有一条主阅读路径。
- Medium Changes Meaning — 打印、投屏、移动端、社媒图片的版式标准不同。
- Export Is Part of Layout — 最终格式会改变字体、间距、图片和分页，必须提前验证。
决策框架
按这个顺序做版式决策：
使用场景 → 信息优先级 → 分组关系 → 阅读路径 → 视觉系统 → 导出规格
| 决策点 | 判断问题 | 选择规则 |
|---|
| 使用场景 | 读者在哪里看？阅读还是演示？ | 场景决定密度和字号 |
| 信息优先级 | 第一眼必须看到什么？ | 只能有一个主焦点 |
| 分组关系 | 哪些内容属于一组？ | 相关内容靠近，相同类型保持相似 |
| 阅读路径 | 眼睛如何移动？ | 从主张到证据到行动 |
| 视觉系统 | 字体、颜色、间距如何复用？ | 少量规则重复使用 |
| 导出规格 | 最终格式是什么？ | 以最终格式反推尺寸和安全边距 |
流程
Step 1：读取媒介约束
确认：
- 交付格式：DOCX、PDF、PPTX、PNG、SVG、网页截图等
- 画布尺寸、页边距、字体、品牌色、图片规格
- 使用场景：阅读、汇报、打印、投屏、社媒、交付归档
- 必须保留的模板元素
Step 2：建立信息层级
把内容分成四层：
- 主焦点 — 读者第一眼必须理解的结论
- 支撑信息 — 帮读者相信主焦点的证据
- 辅助信息 — 标签、说明、来源、备注
- 可移除信息 — 不影响理解的细节
Step 3：用 Gestalt 组织版面
- 接近：相关内容靠近，不相关内容拉开
- 相似：同类元素保持相同样式
- 连续：阅读路径顺着自然方向移动
- 图底：主体和背景有清晰区分
Step 4：按产物类型落地
| artifact_type | 版式重点 | 判断标准 |
|---|
document | 标题层级、段落间距、表格图注、页眉页脚 | 可长时间阅读，可打印，可引用 |
deck | 一页一个中心消息，投屏可读，speaker notes 承接细节 | 观众 3 秒内知道这一页讲什么 |
visual | 构图、对比、品牌一致、尺寸规格 | 缩略图和实际尺寸都能看懂 |
反模式修复表
| 反模式 | 诊断 | 修复动作 |
|---|
| 页面过载 | 主焦点不清，所有内容都想被看见 | 删除、拆页、移入附录或备注 |
| 文本硬塞 | 靠缩小字号解决空间问题 | 压缩内容或改变结构，不牺牲可读性 |
| 分组混乱 | 相关内容分散，不相关内容靠太近 | 先画分组，再调整距离 |
| 样式随机 | 每页都有新颜色、字号、图标 | 建立小型样式系统并重复使用 |
| 对齐松散 | 元素边界没有共同轴线 | 选定栅格或主要对齐线 |
| 导出错位 | 编辑界面正常，最终文件异常 | 以最终格式检查并调整安全边距 |
好/坏示例
坏：
一页 PPT 同时放：完整背景、三段分析、两张图、四个结论、一个行动项。
问题：没有主焦点，观众不知道先看哪里。
好：
标题：首次配置是新用户流失主因
主体：一张漏斗图
注释：42% 停在权限配置页
行动：先解释授权收益，再请求权限
优点：主张、证据、行动形成一条阅读路径。
验证证据
记录：
- 源文件路径
- 预览或截图路径
- 目标导出格式和尺寸
- 使用场景
- 已知限制
- 主要版式取舍
验证失败处理
| 失败场景 | 处理方式 |
|---|
| 内容太多放不下 | 回到 build-content-writing 压缩、拆分或移入附录 |
| 主焦点混乱 | 降低次要元素权重，只保留一个主焦点 |
| 导出后错位 | 调整固定尺寸、图片比例、字体和安全边距后重新导出 |
| 品牌约束缺失 | 使用保守默认样式，并记录假设 |
| Gestalt 分组无法满足内容结构 | 回到信息层级重新排序，必要时调整内容结构而非版式规则 |
常见说辞
| 说辞 | 现实 | 后果 |
|---|
| “内容对了，丑一点没关系” | 版式差会降低理解效率，也会削弱可信度。 | 读者理解时间增加 ≥ 2x，可信度评分下降 ≥ 30% |
| “PPT 多放点信息显得充实” | 信息密度过高等于没有重点。 | 观众 3 秒内找不到核心消息，汇报效果归零 |
| “视觉稿看起来差不多” | 差不多通常意味着没有对齐、间距和层级标准。 | 缺乏标准导致后续页面不一致，全量返工 ≥ N 页 |
| “导出最后再看” | 导出问题越晚发现，返工越大。 | 导出错位在发布前才发现，修复成本 ≥ 重做整个版式 |
红旗 — STOP
- 没有明确画布或导出格式
- 一页/一屏有多个主焦点
- 文本靠缩小字号硬塞
- 图片被拉伸或裁切掉关键信息
- 对齐和间距没有一致规则
- 导出前没有实际预览
输出模板
版式完成后应产出以下结构（记录于验证证据中）：
### Content Layout 交付记录
**产物类型**: [document / deck / visual]
**使用场景**: [阅读 / 汇报 / 投屏 / 社媒 / 打印]
**交付格式**: [PDF / PPTX / DOCX / PNG / SVG]
**画布尺寸**: [宽 x 高，单位]
**信息层级**:
1. 主焦点: [一句话核心结论]
2. 支撑信息: [2-3 条关键证据]
3. 辅助信息: [标签、来源、备注]
4. 可移除信息: [已移入附录或备注的细节]
**版式规则**:
- 对齐线: [左对齐 / 栅格系统]
- 字号层级: [H1 / H2 / body / caption]
- 间距标准: [段间距 / 组间距 / 页边距]
- 导出验证: [已检查 / 待检查]
**已知限制**: [字体兼容 / 分页问题 / 图片规格限制]
验证清单
