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 格式),按其中说明在我的环境里完成安装和配置。