ipo-doc-formatting

在写 Word 或改 Word 文件时，按招股书 / 审核问询反馈回复的样式要求应用格式（报告/备忘录/尽调等正式文档同归招股书版 000-009）。触发词：「按招股书样式」「招股书格式」「招股书排版」「招股书章节样式」「把这篇改成招股书格式」「这篇按招股书排一下」「按反馈回复样式」「问询回复格式」「反馈回复排版」「反馈回复排版规范」「落实函格式」「套用 000-009 样式」「套 000-009」「报告模板样式」「套模板样式」「把这个 Word 改成XXX格式」「Word 排版规范」「按投行规范排版」「排版规范一点」「文档格式统一」。核心流程：识别文档类型→加载样式模板（assets/templates/ 下报告模板.docx / 反馈回复样式.docx，模板即样式源可自定义）→路由底层工具（tencent-docx 新建 / minimax-docx apply-template 套样式 / tencent-local-office-edit 局部微调，不可用则脚本兜底并标注局限）→应用样式映射（000-009 体系、反馈回复 0011/001 监管问题黑体、标题序号九级链、表格三线表）→校验门禁（样式完整性 + 空段落检测）。与 ipo-write-response 分工：本 skill 管格式层（排版/样式），内容层方法论见 ipo-write-response。

A股 IPO 文档样式应用（2026-08-25 创建，封装专家团「报告样式规范」资产）。核心：把「招股书版（000-009，含报告/备忘录/尽调等正式文档） / 审核问询反馈回复版（0011/001/000-009）」两套文档的样式体系知识（模板路径、pStyle 映射、序号规则、表格规则）集中封装，并在写 Word / 改 Word 时路由到底层工具执行。管格式，不管内容。

何时使用

用户要求给 Word 应用 / 修改以下任一排版要求时，无条件触发：

场景	触发词示例
招股书样式（含报告/备忘录/尽调等正式文档）	「按招股书样式」「招股书格式」「招股书排版」「招股书章节样式」「按招股书章节格式写」「把这篇改成招股书格式」「这篇按招股书排一下」「套用 000-009 样式」「套 000-009」「报告模板样式」「按报告模板」「套模板样式」「应用报告样式」
反馈回复样式	「按反馈回复样式」「按问询回复格式」「反馈回复排版」「反馈回复排版规范」「问询函回复格式」「落实函格式」「审核问询回复格式」「按问询函格式排版」
通用排版要求	「把这个 Word 改成 XXX 格式」「排版规范」「按投行规范排版」「字体字号统一」「排版规范一点」「文档格式统一」
局部样式调整	「标题改成黑体」「正文首行缩进」「表格改成三线表」「单位行右对齐」

若任务同时含「写反馈回复内容」→ 内容方法论走 ipo-write-response，本 skill 只负责生成后的样式落地；两者可串联（先写内容、再套样式）。 典型用例（触发→执行→产出 全链路示例）见 references/examples.md。

样式资产索引（先加载，禁止裸写）

模板文件路径（skill 自带，即样式源）：assets/templates/（相对本 skill 目录） 模板即样式源（2026-08-25 共享化改造）：使用者可直接修改/替换 assets/templates/ 下的 docx——改模板 = 定制输出样式，输出将跟随新模板。 原权威源（专家团资产，模板更新时以权威源为准回同步）：C:/Users/Kian_/.workbuddy/plugins/marketplaces/my-experts/plugins/ipo-doc-team/references/templates/

模板文件	适用文档	样式体系	关键样式 ID
报告模板.docx	招股书章节 / 报告 / 备忘录 / 尽调报告等正式文档	招股书版 000-009	000 正文、001 一级标题、002-007 二级至七级标题、008 单位、009 备注
反馈回复样式.docx	审核问询回复 / 反馈回复 / 落实函回复	反馈回复版（000-009 + 0011/001）	0011 一级标题（问题编号）、001 问题正文（监管问题黑体）、000 正文、002-009 明细层级
表格模板.docx	以上全部文档的表格	三线表	报告表格 a6、表格前单位 a5、表格后说明 a4

完整样式定义（每种样式的字体/字号/对齐/缩进/间距/行距/大纲级别）见 references/style-map.md。

场景识别与工具路由（决策树）

text

