Install
openclaw skills install vkey-bid-standardizerVkey Bid Standardizer
银行投标响应文档标准化工具（v1.0）。基于 Word 样式体系（Heading 1-5 + Normal），兼容 GB/T 9704 公文格式；统一入口 standardize.py，提供 7 条流水线（all/fix/renumber/auto-number/review/convert-md/validate-patterns）。
vkey-bid-standardizer
银行投标响应文档标准化工具。基于 Word 内置样式体系（Heading 1-5 + Normal），把任意 docx 一键整理为符合银行投标规范的成品稿。
核心优势
- 章节统一：5 级编号（1. / 1.1 / 1.1.1 / 1.1.1.1 / 1.1.1.1.1）由 Word 多级列表自动渲染，杜绝编号错位
- 手动编号自动转写：12 种常见形式（一、/（一）/第 X 章/附录 X/1.1 等）→ 跑
renumber一键转阿拉伯层级 - 公文格式兼容：版心、行距、字号、首行缩进严格遵循 GB/T 9704
- 一键 3 步流水线：
all子命令一气呵成——renumber → fix → auto-number - 可审查：每步输出报告，可
dry-run预览改动 - 配置驱动：22 条编号模式入 JSON 配置文件，新增模式不改代码
技能元信息
| 字段 | 值 |
|---|---|
| 技能名称 | vkey-bid-standardizer |
| 行业 | 银行 |
| 配置文件 | vkey_bid_standardizer/profiles/standard.json |
| 流水线数 | 7（all / fix / renumber / auto-number / review / convert-md / validate-patterns） |
| 测试 | pytest tests/ — 61 个 case |
| 依赖 | Python 3.7+ / python-docx 1.x / pytest |
| 适用文档 | 技术应答、商务标书、实施方案、应答偏离表、投标方案 |
1. 概述
1.1 编制目的
为统一银行业投标响应文档（技术应答、商务标书、实施方案等）的格式规范，满足银行招标方评标专家对版面与编号的合规审查要求，提升标书质量与中标率。
本规范遵循的基本原则（金融投标四原则）：
- 合规性：与 GB/T 9704 公文格式、银行投标规范保持一致
- 可追溯性：5 级编号由 Word 多级列表自动生成，便于专家引用（如"详见 3.2 节"）
- 专业性：版心/字号/字体严格遵循公文标准，体现投标方严谨度
- 可操作性：基于 Word 内置样式体系，专家可在 Word 中直接批注/修订
1.2 编制依据
| 序号 | 标准编号 | 标准名称 | 适用要点 |
|---|---|---|---|
| 1 | GB/T 9704—2012 | 党政机关公文格式 | 版心/页边距/字号/行距 |
| 2 | GB/T 15834—2011 | 标点符号用法 | 标点符号全角半角 |
| 3 | GB/T 15835—2011 | 出版物上数字用法 | 数字/百分号/单位 |
| 4 | GB/T 9851—2008 | 印刷字体分类 | 字体别名识别 |
| 5 | JR/T 0067—2017 | 银行信息安全风险管理指引 | 银行业信息安全引用 |
| 6 | JR/T 0071—2014 | 金融行业网络安全等级保护实施指引 | 银行业网络安全引用 |
1.3 术语与定义
| 术语 | 定义 |
|---|---|
| 样式（Style） | Word 中预设的格式集合 |
| 标题样式 | Word 内置 Heading 1-9，标识文档层次 |
| 正文样式 | 菜单栏显示为"正文"的 Normal 样式 |
| 行距 | 段内行与行的垂直距离（倍数或固定值） |
| 段前/段后 | 段落上方/下方的空白距离 |
| 首行缩进 | 段落首行相对左页边距的内缩 |
| 多级列表 | Word 的多级自动编号功能（绑定 Heading 样式） |
| 段级覆盖 | 段落自身 pPr（spacing/ind/jc）覆盖样式定义 |
2. 适用范围
2.1 适用文档类型（银行投标场景）
- 技术应答文件：系统设计方案、技术白皮书、架构图说明、接口规范、应答偏离表
- 商务标书：投标函、报价表、商务偏离表、资质证明、业绩清单
- 实施方案：实施计划、项目组织、质量保证、风险控制、培训方案
- 应答与澄清：评标答疑、技术澄清、商务澄清、补充函
- 银行内部立项材料：总行科技部立项评审、内部方案报备、系统变更说明
2.2 不适用情形
- 非正式的工作备忘、内部草稿、便签类文档
- 已经按客户特定模板要求编制的对外文档（直接套用客户模板，本工具不修改）
- 含有大量特殊排版元素（复杂公式、艺术字、流程图）的文档
3. 文档结构规范
3.1 章节层次体系
文档采用五级章节结构，编号统一带点：
| 层级 | 编号格式 | 样式 | 示例 |
|---|---|---|---|
| 一级章节 | 1. | Heading 1 | 1. 概述 |
| 二级章节 | 1.1 | Heading 2 | 1.1 适用范围 |
| 三级章节 | 1.1.1 | Heading 3 | 1.1.1 子项说明 |
| 四级章节 | 1.1.1.1 | Heading 4 | 1.1.1.1 详细说明 |
| 五级章节 | 1.1.1.1.1 | Heading 5 | 1.1.1.1.1 极详细 |
禁止：使用 一、 （一） 1 概述（无点）等其他格式。
3.2 章节编号约定
- 标题必须用 Word 内置 Heading 样式（不能用普通段落加粗替代）
- 编号与标题文字之间使用半角空格分隔
- 数字编号采用阿拉伯数字，章节顺序 1, 2, 3（最多至 99）
- 跨章节引用用完整编号（如"详见 3.2 节"）
- 金融投标章节常超 9（GB/T 9704 章条编号支持到 999），编号可至 3 位
3.3 手动编号识别
技能支持 12 种常见手动编号形式（一、、（一）、1.1、第 X 章、附录 X 等）→ 跑 standardize.py renumber 自动转阿拉伯层级。详见 附录 B。
4. 页面布局规范
4.1 页边距
| 边距 | 标准值 | 允许偏差 |
|---|---|---|
| 上 | 3.7 厘米 | ±0.1 厘米 |
| 下 | 3.5 厘米 | ±0.1 厘米 |
| 左 | 2.8 厘米 | ±0.1 厘米 |
| 右 | 2.6 厘米 | ±0.1 厘米 |
4.2 纸张与方向
- 纸张规格：A4（21 厘米 × 29.7 厘米）
- 页面方向：纵向
- 特殊场景：表格超宽时可用横向
5. 字体与字号规范
5.1 字体配置
| 元素 | 西文字体 | 中文字体 | 适用 |
|---|---|---|---|
| 标题 | Times New Roman | 黑体 | 标题 1-5 |
| 正文 | FangSong | 仿宋 | Normal 段落 |
| 表头 | Times New Roman | 黑体 | 表格首行 |
| 表内 | FangSong | 仿宋 | 表格数据 |
5.2 字号标准（GB/T 9704 公文格式）
| 元素 | 字号 | 磅数 | 标识 |
|---|---|---|---|
| 正文 | 四号 | 14pt | Normal |
| 一级标题 | 小二号 | 18pt | Heading 1 |
| 二级标题 | 三号 | 16pt | Heading 2 |
| 三级标题 | 小三号 | 15pt | Heading 3 |
| 四级标题 | 四号 | 14pt | Heading 4 |
| 五级标题 | 五号 | 10.5pt | Heading 5 |
| 表格表头 | 五号 | 10.5pt | — |
| 表格内容 | 五号 | 10.5pt | — |
| 页脚 | 五号 | 10.5pt | — |
5.3 颜色
- 标题与正文：黑色（
#000000） - 强调用粗体/下划线，避免颜色（除确有需要）
- 所有颜色保证黑白打印清晰
6. 段落与间距规范
6.1 行距
| 元素 | 类型 | 值 |
|---|---|---|
| 正文 | 固定值 | 20 磅 |
| 标题 1-5 | 倍数 | 1.25 倍 |
6.2 段落间距
| 元素 | 段前 | 段后 |
|---|---|---|
| 一级标题 | 16 磅 | 0 磅 |
| 二级标题 | 14 磅 | 0 磅 |
| 三级标题 | 12 磅 | 0 磅 |
| 四级标题 | 10 磅 | 0 磅 |
| 五级标题 | 8 磅 | 0 磅 |
| 正文 | 0 磅 | 0 磅 |
6.3 缩进与对齐
- 首行缩进：正文段落 2 字符 = 2 × 字号 = 28 磅（4 号字 14pt × 2）
- 对齐：左对齐（避免两端对齐的字间距不均）
OOXML w:ind 字段单位（必须严格区分，否则 Word 显示与渲染不一致）：
| 字段 | 单位 | 2 字符示例 | 说明 |
|---|---|---|---|
w:firstLine | 1/20 pt（twips） | 560 | 28pt = 560 twips；用于渲染 |
w:firstLineChars | 1/100 字符 | 200 | 2 字符必须写 200，不是 2；用于对话框"度量值"显示 |
w:left | 1/20 pt（twips） | 0 | 段落左缩进 |
w:leftChars | 1/100 字符 | 0 | 段落左缩进（字符单位） |
w:hanging / w:hangingChars | 同上 | — | 悬挂缩进 |
常见陷阱：python-docx 设
Pt(22.4)时只写w:firstLine为 twips 值，不写w:firstLineChars；Word 对话框"度量值"读firstLineChars显示为字符数，缺省时显示 0/1 字符。apply_paragraph_format必须同时写两字段并保持换算一致（firstLineChars = first_line_chars × 100）。
- 标题不缩进，左对齐于页边距
7. 表格规范
| 元素 | 字体 | 字号 | 对齐 |
|---|---|---|---|
| 表头 | 黑体 | 10.5pt | 居中 |
| 表内 | 仿宋 | 10.5pt | 左对齐 |
边框：外框 1.5 磅、内框 0.5 磅、黑色 #000000
表头底纹：浅灰 #D9D9D9（仅首行）
列宽：自动列宽，按内容比例分配
7.1 表格段落缩进（强制要求）
- 表格内段落不得继承正文 Normal 样式的首行缩进（GB/T 9704 公文规范不要求表格内容缩进）
- 必须在每个
w:tc > w:p的段级w:pPr强制写入w:ind，阻断样式继承链：
<w:pPr>
<w:ind w:firstLine="0" w:firstLineChars="0"/>
</w:pPr>
陷阱：仅
del现有w:firstLine属性无法阻断"无 w:ind 元素"的段落（会继承 Normal 样式）。必须get_or_add_pPr()+get_or_add_w:ind()显式构造——对应pipeline.py::_fix_tables中"强制段级 firstLine=0"逻辑。
8. 页脚规范
金融投标页脚默认居中页码，可按需扩展为「项目编号 + 页码」或「招标编号 + 页码 + 总页数」。
| 属性 | 标准值 |
|---|---|
| 字体 | 仿宋 10.5 磅（五号） |
| 对齐 | 居中 |
| 位置 | 页底 |
| 起始页码 | 1 |
| 格式 | 页码（默认）/ 项目编号 - 页码（可配） |
模板与
standard.json::footer.text字段联动。如需项目编号-页码格式，编辑footer.text为{project_code} - {page}（v1.0 占位符占位，v1.1 将完整支持）。
9. 使用指南
9.1 推荐入口
v1.0 唯一 CLI 入口是顶层 standardize.py：
# 全流水线（推荐）
python standardize.py all input.docx -o output.docx
# 单步
python standardize.py fix input.docx
python standardize.py renumber input.docx
python standardize.py auto-number input.docx
python standardize.py review input.docx
python standardize.py convert-md input.md
python standardize.py validate-patterns
通用 flag：--profile standard（默认；bid 是别名）/ --dry-run / --backup / -v / -o
9.2 流水线总览
| # | 名称 | 命令 | 作用 |
|---|---|---|---|
| 1 | 全流水线 | standardize.py all | renumber → fix → auto-number 三步串行 |
| 2 | 修复样式 | standardize.py fix | 应用规范 + 清段级/run 级覆盖 |
| 3 | 重编号 | standardize.py renumber | 手动编号（一、/（一）/1.1）→ 阿拉伯层级 |
| 4 | 自动编号 | standardize.py auto-number | Heading 1-5 绑 Word 多级列表 |
| 5 | 审查 | standardize.py review | JSON 审计报告（段级覆盖、issues） |
| 6 | MD→docx | standardize.py convert-md | 从 Markdown 源生成 |
| 7 | 模式校验 | standardize.py validate-patterns | 22 条模式样本测试 |
9.3 典型应用场景
场景一：技术应答文件标准化
python standardize.py all 银行核心系统技术应答_v1.0.docx -o 银行核心系统技术应答_v1.0_标准化.docx
跑完 3 步：手动编号（一、/（一）/1.1）→ 阿拉伯层级 → 套用 GB/T 9704 公文样式 → 绑 Word 多级列表。
场景二：先 dry-run 看会改什么，不写文件
python standardize.py all 银行核心系统技术应答_v1.0.docx --dry-run
只输出计划（如 renumber (62) | fix (1756) | auto-number (5)），不写任何文件——评标前安全预览改动。
场景三：投标合规审查
python standardize.py review 银行核心系统技术应答_v1.0_标准化.docx
输出 JSON 报告：overrides 全为 0 + issues: [] 即符合公文规范。
场景四：备份原文件再修复（防止覆盖）
python standardize.py all 银行核心系统技术应答_v1.0.docx -o 银行核心系统技术应答_v1.0_标准化.docx --backup
自动把原文件备份为 银行核心系统技术应答_v1.0.docx.bak。
场景五：从 Markdown 起草金融投标稿
python standardize.py convert-md 银行核心系统技术应答.md -o 银行核心系统技术应答_v1.0.docx
按附录 C 的 Markdown 规范写，5 级章节 + 表格 + 段落直接转成标准 docx。
10. 质量保证
10.1 审查清单
| 维度 | 通过标准 |
|---|---|
| 样式使用 | 标题用 Heading 1-5，正文用 Normal |
| 字体 | 标题黑体，正文仿宋，色 #000000 |
| 间距 | 行距 1.25 倍 / 固定 20 磅；段前段后符合规范 |
| 表格 | 表头黑体 10.5pt 灰底，表内仿宋 10.5pt |
| 页脚 | 仅页码数字 |
| 编号 | 标题具备 1./1.1/1.1.1 层级 |
| 段级覆盖 | 所有 Heading/Normal 段落无 pPr 覆盖（overrides 全为 0） |
10.2 合规判定
- 完全合规：
issues空 +overrides全 0 - 基本合规：仅有模式 warning（需手动添加未识别编号）
- 不合规：存在段级覆盖或样式错乱，跑
standardize.py fix修复
11. 配置管理
11.1 配置文件
规范通过 vkey_bid_standardizer/profiles/standard.json 集中管理，含 9 个节：
| 节 | 作用 | 金融投标关注点 |
|---|---|---|
page | 页面边距 | GB/T 9704 版心 156×225mm |
body | 正文样式 | 三号仿宋 + 28 磅固定行距 |
headings | 5 级标题样式 | 黑体 + 1.5 倍行距 |
tables | 表格样式 + 边框 | 灰底表头 + 1.5/0.5 磅框 |
footer | 页脚配置 | 居中页码 / 项目编号-页码 |
numbering | Word 多级列表 | 1./1.1/1.1.1 层级 |
patterns | 22 条手动编号识别 | 中文 / 第X章 / 附录 |
color | 颜色（#000000） | 黑白打印兼容 |
metadata（v1.1） | 项目元数据 | 招标编号 / 项目名称 / 投标类型 |
bid.json 是 standard.json 的别名（找不到时自动 fallback）。调整规范改 standard.json 而非源代码。
11.2 模板文件
| 模板 | 路径 | 用途 |
|---|---|---|
| 标书空白模板 | templates/bid_blank.md | Markdown 金融投标起草（convert-md 输入源） |
11.3 依赖
- Python 3.7+
- python-docx 1.x（
pip install python-docx） - Word 2016+ / WPS Office 2019+
12. 系统要求
| 组件 | 最低版本 | 备注 |
|---|---|---|
| Python | 3.7+ | 推荐 3.10+ |
| python-docx | 1.0+ | pip install python-docx |
| pytest | 7.0+ | 仅运行测试时需要 |
| Microsoft Word | 2016+ | 需支持多级列表 |
| WPS Office | 2019+ | 兼容多级列表 |
安装依赖：
pip install python-docx pytest
13. 自定义模式教程
13.1 何时需要
如果客户 docx 用了非标准编号形式（不在 12 种内置模式里），renumber 会输出 warning：
[Heading 3] 未识别编号: §3.1 系统架构
13.2 添加步骤
Step 1：分析样本
从 docx 复制一段未识别的标题，如 §3.1 系统架构。
Step 2：写正则，加到 standard.json::patterns::h3
{
"name": "section_sign",
"pattern": "^§(\\d+)\\.(\\d+)\\s+(.*)$"
}
pattern 规则：第一个捕获组必须是编号。
Step 3：标注解析模式
如果编号含中文数字，加 "cn_to_int": true：
{
"name": "part_cn",
"pattern": "^第([一二三四五六七八九十百]+)部分\\s+(.*)$",
"cn_to_int": true
}
或混合（中/阿）："mixed_cn_int": true。
Step 4：模式顺序
更具体的模式放前面（避免被通用模式抢先匹配）。例如 wps_label 必须在 single_arabic 之前。
Step 5：验证
python standardize.py validate-patterns
如样本测试不通过，输出会指明问题。
13.3 字段参考
| 字段 | 必填 | 说明 |
|---|---|---|
name | ✓ | 模式名（英文，warning 输出用） |
pattern | ✓ | 正则，第一个捕获组必须是编号 |
cn_to_int | 第一组是中文数字（用 parse_cn_num） | |
mixed_cn_int | 第一组是混合数字（1 或 三） |
14. 修订历史
| 版本 | 日期 | 修订人 | 内容 |
|---|---|---|---|
| V1.0 | 2026-06-03 | vkey-bid-standardizer | 首次独立发布；统一入口 standardize.py；7 条流水线；22 条编号模式；61 个 pytest case；单一真相源 standard.json |
| V1.0.1 | 2026-06-04 | vkey-bid-standardizer | 修复 3 项 OOXML 规范偏差：① firstLineChars 单位误用（改 ×100）；② firstLine 增补 twips 兜底（28pt = 560）；③ 表格段落强制段级 firstLine=0 阻断 Normal 样式继承 |
附录 A 配置文件
vkey_bid_standardizer/profiles/standard.json 是规范的唯一真相源。
完整结构（请直接读源文件）：
# 查看完整 JSON
cat vkey_bid_standardizer/profiles/standard.json
# 关键字段速查
python -c "from vkey_bid_standardizer import load_profile; p = load_profile('standard'); print(p['headings'])"
不要在 SKILL.md 里复制完整 JSON——配置可能演化，文档与代码脱钩后维护成本高。
附录 B 编号模式清单
standard.json::patterns 共 22 条正则规则，覆盖 12 种常见多级编号形式。
| 模式名 | 层级 | 形式 | 示例 |
|---|---|---|---|
chinese_punct | H1 | 一、 二、 | 一、概述 |
chapter_cn | H1 | 第X章（中文） | 第十章 总则 |
chapter_arabic | H1 | 第N章 | 第3章 术语 |
appendix_cn | H1 | 附录X | 附录A 数据 |
appendix_alpha | H1 | Appendix X | Appendix A Data |
single_arabic | H1-H5 | 1. 2. | 1. 总则 |
circle_num | H1 | ①②③ | ① 条款 |
cn_paren_both | H2 | （一） 或 (一) | （一）适用范围 |
section_cn | H2 | 第X节 | 第一节 概述 |
dot_arabic | H2 | 1.1 | 1.1 范围 |
wps_label | H2/H3 | 1. 标题 1 | 1. 标题 1 |
arabic_paren | H3-H5 | （1） 或 (1) | （1）数据采集 |
article_cn | H3 | 第X条 | 第一条 范围 |
dot_triple | H3 | 1.1.1 | 1.1.1 概述 |
dot_quad | H4 | 1.1.1.1 | 1.1.1.1 详细 |
dot_quint | H5 | 1.1.1.1.1 | 1.1.1.1.1 极详细 |
模式顺序很重要——更具体的模式放前面（避免被通用模式抢先匹配）。
失败降级：未匹配段落原样保留 + warning。
正则源在
standard.json::patterns，不要在 SKILL.md 里复制正则——配置可能演化。
附录 C Markdown 编写规范
适用于 standardize.py convert-md 流水线的 Markdown 源文件。
约定：
# 文档标题仅用于首行大标题（居中加粗、黑体 18pt），独立成段，不进入目录## 1. 章节名才是正文章节起点（对应 Heading 1）- 不要省略文档标题——脚本按 Markdown 层级顺序解析
| Markdown 语法 | Word 样式 |
|---|---|
# 文档标题 | Normal 段落（居中加粗，黑体 18pt） |
## 1. 章节名 | Heading 1 |
### 1.1 子章节 | Heading 2 |
#### 1.1.1 三级 | Heading 3 |
##### 1.1.1.1 四级子项 | Heading 4（独立成行） |
###### 1.1.1.1.1 五级子项 | Heading 5（独立成行） |
| 表头 | | 表格（1.5pt 外框 + 0.5pt 内框） |
要求：标题独立成行 / 表格用标准 Markdown / 不使用代码块 / 列表项末尾加句号。