official-doc-figure

name	official-doc-figure
description	新 official-doc-write 架构的图示生成 skill。按 artifact-plan 和图表蓝图生成正式编号图示，优先输出 Mermaid，并把图示嵌入对应 section 正文。
allowed-tools	Read Write Edit Bash

公文图示生成规则（official-doc-figure）

本 skill 只服务新的 /official-doc-write 架构。所有正式稿中的图示都必须经由本 skill 生成或回修，不再使用旧 workspace/figures/ 流程。

输入边界

只能读取：

• project-workspace/<project-slug>/inputs/framework.md
• project-workspace/<project-slug>/inputs/research-report.md
• project-workspace/<project-slug>/inputs/reference-supplement.md
• project-workspace/<project-slug>/context/section-plan.md
• project-workspace/<project-slug>/context/evidence-ledger.md
• project-workspace/<project-slug>/context/traceability-matrix.md
• project-workspace/<project-slug>/context/artifact-plan.md
• .claude/templates/full-research-project-template.md
• .claude/templates/full-research-project-artifact-blueprint.md
• 当前目标 section 正文

不得读取或依赖：

• workspace/plan/
• workspace/outputs/
• workspace/figures/
• research-sources.md
• research-evidence.md
• facts-ledger.md
• 旧 chapter-prompts/
• 外部联网调研

适用范围

当 artifact-plan.md 中某一行满足以下条件时，必须调用本 skill：

• type=图
• required=Yes
• status 为 planned、missing 或需要回修

required_per_task 图示必须按每个 task_id 分别展开，不得用一张总图替代所有任务图。

输出位置

图示必须嵌入对应 section 正文：

project-workspace/<project-slug>/drafts/sections/<section-id>.md

可选同步保存 Mermaid 源文件，便于后续导出 Word 或排版：

project-workspace/<project-slug>/drafts/artifacts/figures/<artifact-id>.mmd

如果保存 .mmd，必须运行：

python scripts/check_mermaid.py project-workspace/<project-slug>/drafts/artifacts/figures/<artifact-id>.mmd

校验失败的图示不得标记为完成。

图示生成流程

1. 在 artifact-plan.md 中定位目标 artifact_id。
2. 根据 template_anchor、artifact_type、output_format 和图表蓝图确定图示类型与插入位置。
3. 从 traceability-matrix.md、evidence-ledger.md 和三份输入抽取节点、层级、流向、输入输出、责任主体和验证关系。
4. 生成正式图题，图题必须以 图X-X 开头。
5. 生成 Mermaid 图源或简明结构图。
6. 将图题和图源嵌入目标 section 的蓝图指定位置。
7. 图示完成后，向主入口报告建议将 artifact-plan.md 中对应行状态改为 embedded。

图型选择

• 总体目标、任务分解、能力模块：优先 flowchart TB 或树状分解图。
• 技术路线、应用流程、验证流程：优先 flowchart LR 或阶段流程图。
• 数据/标准体系、平台架构：优先分层架构图，必要时使用 subgraph。
• 组织架构、协作机制：优先组织结构图或关系图。
• 产业生态、体系版图：优先分层结构图或关系网络图。

强制规则

• 图示必须与 artifact-plan.md 的 template_anchor 和 artifact_type 一致。
• artifact-plan.md 中目标行必须满足 type=图 且 artifact_id 以 图X-X 开头；如果 artifact_id 以 表X-X 开头，必须停止并报告主入口修正计划。
• 图题编号必须与 artifact_id 一致，例如 图4-3 项目整体技术路线图。
• 标题含“表”“清单”“明细”“矩阵”“测算”且实际应为结构化表格时，不得强行生成图示，应报告主入口改由 official-doc-table 处理。
• 图示节点必须使用正式中文术语，避免英文缩写污染；必要英文术语可以保留但不得喧宾夺主。
• 图示不得暴露 task_01、pain_01、FW-001 等内部编号。
• 图示不得编造输入中没有的单位、金额、比例、指标、时间和验证结果。
• 信息不足时，节点可以写 待补充，但不能把 待补充 图示标记为 approved。
• 一张图只表达一个主逻辑，不得把目标、路线、分工、预算混成一张复杂图。
• Mermaid 中 subgraph 与 end 必须各自单独成行。
• 节点文本过长时要拆分节点或使用 <br/> 换行。

正文嵌入格式

推荐格式：

图4-3 项目整体技术路线图

```mermaid
flowchart LR
  A[输入数据] --> B[处理模块]
  B --> C[验证输出]
```

图题前后应有必要的正文承接。不得把所有图示堆到章末或文末。

交接说明

完成后在 agent 回复中说明：

• 已嵌入的 artifact_id
• 对应 section-id
• 使用的 template_anchor
• 图型
• 是否保存 .mmd
• Mermaid 校验结果
• 是否存在 待补充

交接说明不得写入 section 正文。