用户请求（写 word / 改 word + 样式要求）
│
├─ 场景A：已有 docx，整套套用样式 ──→ minimax-docx apply-template
│     （source=用户文件, template=对应模板, output=新文件）
│
├─ 场景B：新建 docx（从模板基底填充）──→ tencent-docx 专业创作
│     （创作时声明按 000-009 样式生成；或 minimax-docx create --template）
│
├─ 场景C：局部调整（某段/某表改样式）──→ tencent-local-office-edit 实时编辑
│     （唯一编辑中枢，按 style-map.md 手动应用 pStyle / 直接改格式）
│
└─ 场景D：生成后校验样式 ──→ scripts/check_styles.py
      （统计 pStyle 分布 + 检查必备样式是否应用）

工具调用顺序（与 writer 工具链一致）：

1. 新建创作 → tencent-docx（首选）；失败降级 minimax-docx create
2. 已有文件整套套样式 → minimax-docx apply-template（实测通过，XSD 校验门禁防损坏）
3. 局部微调/改段落样式 → tencent-local-office-edit（唯一编辑中枢）
4. 样式校验 → 本 skill 自带脚本 scripts/check_styles.py

失败降级协议（2026-08-25 用户裁定：脚本兜底 + 标注局限）：

失败场景	默认降级	交付说明
tencent-docx 不可用	minimax-docx create	注明降级方案
minimax-docx 不可用	脚本兜底：以 assets/templates/ 对应模板为基底（复制 styles.xml 等部件），仅替换 document.xml（段落 pStyle + 三线表）	注明「脚本兜底生成」；覆盖不了的元素（封面/TOC/页眉页脚/页码/图片/修订）列出清单标注「待人工处理」
局部编辑工具不可用	脚本直接修改 document.xml 的样式字段	注明降级；编辑器同步风险提示
文档含脚本兜底覆盖不了的元素（封面/TOC/图片等）	不硬撑——输出 Markdown + 样式应用说明	注明非最终形态，建议走专业工具
校验门禁未过	返回 S4/S5 修正后重跑	门禁结果摘要（必备样式/裸段落/空段落/跳级）

执行流程（S1-S7）

S1 识别样式场景

• 用户明确指定（招股书版 / 反馈回复版）→ 直接采用
• 未明确 → 按文档类型推断：含"问题X."编号或【发行人说明】【中介机构核查】→ 反馈回复版；其余正式文档（含"第一节/第二节"、业务与技术、报告、备忘录等）→ 招股书版（000-009）

S2 加载样式资产

• 读 references/style-map.md 对应样式体系表
• 确认模板 docx 存在（ls 检查，中文文件名注意编码）
• 新建场景：确定是「以模板为基底填充」还是「从零生成后按表设置」

S3 工具路由

• 按上文决策树选择工具；调用前 ToolSearch 加载 skill / 工具 schema
• minimax-docx 环境备忘：依赖 .NET SDK 8 + 华为云 NuGet 镜像；apply-template 前先 dotnet restore MiniMaxAIDocx.Cli/MiniMaxAIDocx.Cli.csproj --source https://repo.huaweicloud.com/repository/nuget/v3/index.json

S4 样式映射（核心）

按 references/style-map.md 将内容段落映射到 pStyle：

内容类型	招股书版 pStyle（含报告类文档）	反馈回复版 pStyle
章 / 问题编号标题	001（第一节 XXX，居中分页前）	0011（问题1.XXX，两端对齐）
监管问题原文	—	001（黑体缩进，问题正文）
正文段落	000	000（首行缩进2字符1.5倍行距）
二级标题	002（一、）	002（一、，加粗）
三级标题	003（（一））	003（（一），加粗）
四级标题	004（1、）	004（1、，加粗）
五级标题	005（（1））	005（（1），加粗）
六级标题	006（1））	006（1），默认）
七级标题	007（①）	007（①，默认）
表格前单位行	008（右对齐五号）	008（右对齐五号）
表格后备注行	009（五号首行缩进）	009（五号首行缩进）
表格	报告表格 a6	报告表格 a6

S5 标题序号 + 表格规则

• 标题序号九级链 + 「序号前缀≠标题」判定 → references/rules.md 第一节
• 表格三线表规范（框线/字号/对齐/tblHeader/合计加粗）→ references/rules.md 第二节

S6 校验门禁

