gongwen-writing-formatting

name	gongwen-writing-formatting
description	按党政机关公文写作与排版规范起草、修改、校对和排版中文公文，并直接生成 .docx Word 文档和/或 .pdf 文件。用户要求公文写作、公文排版、通知/请示/报告/函/纪要等文种起草、按公文格式生成 Word/PDF、检查中文公文是否符合党政机关公文处理和 A4 版式要求时使用。

公文写作排版

第一句话

当用户要求生成可交付文件，但没有明确说明输出格式时，先问一个简短问题：

请问这份公文需要输出 Word（.docx）还是 PDF？也可以说“两者都要”。

如果用户已经说明要 Word、PDF 或两者都要，不要重复询问。

工作流程

1. 先确认输出格式：docx、pdf 或 both。
2. 只补问缺失的关键信息：文种、标题/事由、主送机关、发文机关、成文日期、正文要点、附件、属于上行文/下行文/平行文哪一类。
3. 起草或修改正文时，读取 references/gongwen-standards.md，按其中的文种规则、行文规则、写作要求和排版标准执行。
4. 根据公文内容整理 JSON 规格文件，然后运行 scripts/generate_gongwen_document.py 生成文件。
5. 检查生成文件是否存在；如果生成 PDF，尽量检查页数或抽取文本确认内容正常。
6. 向用户返回生成文件的绝对路径。

生成脚本

使用内置脚本稳定生成 Word/PDF：

python3 /Users/kent/.codex/skills/gongwen-writing-formatting/scripts/generate_gongwen_document.py \
  --spec /absolute/path/spec.json \
  --format docx \
  --out-dir /absolute/output/dir

如果默认 Python 缺少 docx 或 reportlab，先调用 load_workspace_dependencies，使用其返回的内置 Python 运行时。

参数说明：

• --format docx：只输出 Word 文档。
• --format pdf：只输出 PDF。
• --format both：同时输出 Word 和 PDF。
• --print-template：打印 JSON 规格模板。
• --demo：生成一份样例文档，用于测试脚本是否可用。

JSON 规格示例

最小可用规格如下：

{
  "title": "关于开展安全生产检查工作的通知",
  "subtitle": "",
  "issuer_mark": "某某单位文件",
  "doc_number": "某发〔2026〕1号",
  "recipient": "各部门：",
  "body": [
    "为进一步加强安全生产管理，现就有关事项通知如下。",
    "一、检查范围",
    "（一）办公区域。",
    "1. 消防设施、用电安全、应急通道等情况。",
    "二、工作要求",
    "请各部门高度重视，按时报送检查情况。"
  ],
  "signature": "某某单位",
  "date": "2026年5月24日",
  "attachments": [
    {
      "title": "安全生产检查表",
      "content": ["一、基本情况", "二、问题清单", "三、整改措施"]
    }
  ],
  "copy_to": "",
  "print_org": "",
  "print_date": ""
}

默认排版标准

除非用户提供了单位模板或明确要求，否则按以下规则排版：

• 纸张：A4。
• 页边距：上 3.7 厘米、下 3.5 厘米、左 2.8 厘米、右 2.6 厘米。
• 页眉/页脚距离：页眉 1.5 厘米，页脚 2.4 厘米。
• 正文：3 号仿宋，行距 30 磅，约每行 28 个汉字、每页 22 行。
• 标题：2 号小标宋，居中；副标题：3 号楷体，居中。
• 结构层次：一、 用黑体；（一） 用楷体；1. 和 （1） 用仿宋加粗。
• 日期：用阿拉伯数字将年、月、日标全。
• 页码：4 号宋体阿拉伯数字，单面输出时居中编排在页脚。

写作要求

• 使用公文语言：准确、简洁、具体、可执行，避免宣传腔和营销式表达。
• 先判断文种是否正确。不要在报告中夹带请示事项。
• 写请示时，坚持一文一事，明确请求事项，结尾使用规范请批表述。
• 写报告时，只汇报工作、反映情况或答复询问，不提出审批请求。
• 写函时，用于不相隶属机关之间，语气平等、事项明确。
• 写通知时，写清对象、事项、时间要求、材料要求和责任单位。
• 涉及正式发文、密级、法务或合规风险时，只提供起草和排版支持，并提醒用户提交责任部门最终审核。