القائمة
图表自动编号（为 Markdown 文档中的图与表生成统一编号并同步交叉引用）。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
| name | auto-figure-table-numbering |
| description | 图表自动编号（为 Markdown 文档中的图与表生成统一编号并同步交叉引用）。 |
| argument-hint | 可选：--toc/--dry-run/--refs-only |
bob/plantuml/mermaid 代码块、<img> 标签、![]()）和表（Markdown 管道表格）需要统一编号图 X-Y，其中 X 为章号，Y 为该章内图的顺序号（从 1 开始）图 A-1、图 B-2<!-- fig:chX-Y 描述文字 -->
渲染后显示为：
**图 X-Y** 描述文字
表 X-Y，其中 X 为章号，Y 为该章内表的顺序号（从 1 开始）表 A-1<!-- tab:chX-Y 描述文字 -->
渲染后显示为：
**表 X-Y** 描述文字
如图 1-5 所示、见图 A-2参见表 2-3、如表 B-1 所列在图（代码块或图片）下方添加标记行：
<!-- fig: 描述文字 -->
脚本运行后会自动替换为带编号的图说：
**图 1-3** 描述文字
<!-- fig:ch1-3 描述文字 -->
在表 上方添加标记行：
<!-- tab: 描述文字 -->
脚本运行后会自动替换为带编号的表说：
**表 2-1** 描述文字
<!-- tab:ch2-1 描述文字 -->
之前由 insert_placeholders_after_tables.py 插入的 <!-- autoplaceholder --> 会被本脚本识别，并根据上下文自动转换为 <!-- fig: ... --> 或 <!-- tab: ... -->，需要人工补充描述文字。
# 预览模式（只报告，不修改文件）
python scripts/auto_number_figures_tables.py --dry-run
# 执行编号（修改文件）
python scripts/auto_number_figures_tables.py
# 生成图目录和表目录
python scripts/auto_number_figures_tables.py --toc
# 仅更新交叉引用（不重新编号）
python scripts/auto_number_figures_tables.py --refs-only
bob 代码块内部的 | 字符不是表格，脚本已做区分start-at 提取appendix_*.md）使用大写字母作为章号git diff 确认变更范围**图 10-1** 高级运动控制方法总览图），重新编号后描述文字会被保留，不会丢失。编辑者可直接修改 bold 行中的描述文字，脚本会以 bold 行的描述为准。在正文中用自然中文引用图表，脚本能自动识别并更新编号：
如图 1-3 所示，最小系统由电源、时钟、复位等电路组成。
具体参数见表 2-1 中的层次说明。
有关引脚布局的详细信息，参见图 A-2。
脚本识别以下模式（前缀 + 编号）：
图 X-Y 形式，如 图 1-3、图 A-2（X 为章号/字母，Y 为序号）表 X-Y 形式，如 表 2-1、表 B-3常见自然写法均可识别：如图 1-3 所示、见图 1-3、参见表 2-1、如表 2-1 所列、（图 1-3）等。
以下位置的编号不会被替换：
``` 内部）——避免修改示例代码**图 X-Y** / **表 X-Y** bold 标题行——由 Pass 1 管理<!-- fig:chX-Y --> / <!-- tab:chX-Y --> HTML 注释标记行——由 Pass 1 管理图表描述补充（为缺少描述的图/表生成或提示合适的中文描述）。
修复 svgbob/bob 绘图中 CJK（中文/日文/韩文）字符导致的竖线对齐问题。Use when: 编写或修复 ```bob 代码块中含中文的 ASCII 图、检查竖线 │ 对齐、计算混合字符串显示宽度、排查 svgbob 渲染错位。
svgbob/bob 绘图严格语法规则。Use when: 生成 ```bob 代码块、编写 svgbob ASCII 图、需要在图中显示代码标识符/函数名/路径/括号/下划线/斜杠等编程符号。DO NOT USE FOR: 普通 markdown 文本、不含编程符号的纯文本框图。
استنادا إلى تصنيف SOC المهني
