[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-96172":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":38,"readmeContent":39,"aiSummary":40,"trendingCount":15,"starSnapshotCount":15,"syncStatus":41,"lastSyncTime":42,"discoverSource":43},96172,"gongwen-gbt9704-skill","mizzlelover\u002Fgongwen-gbt9704-skill","mizzlelover","跨平台中文公文排版 Skill，生成参照 GB\u002FT 9704-2012 的可编辑 DOCX","https:\u002F\u002Fx.com\u002Fdboy_yi2025",null,"JavaScript",469,96,105,0,198,55.96,"MIT License",false,"main",true,[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"ai-skill","chinese-official-document","claude-code","cross-platform","document-formatting","docx","gbt-9704-2012","kimi","opencode","trae-code","traework","word","workbuddy","wps","zcode","2026-09-20 04:01:32","# Gongwen GB\u002FT 9704-2012 Skill\n\n一个面向中文正式材料的 Skill：生成参照 GB\u002FT 9704-2012 的公文版式 DOCX，并提供可选的格式核验清单。\n\n## 为什么需要它\n\n许多 AI 只会把标题设为黑体、正文设为仿宋，便把输出称为“公文”。本项目把 A4、版心、正文、层次、首页和页码等版式参数做成可生成、可检查的 DOCX 输出，并接受用户提供的机构名称、文号、署名、日期和页码模式。\n\n## 项目缘起\n\n![公文排版 Skill 项目头图](punk-assets\u002Fpunk-cover\u002Fgongwen-skill-x\u002Fcover.png)\n\n### 我把自己常用的公文排版 Skill 开源了\n\n我最早注意到 Skill，是 Claude Code 推出这个概念的时候。那时官方有一套 Office 相关的能力，用起来的第一感觉很好。以前让 AI 写完一份材料，常常还要把内容转成 Python，再自己补一段脚本去生成 Word。现在至少有了一个入口，生成的样式会比裸写一段提示词规整得多。\n\n![从 AI 到 Word 的整理流程](punk-assets\u002Fpunk-cover\u002Fgongwen-skill-x\u002Finline-ai-to-word.png)\n\n后来真正拿来干活，事情没有这么简单。\n\n它能把 Word 读进去，也能再转回 Word，可原文件里那些我在意的格式经常留不住。标题层级、段前段后、缩进和页脚，拿到新文件里还得重新排。对不少国内企业来说，这已经够麻烦了。\n\n还是得自己调。\n\n事业单位和国企的正式材料更严，差几毫米、少一个页码规则，文件就很难往下走。\n\n我开始自己调版式，才发现这些细节比想象中散。WPS 和 Office Word 看着能互相打开，字体命名却不总在同一套规则里。有的环境认中文字体名，有的认英文名。一个文件在电脑上排得好好的，换个环境，字号、行距和换行都有可能变样。\n\n![字体兼容带来的版式差异](punk-assets\u002Fpunk-cover\u002Fgongwen-skill-x\u002Finline-font-compatibility.png)\n\n总有一处露馅。\n\n后来 Kimi 推出客户端，我有一次把材料交给它，没特地交代公文格式。它自己去检索相关国标，顺手拼出了一份接近标准的版式。字体处理得不错，效果也比我预期好。我猜它读到了我原先 Kimi 环境里灵魂文件中的要求，但这只是我对当时行为的判断。\n\n![从标准参数到文档版式](punk-assets\u002Fpunk-cover\u002Fgongwen-skill-x\u002Finline-standard-to-layout.png)\n\n那次结果让我意识到，公文格式这件事确实适合做成 Skill。很多重复动作可以交给工具，用户也不必每次从页边距和字体名称重新讲起。\n\n不过接着用下来，问题还是陆续冒出来。缩进、边距、段间距和页码，往往各自看着差不多，合到一份文件里就不够准。市场上可能早就有人做过公文 Skill，我自己做项目时顺手让 AI 生成了这一套，也一直没有专门去装别人的。\n\n用得越多，我越不想靠“看起来像”过关。前些天我把 GB\u002FT 9704-2012 逐项拿出来核了一遍，也把发现的问题逐个补进了 Skill。现在它会把常用的页面、字体、标题、正文、层级、机构名称、文号、署名、日期和页码排进可编辑的 DOCX，方便在 Word 或 WPS 里继续处理表格、附件和盖章位置。\n\n我把这套 Skill 开源，是想让它从我自己的电脑里走出来。它现在可以安装到 Codex、Claude Code、OpenCode、Trae Code、Kimi、TraeWork、WorkBuddy 和 ZCode。各个平台读的是同一份规则，后续修改也不用在七八个目录里反复补。\n\n![同一套规则服务多个 AI 工具](punk-assets\u002Fpunk-cover\u002Fgongwen-skill-x\u002Finline-one-source-many-tools.png)\n\n它很小，却是我的刚需。很多时候，一份材料能不能顺利交出去，卡的就是这些平时没人愿意盯的细节。\n\n如果你也在做中文正式材料，欢迎试试看。遇到问题可以直接反馈给我，我会继续把它改得更稳。\n\n项目地址\n\nhttps:\u002F\u002Fgithub.com\u002Fmizzlelover\u002Fgongwen-gbt9704-skill\n\n标准依据\n\nhttps:\u002F\u002Fstd.samr.gov.cn\u002Fgb\u002Fsearch\u002FgbDetailed?id=lOIe27f77QU%3D&mode=p\n\n## 2.0 重大更新\n\n2.0 重新核验了红头场景、首页预留、红线下标题间距、Word\u002FWPS 标题样式、目录引用、特殊格式和跨平台安装，并完成 18 份 DOCX、37 个 PNG 页面和版头坐标量测。完整的更新说明见[2.0 重大更新文章](marketing\u002Fx-major-update.md)；文章、4 张新版插图和实际验证截图的合稿预览见[2.0 图文排版预览](marketing\u002Fx-major-update-layout-preview.md)。上一版记录仍保留在[红头规则更新说明](marketing\u002Fx-v2-release.md)。\n\n公众号发布可直接使用[2.0 公众号 HTML](marketing\u002Fwechat-gongwen-2.0.html)：在浏览器打开后全选复制，再粘贴到公众号编辑器。\n\n## 作者与同名内容 IP\n\n这个项目由“谁是专家”持续维护。相关内容会记录 AI 工具、公文排版、正式材料和实际使用中的问题，欢迎从下面的入口找到我。\n\n- 小红书：[谁是专家](https:\u002F\u002Fwww.xiaohongshu.com\u002Fuser\u002Fprofile\u002F64dd6c680000000001011d25)\n- X：[谁是专家](https:\u002F\u002Fx.com\u002Fdboy_yi2025)\n- 微信公众号：微信搜一搜“谁是专家”\n\n![微信公众号“谁是专家”二维码](punk-assets\u002Fauthor\u002Fwechat-who-is-expert.png)\n\n## 关键词\n\n`公文排版` `GB\u002FT 9704-2012` `DOCX` `Word` `WPS` `Claude Code` `OpenCode` `Kimi` `Trae Code` `TraeWork` `WorkBuddy` `ZCode` `AI Skill` `中文正式材料`\n\n## 能力与边界\n\n| 场景 | 本项目的处理方式 |\n| --- | --- |\n| 文档主体 | A4、版心、标题、正文、层次、署名和日期排版 |\n| 普通报告、方案、汇报 | 默认 `ordinary`，不因机构名称自动使用红头 |\n| 正式发文与红头纸 | 显式 `formal`；默认预印红头纸套打，首面留白、不重绘红色机关标志和红线 |\n| 完整电子红头 | 显式 `formal --letterhead digital`，才在 DOCX 中绘制红头要素 |\n| 机构名称与文号 | 使用 `--org`、`--doc-no` 按对应版式定位；正式版式会拒绝明显不符合年份、六角括号、顺序号和“号”规则的文号 |\n| 标题与目录 | 四级标题写入 Word\u002FWPS 标题样式及大纲级别，可插入自动目录 |\n| 页码 | 居中、单双页或不显示 |\n| 印章、签名章 | 在生成的 DOCX 中按实际需要插入图片或完成实体盖章 |\n| 特定格式 | `letter`、`command`、`minutes`、`horizontal-table` 使用对应生成分支；联合行文用 `--joint-org`，分离装订附件用 `--attachment-detached` |\n\nGB\u002FT 9704-2012 当前为现行标准，2025-05-30 复审继续有效。标准适用于党政机关制发公文，其他机关和单位可以参照执行。[全国标准信息公共服务平台](https:\u002F\u002Fstd.samr.gov.cn\u002Fgb\u002Fsearch\u002FgbDetailed?id=lOIe27f77QU%3D&mode=p)\n\n## 快速开始\n\n```bash\nnode scripts\u002Fgenerate_gongwen_docx.mjs --input tests\u002Ffixture.md --output \u002Ftmp\u002Fgongwen.docx --format ordinary --title \"公文格式回归测试\"\nnode scripts\u002Fverify_gongwen_docx.mjs --input \u002Ftmp\u002Fgongwen.docx --profile ordinary\n```\n\n需要正式发文时，必须明确选择版式。下面的命令生成预印红头纸套打稿；首页只留出纸上已有红头和红线区域，DOCX 不会重绘它们。`--letterhead-reserve-mm` 表示纸张上边缘到预印机关标志区域起点的高度，生成器随后保留两行 28 磅版心空行再排变量文号，标题前再保留红线下两行空行。`72` 是默认值，应按本单位实际红头纸改为 `37—130` 毫米。\n\n```bash\nnode scripts\u002Fgenerate_gongwen_docx.mjs --input tests\u002Ffixture.md --output \u002Ftmp\u002Fformal.docx --format formal --letterhead preprinted --letterhead-reserve-mm 72 --org \"示例单位文件\" --doc-no \"示例发〔2026〕1号\" --title \"公文格式回归测试\"\nnode scripts\u002Fverify_gongwen_docx.mjs --input \u002Ftmp\u002Fformal.docx --profile formal --letterhead preprinted\n```\n\n只有需要完整电子红头文件时，才加 `--letterhead digital`。红头和标题要使用目标电脑中实际安装的小标宋体；生成器缺少小标宋体或仿宋体时会在终端明确警告并写出替代字体，要求严格阻止替代输出时加 `--require-standard-fonts`。红线下标题会写入两个显式的28磅版心空行，不会依赖渲染器自行解释段前距；发文机关标志到文号也按相同方式留出两行。上行文的文号和签发人会在同一行编排。打开文档后，Word\u002FWPS 的“引用→目录”可以按“标题1—标题4”生成并更新目录；是否显示第四级，在目录设置中选择。\n\n信函、命令（令）、纪要和横排表格走专用分支：信函生成170mm上粗下细、下页边20mm处上细下粗的两条红色双线，底线放在页脚并关闭页码；命令（令）落实机关标志距版心上边缘20mm、令号下空二行、正文下空二行；纪要把“出席”“请假”“列席”标签设为黑体、人员名单设为仿宋，并放在正文或附件说明下一行；横排表格生成横向A4和225mm表格，单双页表头方向仍需目标Word\u002FWPS模板核对。联合行文可重复传入 `--joint-org`，生成主办机关在前、联署机关名称分行排列；输入含“文件”时将“文件”置右并上下居中的标志；不能与正文一起装订的附件加 `--attachment-detached` 会在首行补排文号和附件序号。附件可用重复的 `--attachment-file` 另页生成“附件”标签、第三行标题和正文，并保持正式页码连续。带抄送或印发信息时，版记浮动锚定在最后一页版心底部，首末粗线约0.35mm、中间细线约0.25mm。\n\n## 跨平台安装\n\n本项目使用开放的 `SKILL.md` 目录结构，可在 Codex、Claude Code、OpenCode、Trae Code、Trae CLI、Kimi Code CLI、Kimi Code、TraeWork、WorkBuddy 和 ZCode 使用。\n\nmacOS \u002F Linux：\n\n```bash\nscripts\u002Finstall.sh --all\n```\n\nWindows：\n\n```powershell\n.\\scripts\\install.ps1 -All\n```\n\n安装器将同一份源目录链接到各平台的用户级技能目录；Windows 默认复制以避免符号链接权限问题。TraeWork 使用可导入包 [`dist\u002Ftraework-gongwen-skill.zip`](dist\u002Ftraework-gongwen-skill.zip)。完整目录、验证方法和官方依据见[跨平台安装说明](docs\u002Fplatform-support.md)。\n\n## 项目内容\n\n- [SKILL.md](SKILL.md)：使用指引与版式参数。\n- [标准执行摘要](references\u002Fgbt9704-2012-summary.md)：国家标准的可执行要点。\n- [逐条执行矩阵](references\u002Fgbt9704-audit-matrix.md)：按条款记录自动生成、结构校验和必须人工复核的边界。\n- [正式公文核验表](references\u002Fformal-checklist.md)：模板完成后的全要素检查。\n- [生成器](scripts\u002Fgenerate_gongwen_docx.mjs)：根据输入生成 DOCX 版式。\n- [校验器](scripts\u002Fverify_gongwen_docx.mjs)：检查生成器可承诺的 DOCX 版式要素。\n- [回归测试](tests\u002Frun_tests.sh)：运行居中与单双页页码生成、DOCX 包结构与 PDF 转换验证。\n- [全条款视觉核验](references\u002Fgbt9704-visual-audit.md)：实际生成 18 份 DOCX、37 个 PDF 页面和 PNG，并逐条记录截图证据与人工边界。\n- [全条款截图证据矩阵](references\u002Fgbt9704-screenshot-evidence.md)：把 GB\u002FT 9704-2012 每个条款绑定到实际截图，明确哪些项目截图不能证明。\n- [版头坐标量测](tests\u002Fmeasure-header-coordinates.mjs)：用 PDF 字形坐标独立核对份号首行、机关标志 35 mm 定位及可选字段不移位。\n- [跨平台安装测试](tests\u002Ftest-install.sh)：隔离环境中验证九个本地目录和 TraeWork 导入包。\n\n## 验证\n\n```bash\ntests\u002Frun_tests.sh\n# 需要截图核对时，再运行完整视觉审计\nbash tests\u002Fvisual-audit.sh \u002Ftmp\u002Fgongwen-visual-audit\n```\n\n如果要把字体替代也视为失败，可在生成器和校验器上同时加 `--require-standard-fonts`；当前电脑没有小标宋体或标准仿宋体时，命令会停止并明确列出缺失字体。\n\n这项测试证明生成器、校验器和可打印文件链路可运行。视觉审计会把每个场景转成 PDF 和 PNG，按截图检查版头、标题间距、首页正文、单双页页码、附件和版记。最终文件仍须按实际用途在目标 Word\u002FWPS 与打印条件中检查。\n\n## 许可\n\nMIT。标准文本及机关模板应按各自权利和管理规则取得与使用。\n","这是一个专为中文公文排版设计的跨平台AI Skill工具，可生成严格遵循国家标准GB\u002FT 9704-2012的可编辑DOCX文件。核心功能包括自动配置A4纸型、版心尺寸、仿宋_GB2312字体、标题层级样式、红头格式（支持套打与数字红头）、页码规则及首面预留等细节，并提供格式核验清单。技术上采用JavaScript实现，兼容Claude Code、Kimi、WPS、Word等多种AI开发环境与办公平台，确保跨平台排版一致性。适用于党政机关、事业单位及国企等需高频产出合规正式发文、请示、通知、函件等中文公文的办公场景。",2,"2026-09-11 02:30:11","CREATED_QUERY"]