公文写作
国央企/党政机关公文与报告写作技能——按 GB/T 9704-2012 国标生成年度工作总结、述职报告、党建报告、调研报告、工作方案、会议纪要、通知公告、请示批复、转发性公文、制度办法等 34 类文书,含质量评分、格式校验、政策引用溯源与 PDF 一键直出。Write formal Chinese government and state-owned enterprise documents following GB/T 9704-2012 standards, covering 34 document types with quality scoring, format checking, policy citation tracing and one-click PDF export.
skillhub install @user_2cbb58cd/gov-report-writing
README 文档
23,226 字国央企公文与报告写作
先看这里:你属于哪种情况?
不用先学公文知识。找到自己那一行,照着说就行。
| 你的情况 | 直接这样说 | 想看细节 |
|---|---|---|
| 第一次用,要写一份新的 | 「帮我写一份人力资源部 2025 年度工作总结,3000 字左右」 | 往下看「30 秒快速开始」 |
| 手上有旧稿,想照着改成新稿 | 上传旧稿 +「按这份去年总结的风格,写今年的」 | 「工作流程」步骤 1c 风格仿写 |
| 内容都写好了,只想排成国标格式 | 上传文件 +「按国标公文格式排版」 | 「工作流程」步骤 4 输出格式 |
| 要交 PDF 给别人看 / 走流程 | 生成后说「转成 PDF」 | 「素材转换与降级指南 → 输出侧」 |
| 稿子里引了政策,怕文号写错 | 生成后说「核一下政策引用」 | 「政策引用与溯源」 |
| 素材是图片 / 扫描件 / 录音 | 先用 OCR 或转写工具变成文字,再发我 | 「素材转换与降级指南」 |
| 不确定该用哪个文种 | 直接说事由(如「关于申请采购设备的」),我来判断 | 「文种怎么选」 |
30 秒快速开始
只做三件事,就能拿到一份按国标排版的公文。
第 1 步 · 说需求(一句话即可)
帮我写一份人力资源部 2025 年度工作总结,3000 字左右
第 2 步 · 等生成(Skill 自动跑完三阶段)
识别类型 → 套模板 → 按 GB/T 9704 排版 → 输出 Word
第 3 步 · 要 PDF 就再补一句(可选)
转成 PDF
会自动调用你本机的 Word 或 LibreOffice 转换,并实测校验页数与字体嵌入状态 (这两项决定"发到别人电脑上会不会跑版")。见 输出侧:格式转换。
第 4 步 · 验收(推荐跑一次评分,90 分 A 档可直接提交)
python scripts/quality_score.py 你的文档.docx
⚠️ 三种素材要先转成文字(本 Skill 不能直接读):图片 / 扫描 PDF / 语音录音。 转好文字再发给我,处理方法见 素材转换与降级指南。
三种用法(选一个,随时可切)
| 用法 | 你这样说 | 我会怎么做 |
|---|---|---|
| 一键生成(默认) | 「帮我写一份 XX,3000 字」——不加别的 | 三阶段一口气跑完,中途不打断,直接给成品 |
| 分步引导 | 「先列大纲」/「分步来」/「一步步确认」 | 每阶段停下来等你点头,再往下写 |
| 照旧稿仿写 | 上传旧稿 +「按这份的风格写今年」 | 先提取它的结构、句式、口径,再套到新内容上 |
怎么切:任何时候补一句「先列大纲」就切到分步;说「直接出稿」切回一键。 没说的话按一键生成跑——不会先反问你三个问题。
高频问题 12 条(答不了再往下翻)
完整 30 条 + 12 条反模式见
references/faq.md。
| 你问 | 答 |
|---|---|
| 什么都不会,第一句说什么? | 「帮XX部写2025年度工作总结,3000字」——文种+主体+字数,三样齐了就不会反问 |
| 一定要一问一答吗? | 不要。默认一键出稿,除非你说「先列大纲」 |
| 政策文号记不清怎么办? | 会写「〔待补:发文字号、发布日期〕」,不替你编 |
| 涉密内容能写吗? | 不能(E8),请先脱敏。硬规则无例外 |
| 图片/录音能直接读吗? | 不能,先 OCR/转写贴文字(本版不集成) |
| 行距字体被标红怎么办? | 改文档不改命令:正文 28 磅固定行距、首行缩进 2 字符 |
| 评分脚本跑不起来? | 不影响交付(E9),可照清单人工核 |
| PDF 转不出来? | 先 python scripts/pdf_export.py --check;没引擎走三条降级路 |
| 报告里能夹带请示吗? | 不能,一文一事,请示单独出文 |
| 通报/公示能套通知模板吗? | 不能,三者效力不同,走模板 #37 / #38 |
| 一次要出 5 份行吗? | 行,但一份一份出,同批会互相串味 |
| 生成中断了怎么办? | 会告诉你断在第几章,开新对话带断点续写,别从头重来 |
目录
| 章节 | 什么时候看 |
|---|---|
| 先看这里:你属于哪种情况 | 第一次用,先看这个 |
| 三种用法 | 想知道要不要先列大纲 |
| 高频问题 12 条 | 遇到问题先看这个 |
| 30 秒快速开始 | 现在就要出稿 |
| 概述 | 第一次用,想知道能力范围 |
| 安全红线 | 任何时候(先看这个) |
| 工作流程(三阶段) | 想知道 Skill 怎么跑的 |
| 完整上手示例 | 想看详细的 6 步流程 |
| 文种怎么选 | 不确定该用哪个模板 |
| 语气与语言规范 | 措辞拿不准 |
| 反模式速查 | 写之前扫一眼,少返工 |
| 边界条件与异常处理 | 遇到报错或意外情况 |
| 素材转换与降级指南 | 手上是图片 / 扫描件 / 语音 / 要 PDF |
| 政策引用与溯源 | 稿子里引了政策文件,怕文号写错 |
| 错误处理与降级机制 | 想知道 E1-E13 具体规则 |
| 压力测试场景清单 | 想压测 Skill 稳定性 |
| 交付前成果检核 | 交稿前终检 |
| 交付时附格式校验报告 | 想知道交付时该附带什么 |
| 出错了怎么救 | 遇到报错,想知道怎么办 |
| 脚本参数速查表 | 脚本报错了,想知道改哪里 |
| 参考资料索引 | 想直接翻参考文件 |
什么时候读哪个文件(渐进式加载表)
不必一次读完。本 Skill 的文档分三层:必读层(每次任务都要)、 按需层(碰到才读)、深度层(要细究再看)。照着下表读,不要通读全部。
第一层:必读(每次任务)
| 文件 / 章节 | 读它的条件 | 解决什么 |
|---|---|---|
| 本文件「安全红线」 | 任何任务,第一优先级 | 涉密、政治表述、越权风险 |
| 本文件「工作流程(三阶段)」 | 任何任务 | 知道 Skill 会怎么跑、何时要你确认 |
| 本文件「报告类型快速识别」 | 文种不确定时 | 定模板 |
第二层:按需(碰到对应情况才读)
| 文件 / 章节 | 读它的条件 | 解决什么 |
|---|---|---|
references/report-templates.md | 要写某个具体文种 | 该文种的章节骨架(38 类,附 §41 选用总表) |
references/gb-t9704-format.md | 要核对排版参数 | 页边距/字体/行距/页码的国标值 |
references/redhead-workflow.md | 要出红头文件(版头) | 版头要素确认 → 编排 → 置入 Word → 自检 |
references/vocabulary-guide.md | 措辞拿不准、涉及政治术语 | 词项规范 |
references/quality-scoring.md | 拿到评分报告要对照 | 五维 100 分怎么来的、怎么改 |
references/policy-citation-guide.md | 稿子里引了政策文件 | 文号、书名号、年份括号的规范 |
references/policy-database.md | 要查常用政策文件的准确表述 | 常用政策速查 |
references/ai-traces.md | 要去 AI 味 | 12+5 条痕迹清单 + 人味二审八类 |
references/polishing-guide.md | 要篇章级润色 | 语病/句式/过渡/数据一致性 |
references/case-examples.md | 想看范文 | 实例对照 |
references/expression-library.md | 词穷,找句式 | 表达库 |
references/capability-matrix.md | 不确定能不能做某事 | 能力边界 |
references/troubleshooting.md | 素材转换完整步骤(各系统按钮级)+ E1-E13 完整规则 + 静态检查盲区 | 遇到报错或要转素材时 |
| 本文件「交付时附格式校验报告」 | 每次交付 docx 时 | 交付时该附带什么 |
| 本文件「出错了怎么救」(L-6 三式) | 遇到报错时 | 第一步该做什么 |
| 本文件「脚本参数速查表」(Y-2) | 脚本报错要改参数时 | 改哪里、怎么改 |
第三层:深度(要细究再看)
| 文件 / 章节 | 读它的条件 |
|---|---|
| 本文件「错误处理与降级机制」(E1-E13) | 想彻底搞清某类失败的处理逻辑 |
| 本文件「压力测试场景清单」 | 想压测稳定性 |
| 本文件「素材转换与降级指南」 | 手上是图片/语音/要 PDF 且要看全路径 |
references/report-templates.md §36 文种易混辨析 | 两个文种拿不准选哪个 |
十条按需加载路径(照抄即用)
要写新稿 → 本文件「30 秒快速开始」+ report-templates.md 对应文种
要仿旧稿风格 → 本文件「工作流程」步骤 1c
只做排版 → 本文件「工作流程」步骤 4 + gb-t9704-format.md
要转 PDF → 本文件「素材转换与降级指南 → 输出侧」
要核政策引用 → policy-citation-guide.md
要查政策表述 → policy-database.md
要出红头文件 → redhead-workflow.md(版头要素 + 置入步骤)
要去 AI 味 → ai-traces.md(§一~§二 消痕迹 + §四 补人味)
要篇章润色 → polishing-guide.md
要对照评分 → quality-scoring.md
拿不准文种 → report-templates.md §36 文种易混辨析
交付带校验报告 → 本文件「交付时附格式校验报告」
遇到报错 → 本文件「出错了怎么救」三式
概述
本技能覆盖国央企和党政机关体系的正式公文写作全流程:格式规范(GB/T 9704-2012 及企业标准扩展)、38 种模板框架(8 种工作模板 + 7 种行政公文 + 10 种专题模板 + 信函式文件 + 应急预案/会议议程/慰问信/专项总结/联合行文/转发性公文/请示批复联动/制度办法标准/通报/公示/感谢信贺信/会议方案)、红头文件一体化生成(版头要素确认、编排与置入)、公文专用措辞规范及安全保密要求;成稿后可用 scripts/qualityscore.py 做五维 100 分质量评分(合规/完整/规范/准确/文风),用 scripts/formatcheck.py 做国标排版校验(含版头要素校验),用 scripts/policycite.py 做政策引用溯源校验,用 scripts/pdfexport.py 把 Word 直出为 PDF 并实测校验字体嵌入。核心参考资料存放在 references/ 目录,按需加载。
完整上手示例(Quick Start)
用户请求:「帮我写一份人力资源部年度工作总结」
执行流程:
- 识别关键词"年度"+"总结" → 年度工作总结
- 加载
references/report-templates.md第一节获取框架 - 加载
references/vocabulary-guide.md获取用语规范 - 按四段式结构生成内容(主要成效→亮点→问题→计划)
- 加载
references/gb-t9704-format.md→ 使用docxskill 按国标排版 - 审校检查后输出 Word 文档,附安全提示
安全红线(所有任务的第一优先级)
执行任何写作任务前,必须完成以下检查:
- 识别涉密信号:若用户输入中包含以下任一信号,立即提醒而非继续处理:
- 密级标注(绝密/机密/秘密)
- 文件编号含"密"字样
- 军工项目代号、武器型号
- 未公开的组织架构或编制信息
- 具体的技术参数或经费数据
- 区分占位符:
- 敏感信息(涉密内容)→ 拒绝处理,要求用户脱敏后重新提交
- 可选信息(用户未提供但可自行补充的数据、人名、部门名)→ 用
XX占位 - 公开信息(用户明确提供的内容)→ 直接使用
- 本地处理原则:优先使用
docxskill 在本地生成文件,不使用需要上传的外部服务 - 交付时的保密提醒:每份文档输出后必须附带安全提示模板
工作流程(三阶段)
阶段一:准备 — 理解任务并加载资源
步骤 1:解析用户请求
├── 包含具体报告类型关键字 → 直接识别,跳至步骤2
├── 表述模糊(如"写个报告")→ 从模板列表中提供 2-3 个最可能的选项供用户确认
├── 附有素材文件 → 先读取素材(支持 .docx / .txt / .md / 通用PDF),
│ 如素材为图片/扫描PDF/语音转写,告知用户需文字化后处理
├── 要求按某份已有文件风格仿写 → 启动「风格仿写流程」(见下方步骤1c)
├── 要求导出 PDF → 走「输出侧:格式转换」的 PDF 直出流程(scripts/pdf_export.py)
├── 要求核查政策引用 / 生成溯源表 → 走「政策引用与溯源」(scripts/policy_cite.py)
└── 用户选择"逐步引导"模式 → 切换为分步交互模式(见下方)
步骤 1b:分步交互模式(用户说"引导我写"或"一步一步来"时启用)
├── 步骤引导:逐项提示用户输入关键信息,每次只问一个问题
├── 要素填空:列出核心要素表格(报告类型/时间范围/关键数据/特殊要求),用户填写后套模板生成
└── 默认模式:快速生成(用户一句话 → AI 直接输出完整文档)
步骤 1c:风格仿写流程(用户提供往年材料,要求新稿风格一致时启用)
1. **提取风格指纹**:读取用户上传的往年材料,分析并记录:
- 标题风格:常用句式、对仗方式、字数偏好
- 段落节奏:长短句比例、每段行数、是否习惯「总—分」结构
- 用词偏好:高频动词(推进/加强/着力)、程度副词档位(显著/较大幅度/一定)
- 数字呈现方式:先用百分比还是绝对数、是否列表化
- 语气基调:直接了当/中庸稳重/积极进取
2. **确认风格要点**:向用户简要汇报提取的风格特征(3-5 条),请用户确认
3. **套用风格生成**:基于模板框架 + 用户提供的风格指纹,生成新稿
4. **风格一致性自检**:
- 新稿与往年材料的小标题对仗方式是否一致
- 用词偏好是否延续(如往年爱用「持续深化」,新稿也应有对应)
- 整体语气是否与前作统一
步骤 1d:风格仿写用户提示模板
我已分析您往年材料的写作风格,核心特征如下:
- 标题风格:[X字对仗,如"强化XX、深化XX"]
- 用词偏好:[高频词,如"着力""狠抓""落地"]
- 数据呈现:[百分比为主/绝对数为主/表格化]
- 语气基调:[务实/进取/稳重]
请确认以上风格描述是否准确,或指出需要调整的地方。 确认后我按此风格生成新稿。
步骤 2:加载参考资料(按需组合,避免全量预载)
├── 涉及报告框架 → 加载 references/report-templates.md(定位到对应章节)
├── 涉及国标排版 → 加载 references/gb-t9704-format.md(生成 Word 时必加载)
├── 涉及措辞润色 → 加载 references/vocabulary-guide.md + expression-library.md(语境表述库)
├── 涉及范文参考 → 加载 references/case-examples.md(按条线定位:HR/财务/党建/安全/科研)
├── 涉及政策引用 → 加载 references/policy-database.md(速查)+ references/policy-citation-guide.md(格式与溯源规范)
└── 涉及制度/办法/标准类文书 → 加载 references/report-templates.md 第三十五节
阶段二:生成 — 按框架填充内容
步骤 3:信息补全
├── 模板框架中需要但用户未提供的关键信息 → 用 XX 占位,在安全提示中提醒
├── 用户未明确的数据(如"增长率XX%")→ 用 XX% 占位
└── 用户提供的所有公开内容 → 直接使用,不擅自改写事实
步骤 4:输出格式
首选 Word (.docx),严格遵循 GB/T 9704-2012 国标排版参数:
- 页面:A4,上3.7cm / 下3.5cm / 左2.8cm / 右2.6cm
- 标题:二号方正小标宋简体,居中,行距固定值30磅
- 正文:三号仿宋_GB2312,行距固定值28磅,首行缩进2字符
- 一级标题(一、):黑体三号,居中独立成段
- 二级标题((一)):楷体_GB2312三号,首行缩进2字符
- 三级标题(1.):仿宋_GB2312加粗三号
- 数字统一使用 Times New Roman
- 若系统缺少指定字体 → 使用 docx skill 设置字体名后提醒用户自行安装字体
- 标题字号分级:党组/党委文件用 20 磅,单位/部门文件用小二号(18 磅),其余用二号(22 磅),默认按用户单位层级推断
备选格式:
- 用户要求 HTML 预览/Markdown → 对应格式输出,告知正式提交仍需 Word
- 用户要求 PDF → 走下方「输出侧:格式转换」的 PDF 直出流程,不自行降级出稿
- 用户要求空模板 → 按 GB/T 9704 参数生成一份空白文档(用户可在 Word 中另存为 .dotx 复用)
格式自检(可选):
- 生成后可用 `python scripts/format_check.py <docx文件>` 自动检查页边距/字体/行距/层级序号/年份括号
- 脚本跨平台兼容(Windows/macOS/Linux),支持 `--json`(程序化调用)与 `--quiet`(仅问题项)参数;路径支持引号包裹与 `~` 展开
阶段三:交付 — 审校与安全提示
步骤 5:自检清单(按顺序执行)
1. 政治术语准确性(对照 vocabulary-guide.md 第一章,查看 50+ 检查清单)
2. 层级标题序号格式(一、→ (一)→ 1. → (1))
3. AI 痕迹检测(对照 references/ai-traces.md 12 类模式逐段检查)
4. 口语化词汇替换(搞→开展 / 弄→办理 / 做→实施 / 很多→较大幅度)
5. 年份用全称(2025年 非 25年)
6. 禁用词扫描(史无前例、完全、绝对、极其……)
7. 政策引用准确性(对照 `references/policy-database.md`,不编造文件名称;格式与溯源规范见 `references/policy-citation-guide.md`)
8. 附件安全提示(见下方模板)
步骤 5b:篇章级润色(内容超过 500 字时执行)
├── 对照 references/polishing-guide.md 四层检查:
│ 一、语病识别(成分残缺/搭配不当/语序不当/重复啰嗦/杂糅/歧义)
│ 二、句式优化(长短句节奏/小标题对仗/主动句优先/排比控制)
│ 三、过渡自然化(章节衔接/段落过渡/首尾呼应/逻辑一致性)
│ 四、数据一致性(同一指标前后一致/分项加总/单位统一/表述口径)
├── 逐章执行(超长报告随分段生成策略逐章润色,统稿后整体复查)
└── 原则:不改变事实与数据、政治表述原样保留、修改留痕、单次修改≤全文20%
步骤 5c:质量评分(可选,推荐执行)
├── 运行 `python scripts/quality_score.py <文件路径>`,按五维 100 分制评分:
│ 合规度 30(政治术语/机构名/禁用词/占位符)|完整度 25(要素/章节/信息密度)
│ 规范度 20(序号/数字/标点/引用)|准确度 15(数据/单位/时间)|文风度 10(AI痕迹/对仗/节奏)
├── 支持 .docx / .md / .txt;用 `--type <类型>` 指定报告类型可提高章节校验准确度;
│ 草稿用 `--draft` 跳过占位符检查;程序化调用用 `--json`
├── 按问题清单优先级修复:P0 红线(政治术语错误)**必须修复,无论总分多少** → P1 → P2 → P3
├── 修复后重跑验证分数提升,目标 ≥ 90 分(A 档)再提交
├── 涉密信号:扣 50 分 + 顶部严重警告(不判 0,避免单位名误伤),见 E9
└── 判定细则、扣分标准、典型病例详见 `references/quality-scoring.md`
步骤 5d:政策引用溯源(引用 ≥3 处、或涉及重要依据时执行)
├── 跑 `python scripts/policy_cite.py <文件路径> --save <文件名>-政策引用溯源表.md`
├── 脚本检出:缺发文字号 / 缺日期 / 括号不规范(须用六角括号〔〕)/ 带待补占位 /
│ 书名号不成对 / 同一文件两种写法 / 文号年份异常
├── 输出**政策引用溯源表**,可直接附在稿子后面交付
├── ⚠️ 脚本**只做规范与要素完整性校验,不联网、不做事实核验**——
│ 文件是否存在、是否已废止,必须由用户比对官方原文(来源优先级见 policy-citation-guide.md 第三节)
└── 处置:P1(缺文号/待补占位)定稿前必须处理;P2(格式/异称)建议处理;P3(缺日期)可选
步骤 6:输出后必须附带:
---
【安全提示】
1. 文档中的 "XX" 为占位符,请替换为实际信息
2. 请核对所有数据、日期、人名、部门名的准确性
3. 如涉及涉密内容,请按单位保密规定处理后再使用
4. 公文格式已按 GB/T 9704-2012 国标设置
5. 如系统缺少仿宋_GB2312、楷体_GB2312、方正小标宋简体字体,请手动安装
---
文种怎么选:先看你这句想干什么
38 类收敛成 5 组,先定组,再定文种。这样不用背文种名。
第一步:按意图定位(5 组)
| 你想干什么 | 常见说法 | 该走的文种 | 最容易走错的 |
|---|---|---|---|
| 向上交代我干了什么 | 总结、述职、汇报、巡视、整改 | 年度/专项总结、述职报告、汇报材料、巡视汇报、整改方案 | ≠ 请示(报告不夹带请求事项) |
| 向上要资源、要批准 | 申请、报批、要编制、要经费 | 请示(一文一事);先请示后批复走「请示批复联动」 | ≠ 报告(请示需上级批复,报告不要批复) |
| 向下或平级知会 | 通知、通报、公示、转发、函 | 通知、通报、公示、转发性公文、函(平行对等) | ≠ 用通知写通报(通报告知情况,不需回复) |
| 定规则、定流程 | 制度、办法、方案、预案、议程、会议筹备 | 制度办法标准、工作方案、应急预案、会议方案、会议议程 | ≠ 工作总结(没成绩没问题不是总结) |
| 党建专题 | 党建、党课、民主生活会、心得体会 | 党建报告、党课讲稿、对照检查、心得体会、先进事迹 | ≠ 把所有党建材料都写成党建报告 |
第二步:三条判定规则
- 具体文种词优先:出现「请示 / 批复 / 通报 / 公示 / 纪要 / 函」→ 直接定为该文种,不再看其他词
- 通类词才需要追问:只有「报告」「材料」「文件」这种通类词时,才看用途(给谁、要不要批复)
- 冲突要拆不合并:「总结 + 申请经费」=两份文件(总结 + 请示),不做成一份
第三步:你随口一说,我怎么接(10 条实例)
| 你这么说 | 我识别为 | 我会做什么 |
|---|---|---|
| 「下周要开安全生产会,帮我弄个通知」 | 通知(会议通知) | 按模板 #7 出文,要素含时间地点参会范围 |
| 「今年人才公寓搞得不错,写个总结」 | 年度工作总结 | 按 #1,成绩+问题+打算三段 |
| 「我们部门想申请两台服务器」 | 请示 | 按 #10,一文一事,末尾明确请求事项 |
| 「上级要我们报个情况,说下整改得怎么样」 | 整改方案 / 汇报材料 | 看有无措施表:有措施表→#24;纯叙述→#8 |
| 「要公示一下这次评优名单」 | 公示 | 按 #38,含异议期与渠道,用「拟」字 |
| 「通报表扬一下抢险那几个人」 | 通报(表彰性) | 按 #37,先事实后评价 |
| 「给合作单位发个函,请他们提供材料」 | 函(商洽函) | 按 #9,一事一函,平行语气 |
| 「把上级那个文件转发下去,加几句要求」 | 转发性公文 | 按 #33,转发通知从简,落实要求具体 |
| 「定个会议室使用管理办法」 | 制度/办法 | 按 #35,条款化 + 附则 |
| 「书记要讲一堂党课,讲主题教育」 | 党课讲稿 | 按 #18,理论通俗化,3-5 个层次 |
一句话:说法里带具体文种就照那个走;只带「报告/材料」我会问一句给谁看,其余直接出稿。
附:38 类关键词速查(含模板位置与语气)
| 关键词(任一命中) | 报告类型 | 模板位置 | 语气特点 |
|---|---|---|---|
| 总结、年度、全年、回顾、阶段 | 年度工作总结 | templates#1 | 务实、有数据、成绩与问题平衡 |
| 述职、履职、述廉 | 述职报告 | templates#2 | 第一人称、谦虚务实、体现反思 |
| 党建、党委、支部、思想政治、学习 | 党建报告 | templates#3 | 庄重严肃、政治性强、用词精准 |
| 调研、课题、研究、分析 | 调研报告 | templates#4 | 客观理性、数据驱动、论证严密 |
| 方案、计划、安排、部署 | 工作方案 | templates#5 | 明确具体、可操作、有时限 |
| 纪要、会议、决议 | 会议纪要 | templates#6 | 客观实录、不评论、完整准确 |
| 通知、公告 | 通知/公告 | templates#7 | 简洁明了、一事一文、无歧义 |
| 汇报、向上级、上报 | 汇报材料 | templates#8 | 突出亮点、问题点到为止 |
| 函、商洽、询问、答复 | 函 | templates#9 | 正式对等、一事一函 |
| 请示、审批、批准 | 请示 | templates#10 | 一事一请、上级批复 |
| 批复、批示、同意 | 批复 | templates#11 | 态度明确、针对请示 |
| 报告(行政)、报送、答复 | 报告(行政公文) | templates#12 | 客观汇报、不夹带请示 |
| 议案、审议、提请 | 议案 | templates#13 | 政府→人大、严格法定 |
| 决定、奖惩、变更 | 决定 | templates#14 | 权威果断、不容置疑 |
| 意见、实施建议、处理办法 | 意见 | templates#15 | 灵活多向、见解明确 |
| 民主生活会、对照检查、批评 | 民主生活会发言 | templates#16 | 诚恳具体、触及思想 |
| 务虚会、思路、设想 | 务虚会发言 | templates#17 | 思想碰撞、前瞻创新 |
| 党课、讲稿、宣讲 | 党课讲稿 | templates#18 | 理论通俗化、感染力 |
| 心得体会、学习感受 | 心得体会 | templates#19 | 真情实感、结合实际 |
| 述职述廉、述廉 | 述职述廉报告 | templates#20 | 述廉专章、如实报告 |
| 组织生活会、检视剖析 | 组织生活会对照检查 | templates#21 | 见人见事见思想 |
| 表态、就职、任职 | 任前表态发言 | templates#22 | 诚恳朴实、3-5分钟 |
| 先进事迹、榜样 | 先进事迹材料 | templates#23 | 事例驱动、细节说话 |
| 整改方案、整改 | 整改方案 | templates#24 | 问题措施对应、表格化 |
| 巡视汇报、巡视 | 巡视汇报材料 | templates#25 | 实事求是、数据支撑 |
| 信函、便函、函件 | 信函式文件 | templates#27 | 双线版式、平行对等 |
| 应急预案、预案、突发事件 | 应急预案 | templates#28 | 分级响应、责任到人 |
| 议程、会议安排、日程 | 会议议程 | templates#29 | 议题排序、时间标注 |
| 慰问信、节日慰问、致信 | 慰问信 | templates#30 | 真诚温暖、层次分明 |
| 专项总结、专题总结、专项工作 | 专项总结 | templates#31 | 聚焦专项、深度优先 |
| 联合行文、会签、联合发文、联合部署、多部门联合 | 联合行文 | templates#32 | 主办牵头、职责边界清晰、会签确认 |
| 转发、批转、印发、转发上级文件 | 转发性公文 | templates#33 | 转发通知从简、落实要求具体、随文下发 |
| 请示批复成对、起草批复、同意批复 | 请示批复联动 | templates#34 | 一文一事、要素逐项对应、表态前置 |
| 制度、办法、管理办法、暂行办法、实施细则、工作细则、标准、准入标准、规范、规程、议事规则、章程 | 制度/办法/标准类 | templates#35 | 条款化、可判定、权责清晰、附则齐全 |
| 通报、表彰、批评、情况通报、警示 | 通报 | templates#37 | 事实确凿、先事后评、不需回复 |
| 公示、任前公示、评优公示、录用公示、异议期 | 公示 | templates#38 | 有异议期、渠道具体、用「拟」字 |
| 感谢信、贺信、致谢、祝贺、道贺 | 感谢信与贺信 | templates#39 | 含具体事由、篇幅短、语气真诚 |
| 会议方案、会议筹备、筹备分工、会务安排 | 会议方案 | templates#40 | 九要素齐全、分工到人到时限 |
语气与语言规范(合并版)
总体原则
客观、严谨、准确、简洁。以事实和数据为基础,避免主观情绪和夸张修辞。立场正确、政治站位高。
必须做到
- 正式规范,不含口语化表达
- 小标题对仗工整(四字或六字动宾短语)
- 政策术语严格准确(不可自行修改/发明政治表述)
- 问题表述用"有待加强""存在不足""尚需提升""仍有差距"
- 数据有来源、逻辑有支撑
禁止使用(集中列出一处)
- ❌ 口语词:搞、弄、做、干、整 → 替换为:开展、办理、实施、推进、处理
- ❌ 绝对化用语:完全、绝对、100% → 替换为:基本、较为、显著
- ❌ 夸张修辞:史无前例、前所未有、极大突破
- ❌ 情绪化表达:非常、特别、极其
- ❌ 模糊表述:大概、可能、好像、差不多
常用句式速查
| 场景 | 句式 |
|---|---|
| 开头 | "为深入贯彻落实……,根据……要求,现就……如下:" |
| 过渡 | "现将有关情况报告如下:" |
| 总结 | "总的来看,……" / "通过……,取得了以下成效:" |
| 部署 | "要……,要……,要……" / "着力抓好……" / "持续深化……" |
| 问题 | "主要表现在:一是……二是……三是……" |
反模式速查(写之前扫一眼)
这 8 条是最容易"用错"的地方——不是功能缺陷,是用法错位。完整 12 条见
references/faq.md第二部分。
| 别这么干 | 为什么不行 | 改成这样 |
|---|---|---|
| 只说「写个报告」,不给主体和用途 | 文种选错要整体返工 | 说清给谁看、要解决什么 |
| 把涉密原文整段粘进来再让润色 | 触发红线直接拒(E8) | 先脱敏替换人名/金额/项目名 |
| 让 AI 补全政策文号和条款 | 会编造不存在的文件 | 用「〔待补〕」占位,自己补原件 |
| 拿通知的框架写通报/公示 | 三者效力与结构不同 | 走模板 #37 / #38 |
| 报告里夹带请示事项 | 报告不夹带请示,上级无法批复 | 请示单独出文(#10) |
| 看到行距/字体报错就去改脚本参数 | 排版问题在文档里,改参数无用 | 改文档:正文 28 磅、缩进 2 字符 |
不加 --type 就让评分脚本判 | 类型猜错→章节完整性虚扣分 | 加 --type 年度工作总结 |
| 生成中断后从头重来 | 会覆掉你已手改的内容 | 只重跑失败那一步(第三式) |
能写什么、不能写什么(硬边界一览)
| 能 | 不能 |
|---|---|
| 38 类中文公文与报告(党政机关 / 国央企) | 英文公文、法律合同、协议、法律意见书(E5) |
| 国标 GB/T 9704-2012 排版 + 红头版头 | 直接读图片 / 扫描件 / 录音(需先转文字) |
| 五维 100 分质量评分(13 种文种口径) | 联网核验政策真伪、查最新文件(本技能不联网) |
| 政策引用格式检查 + 溯源表输出 | 编造文件名称、发文字号、条款内容(红线) |
| docx → PDF(需本机 Word 或 LibreOffice) | 涉密/机密/秘密内容处理(E8,硬规则) |
| 万字级长文(分段:大纲→逐章→统稿) | 连内网系统取数、调数据库 |
| 提取旧稿风格做仿写 | 保证通过单位内部审签流程(只保证格式与措辞规范) |
| 现代汉语公文语体(庄重、简明、平实) | 文言 / 半文言体、祭文、碑记、单位赋等礼仪文(语体差异大,建议自行撰写) |
为什么不做文言:GB/T 9704-2012 要求公文的语体是庄重、简明、平实,文言与其相斥——法定公文文种没有一种适合用文言写。 祭文、碑记、单位赋属于礼仪文,不在公文范畴。这类需求建议自行撰写或改用通用写作工具,本技能不承接。
边界条件与异常处理
| 场景 | 处理方式 |
|---|---|
| 用户提供图片/扫描PDF/语音 | 告知无法直接解析,请用户提供文字内容 |
| 请求类型不在模板列表中 | 如为特定行政公文则按对应模板生成;确实未覆盖的按最接近类型变通处理 |
| 素材信息严重不完整 | 先生成有占位符的框架草稿,列出"待补充信息清单"让用户确认 |
| 用户中途追加新要求 | 判断改动范围:小幅修改→直接更新文档;大幅改动→重新走阶段一确认 |
| 系统缺少国标字体 | 在docx中正常设置字体名,安全提示中提醒用户安装 |
| 用户需要英文版公文 | 告知本技能仅支持中文公文,英文版建议另行处理 |
| 用户要求引用特定政策文件 | 不编造政策内容,用"根据XX关于XX的要求"占位,提示用户补充原文 |
| 同一对话中连续生成多份文档 | 每份独立走三阶段流程,复用已加载的references |
| 报告预计超过 5000 字 | 启动分段生成策略:先生成大纲→逐章写→每章确认→全文统稿,见 references/report-templates.md 第二十六节 |
| 参考资料文件缺失/损坏 | 不中断流程,降级为内置规则继续生成,并提示用户(见下方错误处理机制) |
| 生成过程上下文过长 | 触发上下文压缩或分段输出(见下方错误处理机制) |
| 生成失败/输出异常 | 重试一次;重试仍失败则输出 Markdown 降级版本并说明原因 |
| 用户输入超出技能边界(如英文、法律文书) | 明确告知能力边界,给出替代建议或引导使用其他工具 |
素材转换与降级指南
本 Skill 的输入是文字。遇到非文字素材时,先转换再提交。 完整转换步骤与故障处置见
references/troubleshooting.md。
一句话素材速查
| 素材类型 | 能直接处理吗 | 你该做什么 |
|---|---|---|
| Word / 文字版 PDF / txt / md | ✅ 可以 | 直接发给我 |
| 图片 / 截图 / 照片 | ❌ 不行 | 用 OCR 转文字 → 把文字粘给我(步骤见下方) |
| 扫描版 PDF(选不中文字) | ❌ 不行 | 同上;页数多就用 WPS「PDF 转 Word」 |
| 语音 / 会议录音 | ❌ 不行 | 用转写工具变文字 → 把文字粘给我(步骤见下方) |
| Excel 表格 | ⚠️ 部分 | 把数字和指标名粘给我 |
三项最常用的转换办法
| 素材 | 最省事的做法 |
|---|---|
| 图片 / 截图 | 微信发给「文件传输助手」→ 长按图片 → 提取文字 → 复制 |
| 扫描 PDF | 先试 Ctrl+A 能不能选中文字;选不中就逐页按图片处理 |
| 录音 | 讯飞听见上传音频 → 自动转写(或手机录音 App 的「转文字」) |
各系统(Windows / macOS / 手机)的逐个按钮级步骤、以及转写噪音 (口语词、识别错字、时间戳)怎么处理,见
references/troubleshooting.md§1.2。
输出侧:转 PDF
先确认有没有转换引擎(这一步最容易被忽略):
python scripts/pdf_export.py --check
| 你本机的情况 | 怎么转 |
|---|---|
| 装了 Word 或 WPS | 直接说「转成 PDF」,自动走 COM 通道,约 6-15 秒 |
| 装了 LibreOffice | 指定 --method libreoffice |
| 都没装 | 走三条降级路径(见下) |
没装 Office 时怎么办(三条路,任选):
- 换一台有 Word 的电脑转(版式最准,正式发文推荐)
- 在线转换(腾讯文档/WPS 网页版)—— ⚠️ 涉密内容严禁用
- 只交 Word 不转 PDF(双方都是公文体系统时完全够用)
详细的通道说明、字体嵌入风险与处置、四种国标字体的获取安装方法, 见
references/troubleshooting.md§1.3、§1.4。
政策引用与溯源
公文与一般文章最大的区别:每一个政策依据都要能被审核人查证。 本 Skill 不联网,所以这里的"溯源"指的是——把引用写规范、把要素补齐、把待核对项列清楚, 事实核验必须由用户比对官方原文。
完整规范见 references/policy-citation-guide.md,要点:
| 事项 | 要求 |
|---|---|
| 引用式样 | 根据《文件全称》(发文字号,发布日期)精神…… |
| 发文字号 | 用六角括号 〔〕,不用 [] () 【】——这是公文审核高频扣分点 |
| 四种标识 | 〔〕式文号 / 令式文号(主席令第X号)/ 标准编号(GB/T 9704-2012)/ 法律法规(标注版本年份) |
| 首引与后续 | 首次用全称加书名号附文号;后续可用「该文件」指代;同一文件前后写法必须一致 |
| 来源优先级 | ① 中国政府网/国务院政策文件库 → ② 部委官网(.gov.cn)→ ③ 省级政府官网/地方政策法规库 → ④ 人民日报/新华社 |
| 时效性核验 | 发布日期与生效日期 → 是否被修订 → 是否已废止 → 时段性政策是否仍在有效期 |
| 🔴 红线 | 绝不编造文件名称、发文字号、条款内容;严禁将外省政策作为本省政策依据 |
查不到原文时的三种占位写法(按优先级):
| 写法 | 适用 | 示例 |
|---|---|---|
| 缓冲表述 | 方向明确、具体文件未定 | 「根据国家和本市关于人才引进的有关要求……」 |
| 待补标注 | 文件已定、文号/日期未查到 | 「根据《××管理办法》(〔待补:发文字号、发布日期〕)……」 |
| 待核标注 | 记得有这份文件、表述拿不准 | 「根据《×××》(待核:文件全称与现行版本)的部署……」 |
跑一次自动校验 + 生成溯源表:
python scripts/policy_cite.py 报告.docx --save 报告-政策引用溯源表.md
脚本检出 7 类问题:缺发文字号 / 缺日期 / 括号不规范 / 带待补占位 / 书名号不成对 / 同一文件两种写法 / 文号年份异常。输出的 Markdown 溯源表可直接附在稿子后面交付。
⚠️ 脚本不做事实核验——文件是否真实存在、是否已修订或废止、条款内容是否对应, 必须由用户比对官方原文。脚本的价值在于把"凭着感觉翻"变成"照着清单查"。
错误处理与降级机制
目标:任何异常场景下,Skill 都应给出可用的输出或明确反馈,而不是静默失败或产生乱码。 设计原则:检测 → 分类 → 重试上限 2 次 → 降级输出 → 明确告知。不允许静默失败。
两套码的分工:E1-E13 = 你会遇到的现象(业务侧);SE1-SE9 = 脚本退出时的技术原因(工具侧), 脚本报错会自动带
[SE码] + 原因 + 下一步三行。两套码的完整对照见references/faq.md第三部分。完整规则(E1-E13 逐条含"为什么会这样")见
references/troubleshooting.md第二部分。 下面只给速查表——遇到问题先查这张表,再翻详细规则。
遇到问题查这里(13 条速查)
| 你会看到 | 编号 | 一句话处置 |
|---|---|---|
| 打开文档字体不对 | E1 | 装字体即可;不装也能用,只是观感差 |
| 提示"参考资料未完整加载" | E2 | 文档可用;想更稳就重装技能 |
| 提示"这个对话太长了" | E3 | 开新对话带上前半部分和剩余大纲,接着写 |
| 生成失败 / 输出乱码 | E4 | 会给你 Markdown 版,内容是全的 |
| 你让写英文公文 / 合同,我没动笔 | E5 | 超出范围,会告诉你该用什么工具 |
| 一次要好几份,我一份份出 | E6 | 同时做会互相干扰,逐份更干净 |
| 只说"写个报告",我反问你 | E7 | 文种选错要整体返工,问一句更省事 |
| 我拒绝了请求,只说"请脱敏" | E8 | 涉密信息是硬规则,脱敏后再发 |
| 提示"本次未执行自动评分" | E9 | 文档照常交付,可照清单自己核 |
| 提示"单位名称含敏感词,请确认" | E10 | 回一句"可以公开"即可继续 |
| 文中出现《XXXXX》(待核实) | E11 | 按清单补原件信息,我不替你编 |
| 只给了框架和待补清单 | E12 | 占位太多;补内容或说"先出草稿" |
| 提示"PDF 好了但字体没嵌入" | E13 | 正式发文勾选 PDF/A;内部传阅可忽略 |
三条通用边界(硬规则)
- 不允许静默失败——任何异常都要明确告知,不能悄悄跳过
- 不谎报完成——只有真的产出文件并校验通过才算完成
- 讲人话不说机制名——对用户说"你可以这样做",不说"降级""兜底""回退路径"
压力测试场景清单
下列场景必须能正常处理或在 2 次重试内降级输出:
| 场景 | 预期行为 |
|---|---|
| 字数:100 字(极短) | 浓缩核心要素,提示用户补充 |
| 字数:10000+ 字(超长) | 启动分段生成策略 |
| 一次性生成 5+ 份不同文档 | 拆分任务 + 顺序执行 |
| 输入包含「绝密/机密/秘密」字样 | E8 拒绝 + 引导脱敏 |
| 输入包含乱码 / emoji / 表格 | 提取可用部分,提示无法解析部分 |
| 用户中途改 3 次需求 | 维护需求变更日志,统稿时确认 |
| 仅提供 1-2 句话素材 | 生成有占位符的草稿 + 列出待补充清单 |
| 要求覆盖 5 个不同业务线 | 加载 case-examples.md 对应章节 |
| 系统上下文已使用 80% | E3 主动压缩 + 建议新对话 |
| 同一文档要求 2 种不同风格 | 询问优先级 + 生成对比版 |
| 单位名含敏感词但内容不涉密 | E10 先问不拒,用户确认后按非涉密处理并留痕 |
| 要求引用找不到的政策文件 | E11 不编造,用缓冲表述占位 + 给出待补清单 |
| 素材严重不足(占位符 > 20%) | E12 给框架 + 待补清单,不强行出全文 |
| 提供图片 / 扫描 PDF / 录音 | 转文字后处理,见「素材转换与降级指南」 |
| 要求导出 PDF,但本机无 Word / LibreOffice | E13 给三段说明 + 引导手动导出,不硬转、不降级糊弄 |
| 导出 PDF 后检出标题字体未嵌入 | E13 主动告知换机风险 + 三条处置(PDF/A / 装字体 / 仅内部流转) |
| 稿子引了 5 处政策但都无发文字号 | 跑 policy_cite.py 生成溯源表;P1 项定稿前必须处理 |
| 用户报了制度/办法类文书(如"定个管理办法") | 按 templates#35 走章条式体例;制度正文不写主送、不盖章 |
交付前成果检核(E-有效性保障)
每份文档交付前必须通过下列检查,任何一项未通过需修正后重交:
硬性检查(必须 100% 通过)
- ✅ 报告类型与用户请求一致
- ✅ 关键占位符全部已用
XX标记,未遗漏 - ✅ 涉密信号扫描通过(无密级标注、无项目代号)
- ✅ 政治术语准确(对照 vocabulary-guide.md)
- ✅ 层级标题序号格式正确(一、→(一)→ 1.→(1))
- ✅ 字体/行距/页边距符合 GB/T 9704-2012
- ✅ 安全提示已附在交付说明末尾
- ✅ 政策引用要素完整(引用 ≥3 处时:
policy_cite.py显示「必须处理 0 项」)
软性检查(建议通过)
- ⭐ 小标题对仗工整(四字/六字动宾短语)
- ⭐ 数据前后一致,单位统一
- ⭐ 篇章过渡自然(无突兀转折)
- ⭐ AI 痕迹扫描通过率 ≥ 95%(对照 ai-traces.md 12 类)
- ⭐ 搭配不当 5 类已过(对照 polishing-guide.md §1.2.1)
- ⭐ 要求 PDF 时:字体嵌入状态已实测并告知用户
如硬性检查未通过,必须修正后重交;如软性检查未通过,需在交付说明中标注「存在 X 项建议优化项,用户可酌情调整」。
交付时附格式校验报告(L-3)
为什么要附:用户拿到文档后,最常被问的两句话是"这个格式对不对""能不能直接交"。 与其让用户自己跑脚本、自己判断,不如把校验结果随文档一起给出去—— 一份逐项打勾的清单,用户扫一眼就知道哪里还没过,需要处理的项一眼可见。
触发条件
| 情况 | 是否附报告 |
|---|---|
| 生成了 .docx 文件 | 必附 |
| 只输出了 Markdown(降级模式) | 不附(无版式可校验) |
| 用户明确说"不用检查/赶时间" | 不附,但要在交付说明里注明未校验 |
| 用户要求"核一下格式" | 附,且把详细报告一并给出 |
报告内容(固定三块)
交付说明中按下面结构给出,不要整段贴脚本原始输出:
一、格式校验(GB/T 9704-2012)
✅ 页边距 上3.7 / 下3.5 / 左2.8 / 右2.6 cm
✅ 标题字体 方正小标宋简体
✅ 正文字体 仿宋_GB2312(三号)
✅ 一级标题 黑体三号
✅ 二级标题 楷体_GB2312 三号
✅ 行距 标题 30 磅 / 正文 28 磅(固定值)
✅ 首行缩进 2 字符
✅ 页码 4 号宋体(单页码居右、双页码居左)
⚠️ 数字字体 未显式设置 Times New Roman(建议设置)
❌ 标题缩进 第 3 段缩进值 200,应为 2 字符
结论:9 项通过 / 1 项提示 / 1 项待修
→ 待修项已定位到具体段落,可按上面说明直接改
二、质量评分(- 可选,脚本可用时附)
总分 92 / 100(A 档,可直接提交)
├ 合规度 30/30 ├ 完整度 24/25 ├ 规范度 20/20
├ 准确度 13/15 └ 文风 5/10
三、需要你处理的事项(- 没有则写"无")
1. 第 3 段首行缩进需调整为 2 字符
2. 建议给数字设置 Times New Roman 字体
3. 文中 3 处「XX」占位符待补充(清单见下)
生成方式
# 1) 格式校验(必须)
python scripts/format_check.py 你的文档.docx
# 2) 质量评分(可选,Python ≥ 3.7 时可用)
python scripts/quality_score.py 你的文档.docx
# 3) 政策引用核查(文中引用政策时)
python scripts/policy_cite.py 你的文档.docx
# 4) 一次性跑全部(推荐,直接出报告)
python scripts/preflight_check.py # 环境自检
如需程序化取用(比如生成 JSON 再排版),加 --json:
python scripts/format_check.py 你的文档.docx --json
三条硬规则
- 不谎报通过:脚本报
❌的项目必须照实写进报告,不允许"看起来不影响就不提" - 不贴原始输出:给用户的报告用上面的三段结构,把脚本输出里的路径、退出码、
机制名(如 "sectPr/pgMar")翻译成人话
- 待修项要给位置:只写"缩进异常"没用,要写"第 3 段缩进值 200,应为 2 字符"
与 E9 的关系
评分脚本跑不起来时(见 E9),格式校验报告仍要照常给——formatcheck.py 与 qualityscore.py 是独立的,前者失败不影响后者,反之亦然。报告里注明哪一块没跑成即可。
出错了怎么救(L-6 故障自动恢复三式)
用户遇到报错时最需要的不是错误原因,而是"我现在该干什么"。 下面三式覆盖绝大多数可恢复故障,优先自己执行,不要先问用户。
第一式:换路径(文件找不到 / 打不开)
症状:报错说文件不存在、路径无效、无法打开。
处置顺序(自己试,别先问用户):
1. 换算绝对路径重试(相对路径在不同工作目录下会失效)
2. 去掉路径两端引号重试(拖拽文件常带引号)
3. 若路径含空格或中文,用双引号包住重试
4. 都失败 → 才问用户:"方便的话把文件重新拖一次给我,或者告诉我完整路径"
为什么先自己试:这几类问题占了"文件打不开"的绝大多数,且修改方式没有歧义, 试错成本远低于来回问一次。
第二式:无缝续写(生成中断 / 上下文超限)
症状:写到一半停了、提示上下文过长、输出被截断。
处置顺序:
1. 立刻记录断点:已完成的章节范围 + 下一个该写的章节
2. 主动向用户报断点:"已写到第 4 章,从第 5 章接着写"
3. 让用户开新对话,把「已完成部分 + 剩余大纲 + 本文种的格式要求」一并带过去
4. 新对话里从断点续写,不重写已完成部分
关键:断点信息要明确到章节号。"写到一半"这种说法用户没法接。
第三式:只重做受影响的那一步(部分失败)
症状:多步骤任务里某一步失败(如内容已生成但排版失败、评分失败但文档正常)。
处置顺序:
1. 先判断:失败的是「必要步骤」还是「附加步骤」
- 必要步骤(生成内容 / 输出文档)→ 必须重做
- 附加步骤(评分 / 格式校验 / PDF 转换)→ 可跳过并告知
2. 只重跑失败的那一步,不从头再来
3. 附加步骤失败时,在交付说明里注明"该项未完成",其余照常交付
为什么不一键重来:重跑全部步骤会把已完成的内容重新生成一遍, 既浪费时间,还可能让已经确认好的内容发生变动(用户可能已经改过)。
三式速查(含照抄即用的命令)
| 症状 | 用哪一式 | 照抄这条命令 / 动作 | 先自己试还是先问 |
|---|---|---|---|
| 文件找不到 / 打不开 | 第一式 · 换路径 | python scripts/formatcheck.py "完整绝对路径.docx";仍报 [SE2] 就跑 python scripts/preflightcheck.py | 先自己试(4 步) |
| 生成中断 / 上下文超限 | 第二式 · 无缝续写 | 记录「已写到第 N 章」→ 开新对话带「已完成 + 剩余大纲」 | 主动报断点,再请用户配合 |
| 评分不对 / 章节误判 | 第三式 · 只重做该步 | python scripts/quality_score.py 文档.docx --type 年度工作总结(补 --type 即可纠正) | 附加步骤可直接跳过并告知 |
| PDF 转不出来 | 第三式 · 只重做该步 | python scripts/pdf_export.py 文档.docx --method libreoffice --timeout 300;再不行手动导出 | 附加步骤可直接跳过并告知 |
脚本参数速查表(Y-2:要改哪里、怎么改)
为什么单列一节:脚本报告有时会说"某段偏离标准",但没告诉你参数在哪改。 下面把所有可调项一次列清——先看"你想干什么",再到对应行找命令。
零、最常用的四条命令
# 生成文档后,一次跑完格式校验 + 质量评分
python scripts/format_check.py 你的文档.docx
python scripts/quality_score.py 你的文档.docx
# 文件打不开时,先试这个(探测环境与可用通道)
python scripts/preflight_check.py
# 要 PDF 时,先探测有没有转换引擎
python scripts/pdf_export.py --check
一、format_check.py(格式校验 / 排版层)
| 你想干什么 | 命令 | 说明 |
|---|---|---|
| 检查一份文档 | python scripts/format_check.py 文档.docx | 默认输出通过项/提示项/问题项 |
| 只看问题,不看通过项 | python scripts/format_check.py 文档.docx --quiet | 排障时用,输出最短 |
| 给程序读(生成 JSON) | python scripts/format_check.py 文档.docx --json | 交给别的工具处理 |
| 看脚本版本与运行环境 | python scripts/format_check.py --version | 排障先看这个 |
参数就这几个,没有更复杂的选项。报告里说"某段偏离",对应的是 「行距(正文/标题)」「首行缩进」「页边距」这几类,改文档本身即可, 不需要改脚本。
二、quality_score.py(质量评分 / 文本层)
| 你想干什么 | 命令 | 说明 |
|---|---|---|
| 给文档打分 | python scripts/quality_score.py 文档.docx | 五维 100 分制 |
| 告诉脚本这是什么文种 | --type 年度工作总结 | 最重要的一项,见下方类型表 |
| 写的是草稿,占位符别扣分 | --draft | 跳过占位符检查 |
| 只看问题项 | --quiet | 简洁输出 |
| 看全部检查项(含通过) | --verbose | 想彻底了解扣分来源时用 |
| 生成 JSON | --json | 程序化取用 |
支持的 13 种类型(--type 的值,照抄即可):
年度工作总结 / 述职报告 / 党建报告 / 调研报告 / 工作方案 / 整改方案
会议纪要 / 通知 / 请示 / 汇报材料 / 转发性公文 / 批复 / 制度标准
不指定
--type会怎样:脚本会自己猜(看标题关键词)。 猜错的后果是"章节完整性"扣分不对——比如把「工作方案」猜成「年度工作总结」, 就会要求你写"工作亮点""存在问题"这些方案里本来没有的章节。 所以文种明确时,建议显式指定。
三、policy_cite.py(政策引用核查)
| 你想干什么 | 命令 | 说明 |
|---|---|---|
| 查引用有没有问题 | python scripts/policy_cite.py 文档.docx | 检 7 类问题(缺文号/缺日期/括号/待补/书名号/异称/年份) |
| 生成溯源表并保存 | python scripts/policy_cite.py 文档.docx --save 溯源表.md | 输出可交付的政策引用清单 |
| 只看问题项 | --quiet | |
| 生成 JSON | --json |
四、pdf_export.py(PDF 转换)
| 你想干什么 | 命令 | 说明 |
|---|---|---|
| 先看有没有转换通道 | python scripts/pdf_export.py --check | 转之前先跑这个,别直接转 |
| 转换(自动选通道) | python scripts/pdf_export.py 文档.docx | 默认 --method auto |
| 指定用 Word 通道 | --method word | 需装 Microsoft Word |
| 指定用 LibreOffice 通道 | --method libreoffice | 需装 LibreOffice |
| 指定输出路径 | --out 输出.pdf | 默认与源文件同目录同名 |
| 转换卡住 / 超时 | --timeout 300 | 默认 180 秒,机器慢或文档大就放宽 |
| 只看结论 | --quiet |
失败会自动换通道重试一次(auto 模式且本机有两个通道时),重试过程会打印
[SE6]提示, 不会静默换掉你知道的通道。
五、表格:常见报错 → 改哪个参数
这张表是本节的核心。左边是脚本报的话,右边是你要动的地方。 报错行首的
[SE1]~[SE9]是脚本技术码,含义见references/faq.md第三部分。
| 脚本报的话 | 实际含义 | 你要改什么 |
|---|---|---|
[SE1] 缺少待检查的文件 / [SE1] 未识别的报告类型 | 参数没给或 --type 拼错 | 补文件路径;--type 照抄速查表里的文种名 |
[SE2] 文件不存在 / [SE2] 不是有效文件 | 路径写错 / 指向文件夹 | 换绝对路径 → 去引号 → 含空格加双引号 |
[SE3] 源文件不是 Word 文档 | 格式不对(PDF/图片/md) | 先另存为 .docx |
[SE4] 没有可用的转换通道 | 本机没装 Word/LibreOffice | 装 Office 或走手动导出 |
[SE5] 目标 PDF 已存在且无法覆盖 | 同名 PDF 被打开着 | 关掉 PDF 阅读器,或换 --out |
[SE6] 转换超时 / 自动换通道重试 | 单通道超时(默认 180 秒) | 加 --timeout 300;仍超时改手动导出 |
[SE7] 解析失败 | docx 结构损坏 / 编码不支持 | Word 打开另存一次再跑 |
[SE8] 未产出结果 / 文档内容过少 | 跑完了但没结果 | 查输出目录权限;确认正文不是纯图片 |
[SE9] 脚本内部异常 | 未归类的意外 | 先跑 preflight_check.py,再把报错反馈 |
❌ 行距(正文): N 段偏离 28 磅 | 正文段落行距不是固定值 28 磅 | 文档里把正文段落行距设为固定值 28 磅 |
❌ 行距(标题): N 段偏离 30 磅 | 标题段落行距不是固定值 30 磅 | 标题段落设为固定值 30 磅 |
❌ 首行缩进: N 段缩进值异常 | 缩进不是 2 字符(约 400-700 twips) | 设为首行缩进 2 字符 |
❌ 页边距 xxx: 当前 X cm, 应为 Y cm | 页边距不符国标 | 设为 上3.7 / 下3.5 / 左2.8 / 右2.6 cm |
❌ 标题字体: xxx, 应为方正小标宋简体 | 标题字体不对 | 标题字体设为方正小标宋简体 |
❌ 页码: 字体非宋体... | 页码字体/字号/对齐不符国标 | 页码设为 4 号宋体,单页码居右、双页码居左 |
❌ 年份括号: 发现使用方括号[] | 年份用了 [2026] | 改成六角括号 〔2026〕 |
⚠️ 数字字体: 未设置 Times New Roman | 建议项,不强制 | 数字设为 Times New Roman(可选) |
未识别报告类型 | 猜不出文种,按默认章节判分 | 加 --type 你的文种 |
章节缺失: 工作亮点 | 报了你文档里本来就该没有的章节 | 多半是类型猜错,加 --type 纠正 |
未替换占位符 N 处 | 正文里还有 XX | 补全内容;草稿加 --draft |
未检测到 Word/WPS/LibreOffice | 本机没有转换引擎 | 先跑 --check;无引擎走三条降级路径(见 PDF 前置条件节) |
源文件正被占用 | 文档还开着 | 先关掉 Word/WPS 里的这个文档再转 |
路径不存在 / 无法打开 | 路径问题 | 用绝对路径 + 去掉引号 + 含空格加双引号(见 L-6 第一式) |
六、三个"改文档"与"改参数"的区分
| 报错类型 | 改哪儿 | 例子 |
|---|---|---|
| 文档内容/版式问题 | 改文档,不改命令 | 行距、缩进、字体、括号 → 都是文档的事 |
| 脚本判断口径问题 | 加参数 | --type(文种)、--draft(草稿)、--method(通道) |
| 环境问题 | 改环境 | 没装 Office → 换电脑或手动导出(不能靠参数解决) |
一句话:加参数只解决"脚本判错了",不解决"文档写错了"。 看到行距/字体/缩进类报错,直接去改文档;看到章节/类型/占位符类报错,才考虑加参数。
参考资料索引
| 文件 | 内容 | 何时加载 |
|---|---|---|
references/gb-t9704-format.md | GB/T 9704-2012 完整排版规范 + 参数速查表 + 常见错误 | 生成 Word 文档时必加载 |
references/report-templates.md | 38 类模板框架 + 写作要点(8 种工作模板 + 7 种行政公文 + 10 种专题模板 + 信函式 + 应急预案/议程/慰问信/专项总结/联合行文/转发性公文/请示批复联动/制度办法标准 + 通报/公示/感谢信与贺信/会议方案) | 确定报告类型后加载对应章节 |
references/vocabulary-guide.md | 政治术语规范、词汇分类、句型库、52项表述问题检查清单 | 涉及措辞润色时加载;涉及安全审查时必加载 |
references/expression-library.md | 历年常用表述库:成效/问题/部署/表态/结语五类语境高频表述 + 口语替换表 | 措辞润色时加载,搭配语境选用 |
references/case-examples.md | 典型案例库:HR/财务/党建/安全/科研五条线范文片段 + 专业点评 + 可复用句式 | 条线明确或需要范文参考时加载 |
references/ai-traces.md | AI 痕迹 12 类检测规则 + 公文特有 AI 味检测 | 审校阶段加载 |
references/polishing-guide.md | 篇章级润色指南:语病识别(含公文高频搭配不当 5 类)/句式优化/过渡自然化/数据一致性检查 | 内容>500字时审校阶段必加载 |
references/policy-database.md | 常用政策文件速查 + 引用格式规范 | 涉及政策引用时加载 |
references/policy-citation-guide.md | 政策引用溯源规范:引用式样、四种标识写法、来源优先级、时效性四步核验、三种占位写法 | 涉及政策引用格式与溯源时加载 |
references/capability-matrix.md | 能力边界自评矩阵 + 失败案例库 + 协作工具版本矩阵 | 边界判断 / 协作工具版本校验时加载 |
references/faq.md | 30 条高频 Q&A(按你会怎么问分组)+ 12 条反模式清单 + SE1-SE9 脚本错误码对照 | 遇到问题第一个查这里;不确定怎么用也查这里 |
references/troubleshooting.md | 深度排障参考:素材转换完整步骤(Windows/macOS/手机逐按钮)+ E1-E13 完整规则(含"为什么会这样")+ 静态检查盲区说明(X-6)+ 字体获取安装 | 遇到报错 / 要转换非文字素材 / 想了解检查局限时加载 |
references/quality-scoring.md | 公文质量评分标准:五维 100 分制判定细则、扣分标准、分档说明、典型病例 | 执行质量评分时加载;脚本不可用时人工对照 |
scripts/quality_score.py | 内容质量自动评分(五维 100 分 + 问题清单 + 改进建议),支持 docx/md/txt;已支持 13 种报告类型(含制度标准) | 生成文档后可选执行,与 format_check.py 互补(文本层 vs 排版层) |
scripts/format_check.py | 自动检查 DOCX 格式是否合规 | 生成文档后可选执行 |
scripts/policy_cite.py | 政策引用溯源校验:抽出全文 《》 引用,检查发文字号/日期/括号格式/待补占位,并可生成政策引用溯源表(--save) | 引用 ≥3 处或涉及重要依据时执行 |
scripts/pdf_export.py | PDF 一键直出:自动选 Word/LibreOffice 通道转换,并实测校验页数与字体嵌入状态;--check 只探测通道 | 用户要求 PDF 时执行 |
scripts/preflight_check.py | 环境与文件完整性自检(Python 版本 / 根目录文件 / references 14 项 / 脚本语法 / 模板挂接数 / 国标字体四槽位),支持 --json、--quiet、--root | 开始写公文前跑一次;排障时定位缺失文件 |
同分类其他技能
查看全部 ›腾讯文档(docs.qq.com)-在线云文档平台,是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文
335 262.3万 WPS Office 全家桶WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/纯Python)智能识别用户已安装软件,纯
182 109.3万 ppt-generator-skill智能 PPT 生成助手。根据用户描述的主题、行业、风格,自动生成漂亮的 PPT 文件。支持所有行业(商务、教育、科技、医疗、金融、创意等
378 91.6万 腾讯文档在线协作自动化通过 Tencent Docs Open API 以 curl + jq 创建、读取、列出、搜索和管理腾讯文档的自动化工作流,覆盖在线文
0 85.8万 WPS Office 全家桶WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/纯Python)智能识别用户已安装软件,纯
5 81.6万 秘书材料星公文写作-妙笔skill体制内资深办公室主任+管理学博士,自学编程开发的智能公文写作Skill,让所有办公室同仁少掉头发、少加无用的班,材料一稿过关,省下的时间
50 77.2万