• 成品文档校验：python scripts/check_styles.py --input <docx或目录> --scenario <招股书|反馈回复>（报告 为 招股书 别名，兼容旧调用；默认 --mode document）
• 模板/样式库校验：--mode template（检查 styles.xml 中 000-009 / 0011+001 / a4-a6 是否齐全；模板正文为空属正常，勿用 document 模式误判）
• 检查项：必备样式已应用（000 + 场景一级：招股书 001 / 反馈回复 0011+001）、无裸正文段落、无空段落（2026-08-25 裁定：段落间禁止空行）、标题层级无跳级
• minimax-docx apply-template 自带 XSD 校验门禁（防损坏）
• 任一不符 → 返回 S4/S5 修正后重跑，不交付

S7 交付与声明

• 交付物路径 + 样式应用情况声明（"已按招股书版 000-009 样式生成/套用" 或 "已按反馈回复版样式套用"）
• 若从零生成，必须声明"已按报告模板 000-009 样式生成"
• 样式未全覆盖处列出清单（哪些段落待人工复核）

样式应用铁律

0. 只改格式、严禁修改原文内容（2026-08-25 用户裁定，最高优先级）：本 skill 只做样式应用（pStyle/字体/字号/对齐/缩进/间距/边框），不得增、删、改、移任何文字内容（含表格内文字、标点、空格、数字、单位）。套用样式后必须用 check_styles.py --verify-content <原文件> 校验内容完整性——文本与原文逐字不一致即 FAIL，打回重做，不交付。内容修改（如补数据、改措辞）属内容层任务，走 ipo-write-response 等，本 skill 一律不做。
1. 模板先行：任何文档动笔前先确认模板 docx 存在（assets/templates/），优先以模板为基底（保留 styles.xml 样式表）；模板即样式源，使用者替换模板即定制输出样式
2. pStyle 优先于手写格式：能应用命名样式（000-009/0011/001）就不用直接格式（字体/字号硬编码），保证全文一致性与后续批量修改能力
3. 序号前缀≠标题："1、""（1）""1）""①"开头的段落可能是正文而非标题——按 rules.md 判定：引导句+长句列举（>40字）→ 000 正文；短标题（≤40字）+ 段后独立展开 → 对应标题样式
4. 反馈回复合规展示：监管问题原文必须 001（黑体），回复正文必须 000（宋体）——黑体宋体对照本身就是审核合规展示，不得混用
5. 不覆盖用户手动格式：用户已有 docx 中人工调整的格式（非样式体系内容），apply-template 前先与用户确认是否保留
6. 段落间禁止空行/空段落（2026-08-25 用户裁定）：段落间距一律靠样式 spacing（段前/段后）控制，不得插入无文字空段落分隔段落——样式自带 spacing 已提供间距，空段落破坏样式统一性（命中裸段落检查）、造成间距叠加

踩坑记录（实测）

• 中文文件名编码：Git Bash 向 Python/minimax CLI 传中文文件名参数可能乱码（zipfile 读 报告模板.docx 曾报 "No such item"）→ 优先用 Python glob.glob/os.listdir 遍历目录取文件，或复制为临时英文文件名再处理
• minimax-docx 环境：restore 必须用 csproj（.slnx 不支持 dotnet 8）；依赖华为云 NuGet 镜像
• apply-template 语义：把模板样式套到源文件（保留源内容换样式），不是以模板内容为基底——新建场景用 create，套用场景用 apply-template，勿混淆

维护与更新

变化类型	需要改 skill？	动作
模板 docx 更新（样式调整）	⚠️ 视情况	同步更新 references/style-map.md 对应样式定义 + CHANGELOG 留痕
工具链变化（minimax/tencent 升级）	✅ 改	更新「工具路由」章节
新增文档类型样式	✅ 改	新增场景行 + style-map 样式表
序号/表格规则裁定变化	✅ 改	更新 references/rules.md

版本管理（2026-08-25 固化）：

• 版本号规则：功能/结构变更 bump minor（0.2.0→0.3.0），规则裁定/缺陷修复 bump patch（0.3.0→0.3.1）；模板 docx 更新在 CHANGELOG 对应版本下记录，不单独 bump
• 每次变更同步更新 CHANGELOG.md（Keep a Changelog 风格：新增/修正/模板留痕/测试 分类）
• 发布时打 git tag vX.Y.Z；当前版本见 frontmatter version