这是一个面向中文正式材料/党政机关公文排版的 AI Skill 与 DOCX 生成工具，核心目标是生成参照 GB/T 9704-2012 的可编辑 Word/WPS 文档。项目不仅提供生成器，还包含格式校验器、标准摘要、执行矩阵、正式公文核验表、视觉审计与跨平台 Skill 安装脚本。它适合在 Claude Code、Codex、OpenCode、Kimi、Trae Code、TraeWork、WorkBuddy、ZCode 等 AI 编程/办公辅助环境中复用同一套公文排版规则，减少每次手工调整页边距、字体、标题层级、页码、红头预留等重复工作。
适用领域
中文公文排版 / 办公自动化 / AI Skill / DOCX 文档生成 / GB/T 9704-2012 标准辅助执行 / Word/WPS 兼容处理 / 政府/事业单位/国企材料处理 / 正式材料模板化生成
配置难度
中等。作为命令行工具使用并不复杂，普通生成只需 Node.js 和简单参数；但要在正式公文场景中正确配置红头预留、字体、文号、联合行文、附件、版记、页码和单位模板，需要理解 GB/T 9704-2012 及本单位实际规范。若要集成到内部系统或多个 AI Skill 平台，则需要一定 Node.js、DOCX、办公自动化和跨平台部署经验。
商业价值
未知
01
技术亮点
- 聚焦中国开发者和中文办公场景，解决通用 AI 生成 Word 文档时“看起来像公文但细节不准”的问题。
- 参照 GB/T 9704-2012，对 A4、版心、标题、正文、层级、署名、日期、页码、红头预留等要素进行规则化生成。
- 支持普通材料、正式发文、预印红头纸套打、完整电子红头、信函、命令、纪要、横排表格等多种分支。
- 生成的是可编辑 DOCX，便于在 Word 或 WPS 中继续修改表格、附件、盖章位置和目录。
- 四级标题写入 Word/WPS 标题样式及大纲级别，方便自动生成目录。
- 提供校验器、回归测试、视觉审计、截图证据矩阵和版头坐标量测，工程化程度高于普通模板项目。
- 跨平台 Skill 安装设计较完整，覆盖 Codex、Claude Code、OpenCode、Trae Code、Kimi、TraeWork、WorkBuddy、ZCode 等多个工具。
- MIT 许可，便于开发者二次集成到内部办公自动化系统或 AI 工作流中。
- 对正式发文场景采取显式选择策略，避免普通报告因机构名称被误生成为红头公文。
02
目标用户
- 需要频繁撰写中文正式材料的机关、事业单位、国企、央企工作人员
- 负责公文、报告、方案、汇报材料排版的办公室、综合部、行政人员
- 希望用 AI 工具生成更规范 Word 文档的中文开发者
- 在 Claude Code、Kimi、Trae、OpenCode、Codex 等环境中构建办公自动化流程的用户
- 为单位内部搭建公文生成、材料排版或智能办公工具的开发团队
- 需要批量生成或校验 DOCX 公文格式的技术人员
03
配置要求
- 运行环境需要 Node.js，仓库主要脚本为 .mjs。
- 目标电脑最好安装公文常用字体，尤其是小标宋体、仿宋体等；缺少标准字体时生成器会警告并使用替代字体。
- 如果不能接受字体替代，应在生成器和校验器中添加 --require-standard-fonts。
- 正式发文必须显式指定 --format formal，项目不会因为传入机构名称而自动切换为红头公文。
- 预印红头纸套打需要配置 --letterhead preprinted，并根据单位实际红头纸设置 --letterhead-reserve-mm，默认示例为 72mm，README 建议范围为 37 至 130mm。
- 完整电子红头需要显式使用 --letterhead digital，并确保目标环境字体与 Word/WPS 渲染效果符合要求。
- 机构名称使用 --org，文号使用 --doc-no；正式版式会校验文号格式，例如年份、六角括号、顺序号和“号”等规则。
- 联合行文可重复传入 --joint-org。
- 分离装订附件可使用 --attachment-detached；附件文件可重复使用 --attachment-file。
- 最终文档仍需在目标 Word/WPS、目标打印机、实际纸张和单位模板环境中复核。
04
适用场景
- 将 Markdown 或 AI 生成的正文内容转换为参照 GB/T 9704-2012 的 DOCX 文件
- 生成普通报告、方案、汇报等正式材料版式
- 生成正式发文版式，包括预印红头纸套打稿和可选完整电子红头
- 处理机构名称、文号、标题、署名、成文日期、页码等公文要素
- 为信函、命令（令）、纪要、横排表格等特殊公文场景生成对应版式
- 通过校验器检查生成文档中可自动验证的版式要素
- 在多个 AI 工具中安装同一份 Skill，让不同平台复用一致的公文排版规则
- 生成带标题样式和大纲级别的 DOCX，方便在 Word/WPS 中自动生成目录
- 对红头位置、首页预留、页码规则、附件、版记等进行回归测试或视觉审计
05
部署与配置
- 确保本机已安装 Node.js，因为生成器和校验器使用 JavaScript/Node 脚本运行。
- 克隆仓库：git clone https://github.com/mizzlelover/gongwen-gbt9704-skill.git
- 进入项目目录：cd gongwen-gbt9704-skill
- 快速生成普通公文示例：node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/gongwen.docx --format ordinary --title "公文格式回归测试"
- 校验生成结果：node scripts/verify_gongwen_docx.mjs --input /tmp/gongwen.docx --profile ordinary
- macOS/Linux 安装到支持的 AI Skill 平台：scripts/install.sh --all
- Windows 安装到支持的 AI Skill 平台：.\scripts\install.ps1 -All
- TraeWork 可使用 dist/traework-gongwen-skill.zip 作为导入包。
- 如需运行测试：tests/run_tests.sh；如需完整视觉审计：bash tests/visual-audit.sh /tmp/gongwen-visual-audit
06
风险与注意事项
- GB/T 9704-2012 是公文格式参考标准，但具体单位可能有内部模板、红头纸、字体、页眉页脚、签批流程等额外要求，不能完全替代人工审核。
- Word 与 WPS、不同操作系统、不同字体安装情况可能导致字号、行距、换行、分页和表格渲染差异。
- 缺少小标宋体、仿宋体等标准字体时，替代字体可能影响正式交付效果。
- 正式公文涉及机关标志、红头、印章、签名章、文号等敏感要素，实际使用需符合本单位权限和管理规定。
- 项目生成和校验的是可承诺的部分版式要素，印章位置、实体盖章、复杂附件、最终打印效果仍需人工确认。
- 横排表格、单双页表头方向等场景 README 明确提示仍需目标 Word/WPS 模板核对。
- 如果被集成进自动发文流程，必须增加权限控制、审计记录和人工确认，避免错误文件对外流转。
- README 中包含较多平台和场景，初次使用者如果不了解公文规则，可能误用 formal、digital letterhead 等参数。
2026-09-12
第22名
新收录 · github_search
