ipo-doc-formatting

ipo-doc-formatting

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

何时使用

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

若任务同时含「写反馈回复内容」→ 内容方法论走 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/

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

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

用户请求（写 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 用户裁定：脚本兜底 + 标注局限）：

执行流程（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：

S5 标题序号 + 表格规则

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

S6 校验门禁

• 成品文档校验：python scripts/check_styles.py --input --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 样式生成"
• 样式未全覆盖处列出清单（哪些段落待人工复核）

样式应用铁律

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

维护与更新

版本管理（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