gongwen-format-skill
面向AI Agent的确定性公文排版工具,输入Markdown或JSON,输出标准格式Word文档。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:gongwen-format-skill。 它的用途是:面向AI Agent的确定性公文排版工具,输入Markdown或JSON,输出标准格式Word文档。 完整的 Skill 内容见:https://321skill.com/skills/gongwen-format-skill/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“根据这份会议纪要,起草一份发给各部门的《关于召开年度总结大会的通知》。” AI会先整理出通知内容,然后调用此Skill,将内容按受控Markdown格式(包含主送机关、落款等Front Matter)输出,并最终生成一个可直接下发、格式完全合规的Word文档。
介绍
gongwen-format-skill 解决了AI Agent(如Claude Code、Codex)在自动化生成公文时,难以稳定输出符合国家公文格式标准Word文档的痛点。它通过定义一套受控的Markdown或JSON输入协议,将AI生成的结构化内容,利用python-docx库精确、稳定地渲染为符合公文排版规范(如字体、字号、行距、标题层级、页码等)的.docx文件。
使用方式非常直接:用户只需按照其定义的受控Markdown规范(包含YAML Front Matter)或JSON格式组织内容,然后通过简单的命令行脚本即可一键生成公文。对于AI Agent,它作为一个Skill被集成,AI可以调用它来格式化自己的输出。
这个工具特别适合需要批量、自动化生成正式公文、通知、报告的单位或开发者,例如政府文秘、企业行政、法律合规或任何需要将结构化数据(如数据库记录、API响应)转换为标准公文格式的场景。它让AI在公文写作这类对格式有严格要求的任务中,具备了可靠的“落地”能力。
与通用的Markdown转Word工具或复杂的Word模板引擎相比,gongwen-format-skill的核心区别在于其“确定性”和“轻量专精”。它不做通用Markdown的复杂语义推断,而是通过一套极简、明确的“行首标记”协议,确保每次渲染结果都严格一致且符合公文规范,避免了通用工具因解析歧义导致的格式错乱问题。
核心特点
核心区别在于采用“受控输入协议”而非通用Markdown解析,通过行首标记(如#、##)进行确定性渲染,确保公文格式(如标题层级、主送机关、页码)的绝对稳定和合规,避免了通用转换工具因语义推断导致的格式错乱。
注意事项
不适合需要渲染复杂Markdown元素(如表格、列表、加粗)或自由格式排版的通用文档生成场景,其输入格式有严格约束。
常见问题
这个Skill能处理复杂的表格和列表吗?
不能。它采用受控Markdown协议,不解析通用Markdown的表格、列表、加粗等语法,专注于公文的标准段落和标题渲染。
生成的公文字体在我的电脑上显示不对怎么办?
脚本默认使用“方正小标宋简体”、“仿宋_GB2312”等字体。若未安装,Word会回退到其他字体。建议在目标机器安装相应字体,或修改脚本中的字体常量。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/gongwen-format-skill/raw/index.md 读取 gongwen-format-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/gongwen-format-skill/raw/index.md(查看排版版本)