← 返回 Skills 市场
写材料格式工具
作者
SunShineOrangeJuice
· GitHub ↗
· v1.1.0
· MIT-0
98
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install article-formatter
功能描述
根据调研报告或公文规范模板,将原始文本自动排版成标准.docx格式,支持格式自动识别和参考文件规范应用。
使用说明 (SKILL.md)
写材料格式工具 (article-formatter) v4
将原始文章文本按照「机关公文格式模板」自动排版,输出标准 .docx 文件。支持调研报告、公文等正式材料的写作与格式化。完全自包含,无需外部参考文件。
一、支持的文档类型
调研报告
标准结构(五段式):
- 标题:《关于 ××× 情况的调研报告》
- 导语(前言):调研背景、目的、时间、地点、对象、方式、总体评价
- 主体:
- 基本情况:工作进展、成效、数据、亮点、经验
- 存在问题:条理清晰、实事求是
- 原因分析:主观/客观/制度/机制等方面深入剖析
- 对策建议:针对性、可操作性强
- 结尾:简要总结或展望
- 落款:调研单位 / 调研人、成文日期
写作质量要求:
- 材料扎实,有数据支撑、案例佐证、对比分析
- 问题精准,抓住主要矛盾和关键症结
- 分析深刻,透过现象看本质
- 建议务实,可落地、可执行、可考核
- 条理清晰,多用小标题、序号,层次分明
语言要求:
- 语言准确、简洁、庄重,不用口语、网络语、夸张修辞
- 数据、名称、单位、时间、地名统一规范,前后一致
- 层次序号规范:一、(一)1.(1)①
- 篇幅适中,重点突出,不冗长堆砌
公文
按照《党政机关公文处理工作条例》和《党政机关公文格式》国家标准执行。
总体要求:合规、求实、简洁、规范、严谨
主旨要求:正确、鲜明、集中
- 合法性:符合党的理论路线方针政策和国家法律法规
- 权威性:完整、准确体现发文机关意图
- 唯一性:一文一事,一个中心思想
- 明确性:观点鲜明,态度明朗
内容要求:求实、准确、可行
- 实事求是,数据、事例真实可靠
- 切实可行,政策、措施具体明确
- 材料充分,深入调查研究
结构要求:严谨、完整、清晰
- 版头:份号、密级、紧急程度、发文机关标志、发文字号、签发人
- 主体:标题、主送机关、正文、附件说明、发文机关署名、成文日期、印章
- 版记:抄送机关、印发机关和印发日期、页码
- 开头:开门见山,直接点题
- 主体:条理清晰
- 结尾:简洁有力
语言要求:准确、简洁、庄重、得体
- 定型词组、成语、惯用语中的数字用汉字(一律、一方面等)
- 公历世纪、年代、年、月、日和计数、计量用阿拉伯数字
- 不用歧义、模糊、夸张、比喻、拟人等文学化表达
二、排版格式规范(2024写材料格式模板)
| 元素 | 字体 | 字号 | 对齐 | 特殊 |
|---|---|---|---|---|
| 标题 | 方正小标宋_GBK | 二号(22pt) | 居中 | 不加粗 |
| 汇报单位名称 | 方正楷体_GBK | 三号(16pt) | 居中 | 不加粗 |
| 日期 | 方正楷体_GBK | 三号(16pt) | 居中 | 不加粗 |
| 一级标题 | 方正黑体_GBK | 三号(16pt) | 左对齐 | 不加粗 |
| 二级标题 | 方正楷体_GBK | 三号(16pt) | 左对齐 | 不加粗 |
| 正文 | 方正仿宋_GBK | 三号(16pt) | 左对齐 | 固定行距30磅,段前段后0行 |
| 数字/英文 | Times New Roman | 同对应段落 | - | 混排时单独设置 |
页面设置
- 上边距:3.7 cm
- 下边距:3 cm
- 左边距:2.8 cm
- 右边距:2.8 cm
- 页眉:1.5 cm
- 页脚:2.2 cm
- 字符网格:每行44字,每页23行
页码
- Times New Roman 四号(14pt)
- 格式:
— 1 —、— 2 —、— 3 —…… - 位置:页面底部居中
三、使用方式
对话中直接使用
发送草稿内容,格式随意,我会自动识别标题层级和文档类型:
标题:关于XXX的调研报告
汇报单位:XX部门
日期:2024年1月1日
# 一、调研背景
...
## (一)基本情况
...
## (二)存在问题
...
## (三)原因分析
...
## (四)对策建议
...
二、结尾
三、落款
或者直接描述需求,我来撰写完整内容再格式化。
文档类型自动识别
- 内容含「调研」「调查」「走访」「座谈」「问卷」→ 按调研报告结构
- 内容含「请示」「通知」「报告」「函」「决定」「公告」「批复」→ 按公文格式
- 其他情况 → 通用文章格式
输出路径
- 默认输出:
~/Desktop/openclaw专属文件夹/ - 自定义输出:
-o /path/to/output.docx
四、技术实现
- 核心工具:
python-docx - 格式解析:正则 + 层级规则 + 文档类型识别
- 输出格式:
.docx(Word 2007+ / Office Open XML) - 完全自包含:参考文件内容已内嵌,无需外部文件
注意
- 方正字体在 Windows+Office 环境下显示最佳
- macOS/WPS 用户字体会有 fallback,但格式参数(字号/间距/边距/页码)准确
- 可手动指定文档类型:
-t research/-t official/-t general
安全使用建议
考虑安装/使用前的几点建议:
1) 依赖:确保运行环境有 Python 和 python-docx 库(SKILL.md 提到 python-docx,但该依赖未在元数据或 install spec 中声明)。
2) 不一致性:SKILL.md 写“完全自包含”,但脚本 docstring 暗示会“自动加载参考规范文件”。请确认完整脚本(清单显示脚本被截断)是否会读取额外本地文件或文件夹——如果会,检查这些路径和文件来源是否可信。
3) 文件写入:默认会在 ~/Desktop/openclaw专属文件夹/ 创建并保存 .docx,若不希望写到桌面请用自定义 -o 路径;注意不要提供敏感目录作为输出路径。
4) 字体与渲染:脚本使用多种“方正”字体,若系统无这些字体,Word 会回退渲染,格式可能与预期不同,这属于正常兼容性问题。
5) 完整性审查:因代码文件在清单展示时被截断(CLI 部分未完整显示),建议在信任并安装前请求/检查完整的 scripts/format_article.py 源码,确认尾部 CLI 逻辑没有额外的网络、外部文件读取或不当行为。
总体判断:功能与描述大体一致,但上述不一致与源码未完整可见带来不确定性——若你打算用于敏感环境,请先验证依赖与完整源码再决定是否安装/授予执行权限。
功能分析
Type: OpenClaw Skill
Name: article-formatter
Version: 1.1.0
The skill is a legitimate utility designed to format text into official Chinese government document styles (e.g., research reports and official memos) and export them as .docx files. Analysis of `scripts/format_article.py` shows it uses the standard `python-docx` library to handle complex formatting requirements like mixed-font rendering (Times New Roman for numbers/English and FangZheng fonts for Chinese) and specific page numbering. There is no evidence of data exfiltration, network activity, or malicious execution; the script operates entirely on provided input and saves output to a clearly defined local directory (`~/Desktop/openclaw专属文件夹/`).
能力评估
Purpose & Capability
技能名称/描述与包含的脚本功能(将文本排版成 .docx)匹配。小问题:SKILL.md 声称“完全自包含,无需外部参考文件”,而脚本文档字符串提到“自动加载参考规范文件(文件格式要求文件夹)”,两者自相矛盾。脚本依赖 python-docx,但依赖未在 metadata 或 install spec 中声明。
Instruction Scope
运行说明限定为接收文本、自动识别文档类型并生成 .docx,默认把文件写到用户桌面下的专属文件夹,支持自定义输出路径。指令没有要求读取系统凭证、网络上传或访问系统范围内的配置文件。唯一需要注意的是允许用户指定任意输出路径(正常需求,但意味着可写任意位置)。
Install Mechanism
没有 install spec(instruction-only / script-included),这是低风险。但脚本需要 python-docx(以及运行 Python 环境),这些依赖未声明。缺少依赖声明会导致运行时不确定性(agent/环境可能需要安装额外包),应在 metadata 中列明。
Credentials
不请求任何环境变量、凭据或配置路径,对秘密/凭证访问无要求,权限需求与功能相称。
Persistence & Privilege
flags 显示 always: false,允许被用户调用且可被模型自主调用(平台默认)。脚本不会修改其他技能或系统设置,只是在用户文件夹中写入输出文件,权限范围有限。
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install article-formatter - 安装完成后,直接呼叫该 Skill 的名称或使用
/article-formatter触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
完全自包含,参考文件内容内嵌,无需外部依赖
v1.0.0
初始版本
元数据
常见问题
写材料格式工具 是什么?
根据调研报告或公文规范模板,将原始文本自动排版成标准.docx格式,支持格式自动识别和参考文件规范应用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 98 次。
如何安装 写材料格式工具?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install article-formatter」即可一键安装,无需额外配置。
写材料格式工具 是免费的吗?
是的,写材料格式工具 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
写材料格式工具 支持哪些平台?
写材料格式工具 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 写材料格式工具?
由 SunShineOrangeJuice(@sunshineorangejuice)开发并维护,当前版本 v1.1.0。
推荐 Skills