figure-table-description
星标10
分支14
更新时间2026年5月13日 21:03
图表描述补充（为缺少描述的图/表生成或提示合适的中文描述）。
安装
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
SKILL.md
readonly来源
下载
相关职业SOC
基于 SOC 职业分类
菜单
图表描述补充（为缺少描述的图/表生成或提示合适的中文描述）。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
图表自动编号（为 Markdown 文档中的图与表生成统一编号并同步交叉引用）。
修复 svgbob/bob 绘图中 CJK（中文/日文/韩文）字符导致的竖线对齐问题。Use when: 编写或修复 ```bob 代码块中含中文的 ASCII 图、检查竖线 │ 对齐、计算混合字符串显示宽度、排查 svgbob 渲染错位。
svgbob/bob 绘图严格语法规则。Use when: 生成 ```bob 代码块、编写 svgbob ASCII 图、需要在图中显示代码标识符/函数名/路径/括号/下划线/斜杠等编程符号。DO NOT USE FOR: 普通 markdown 文本、不含编程符号的纯文本框图。
| name | figure-table-description |
| description | 图表描述补充（为缺少描述的图/表生成或提示合适的中文描述）。 |
| argument-hint | 可选：指定章节或启用自动占位标记 |
bob/plantuml/mermaid 代码块、<img>、![]()）或表（Markdown 管道表格）后缺少描述性段落**图 X-Y** 或 **表 X-Y** bold 行描述为空或过于笼统audit_chapters.py 报告"图表后缺少描述"时的修复以下情况判定为"缺少描述"：
、<img ...>）之后同理**图/表 X-Y** bold 行的描述部分为空（如 **图 1-1** 仅有空格）排除：以下不算"缺少描述"：
根据图类型调整描述风格：
| 图类型 | 描述重点 |
|---|---|
| bob（框图） | 系统架构、模块关系、信号流向 |
| plantuml（时序/流程） | 执行步骤、消息传递、判断逻辑 |
| mermaid（示意图） | 逻辑结构、组件关联、数据流 |
| 图片（照片/截图） | 实物外观、界面操作、实验现象 |
示例（bob 框图）：
上图展示了 STM32 最小系统的硬件架构。MCU 核心通过总线连接电源管理、时钟系统、
复位电路和调试接口四大模块，各模块的供电与信号路径在图中清晰标注。
示例（plantuml 时序图）：
上图描述了 I2C 通信的完整时序：主机发起起始条件后，依次发送设备地址和寄存器地址，
从机在每个字节后返回 ACK 应答，最终主机以停止条件结束传输。
根据表格内容类型调整：
| 表类型 | 识别特征 | 描述重点 |
|---|---|---|
| 对比表 | 列头含"方案/类型/区别"，≥3 列 | 各方案在哪些维度有差异，如何选型 |
| 参数表 | 列头含"参数/值/单位" | 关键参数的含义和典型取值 |
| 步骤表 | 列头含"步骤/阶段/顺序" | 流程要点和注意事项 |
| 排障表 | 列头含"问题/错误/解决" | 常见问题的排查思路 |
| 参考表 | 其他 | 表格梳理了哪些核心信息 |
示例（对比表）：
上表对比了轮式、履带式和足式三种移动机构的承载能力、地形适应性和控制复杂度，
工程选型时应根据实际工作环境和成本预算综合权衡。
**图/表 X-Y** 后的描述应为一句话概括，不超过 40 字：
**图 3-5** STM32F103 最小系统电路原理框图**图 3-5** 上图以框图形式描绘了系统架构（套话，无信息量）**图 3-5** （空描述）使用审计脚本检测：
python scripts/audit_chapters.py
或手动搜索空 bold 行：
grep -n '^\*\*[图表].*\*\*\s*$' docs/*.md
按上述规范撰写描述，插入到图/表之后（标题之前）。
如果 **图/表 X-Y** 的描述为空，同时填入一句话概括。确保同步更新对应的 <!-- fig/tab:chX-Y 描述 --> marker 行。
python scripts/audit_chapters.py
python -m mkdocs build --strict
python scripts/auto_number_figures_tables.py --toc<!-- desc-auto --> 标记<!-- fig:chX-Y ... --> 和 <!-- tab:chX-Y ... --> 是编号系统的锚点，只修改描述文字，不要删除整行