插图目录模板(diagram-catalog)
本文件是 per-book 配置。使用本 skill 前,先按以下格式创建你的书籍插图目录。
工作方式:Phase 1 分析章节时读取此文件,匹配当前章节的预定义插图,结合章节内容识别额外配图机会。
格式定义
每条插图包含以下字段:
| 字段 | 必填 | 说明 | 示例 |
|---|---|---|---|
| # | 是 | 全书统一编号 | 1、G1(全书级) |
| 位置 | 是 | 章节小节编号或描述 | 6.1、附录 |
| 类型 | 是 | 布局模板名(见 layout-templates.md) | flow、layer、matrix、hub、tree、cycle,或组合如 flow+matrix |
| 描述 | 是 | 插图要表达的核心内容 | "识别→梳理→编写→验证→迭代的五步流程" |
| 优先级 | 是 | P0 核心 / P1 重要 / P2 辅助 | P0 |
| 备注 | 否 | 生成注意事项 | "需突出数据对比"、"参见大纲论证链" |
优先级说明
| 级别 | 含义 | 典型密度 |
|---|---|---|
| P0 | 核心插图,必须完成。表达全书关键概念或方法论。 | 每章 0-2 张 |
| P1 | 重要插图,建议完成。覆盖关键对比、流程、架构。 | 每章 1-3 张 |
| P2 | 辅助插图,按需完成。补充说明或装饰性。 | 按需 |
组合模板
标注为 flow+matrix 等组合类型的插图,参见 layout-templates.md 的"组合模板"章节。
如何创建插图目录
步骤 1:通读书籍大纲
阅读全书大纲或目录,标记以下位置:
- 架构描述("X 层"、"体系"、"架构")
- 流程描述("步骤"、"流程"、"阶段")
- 对比描述("vs"、"对比"、"前后")
- 层次描述("层级"、"分类"、"金字塔")
- 循环描述("循环"、"迭代"、"闭环")
- 生态/关系描述("生态"、"关系"、"要素")
步骤 2:按章填写表格
为每个标记的位置创建一条插图记录。按以下格式:
### chXX 章节名
| # | 位置 | 类型 | 描述 | 优先级 |
|---|------|------|------|--------|
| 1 | X.1 子节名 | flow | 简要描述图要表达什么 | P0 |
| 2 | X.2 子节名 | matrix | 简要描述 | P1 |步骤 3:标注优先级
- 方法论核心图、全书贯穿概念图 → P0
- 重要流程、对比、架构 → P1
- 补充说明、装饰性 → P2
步骤 4:控制密度
每章 3-8 张。如果某章超过 8 张,将优先级最低的降级或合并。
模板示例
以下是一个虚构的技术书籍插图目录片段,展示完整格式:
### ch03 系统架构设计
| # | 位置 | 类型 | 描述 | 优先级 | 备注 |
|---|------|------|------|--------|------|
| 9 | 3.1 架构概览 | layer | 表现层→服务层→数据层的三层架构 | P0 | 本章核心图 |
| 10 | 3.2 微服务通信方式 | matrix | 同步 vs 异步通信对比 | P1 | |
| 11 | 3.3 服务注册发现流程 | flow | 注册→心跳→发现→调用的线性流程 | P1 | |
| 12 | 3.4 全链路监控闭环 | cycle | 采集→聚合→告警→处理的闭环 | P2 | |