Word Template Filler

Word模板智能填充工具。解析Word模板中的{{占位符}}，AI生成主题内容并填充模板生成新文档。触发场景：(1) 用户上传Word模板需要填充内容 (2) 处理包含占位符的Word文档 (3) 批量生成基于模板的文档 (4) 关键词：模板填充、Word模板、占位符、文档生成、{{}}替换。

Security Scan

The skill's files and runtime instructions are consistent with a Word template filler — it performs local parsing and replacement of {{placeholders}} and does not request unrelated credentials or perform network exfiltration itself.

Purpose & Capability

The name/description match the code and instructions: parse .docx for {{placeholders}}, accept a JSON map of values, and write a filled .docx. The required dependency (python-docx) is appropriate and no unrelated credentials or binaries are requested.

Instruction Scope

SKILL.md describes the full flow (parse → AI generate content → fill → upload). The provided scripts implement parsing and filling but do not perform AI content generation or uploading — those are expected to be handled by the agent and by an external 'uploader' skill. This is coherent, but the doc is open about delegating AI generation and upload steps to other components.

Install Mechanism

There is no installer; SKILL.md suggests creating a virtualenv and pip installing python-docx. This is a standard, low-risk approach. No downloads from untrusted URLs or extract operations are present.

Credentials

The skill requests no environment variables or credentials. One consideration: SKILL.md instructs calling an external 'uploader' skill to publish generated files — that uploader may require credentials not declared here. The skill itself does not ask for unrelated secrets.

Persistence & Privilege

always is false, the skill is user-invocable, and it does not modify other skills or system-wide settings. It does not request permanent presence or elevated privileges.

Assessment

This skill is coherent and operates locally on .docx files using python-docx, but: (1) review and run the included scripts in an isolated environment (virtualenv/container) before use since the package source is unknown; (2) verify any uploader skill you call separately — it may require credentials and will handle network upload; (3) the AI content-generation step is agent-driven (not implemented in the scripts) so avoid instructing the agent to include sensitive secrets or PII in generated documents; (4) test with non-sensitive templates to confirm formatting behavior (the replacer rebuilds runs and may alter complex formatting). If you need the uploader integration, inspect that skill's permissions before granting credentials.

Word 模板填充器

自动解析 Word 模板中的 {{占位符}}，根据用户指定主题 AI 生成内容，填充并生成新文档。

工作流程

用户上传模板 → 解析占位符 → AI生成内容 → 填充模板 → 上传返回链接

使用方法

1. 解析模板占位符

当用户提供 Word 模板文件时，首先解析占位符：

python3 scripts/parse_template.py <模板文件.docx>

返回示例：

{
  "success": true,
  "placeholders": ["标题", "正文内容", "日期", "作者"],
  "count": 4
}

2. AI 生成内容

根据用户描述的主题，为每个占位符生成合适内容。示例提示：

用户主题：「新产品发布会邀请函」

占位符：标题、正文内容、日期、作者

生成内容：

• 标题：诚邀莅临「创新未来」新品发布会
• 正文内容：尊敬的嘉宾...

3. 填充模板

使用生成的内容填充模板：

python3 scripts/fill_template.py <输入模板.docx> <输出文件.docx> '{"占位符名": "填充内容"}'

JSON 内容需要正确转义，建议写入临时文件：

python3 scripts/fill_template.py input.docx output.docx "$(cat values.json)"

4. 上传并返回链接

使用 uploader 技能上传生成的文件，返回公开下载链接。

端到端示例

用户请求：

这是一个合同模板，帮我填充一份「软件开发服务合同」，甲方是星云科技，乙方是智创数码

执行步骤：

1. 解析模板：运行 parse_template.py 获取占位符列表
2. 生成内容：根据合同类型、甲乙方信息生成各字段内容
3. 填充模板：运行 fill_template.py 生成新文档
4. 上传文件：调用 uploader 技能获取下载链接
5. 返回结果：告知用户下载链接

依赖与环境设置

需要 python-docx 库。首次使用前设置虚拟环境：

# 创建虚拟环境（只需一次）
python3 -m venv /root/.openclaw/workspace/skills/word-template-filler/.venv

# 安装依赖
/root/.openclaw/workspace/skills/word-template-filler/.venv/bin/pip install python-docx

# 后续使用虚拟环境的 Python
/root/.openclaw/workspace/skills/word-template-filler/.venv/bin/python scripts/parse_template.py <文件>

占位符格式

支持的占位符格式：

• {{变量名}} - 标准格式
• {{ 变量名 }} - 支持空格
• 占位符区分大小写

注意事项

• 填充时会保留原始文档格式（字体、样式、表格结构）
• 未提供值的占位符保持原样
• 复杂格式（文本框、艺术字）可能需要特殊处理