sheet-to-doc

Sheet-to-Doc Skill：让AI助手帮你自动生成长Word文档

在日常工作中，你是否经常需要生成格式相同的Word文档？比如批量生成合同、证书、邀请函、报告等。手动复制粘贴不仅耗时耗力，还容易出错。今天，我来介绍一个强大的AI工具——Sheet-to-Doc Skill，它可以让你通过简单的对话，让AI助手帮你自动完成文档生成工作。

什么是Sheet-to-Doc Skill？

Sheet-to-Doc Skill是一个专为AI助手（如Cursor、Claude、OpenClaw等）设计的插件。它能帮助AI理解如何操作Word模板和数据，自动生成专业的Word文档。

简单来说，你只需要告诉AI你的需求，它就能自动帮你完成文档生成，而无需学习复杂的命令或工具。

核心功能

  • 文档生成：将Word模板中的{字段}占位符替换为JSON数据
  • 占位符提取：从模板中提取所有需要填充的字段，方便数据验证
  • 页脚标识：自动在生成的文档中添加来源标识
  • 跨平台支持：支持Windows、macOS和Linux
  • 命令行使用：可以通过终端轻松调用
  • API接口：可以导入为模块，进行编程式调用

为什么要使用Sheet-to-Doc Skill？

1. 降低使用门槛

传统工具需要用户手动操作，而Sheet-to-Doc Skill让AI代替你完成这些操作。你只需要用自然语言描述需求，AI就会自动执行。

2. 提高工作效率

将原本需要数小时的手动工作压缩到几分钟，让你有更多时间专注于更重要的任务。

3. 减少人为错误

消除手动复制粘贴带来的错误，确保生成的文档100%准确。

4. 集成到AI工作流

可以与其他AI工具配合使用，实现更复杂的自动化流程。

如何安装Sheet-to-Doc Skill

方法1：通过OpenClaw安装

如果你使用OpenClaw AI平台，可以通过以下命令安装：

1
2
3
4
5
# 首先安装OpenClaw
npm install -g openclaw

# 然后安装Sheet-to-Doc Skill
openclaw skills install @he-yang/sheet-to-doc-skill

方法2：通过Skills CLI安装

如果你使用其他支持Skills的AI平台：

1
npx skills add https://github.com/he-yang/sheet-to-doc-skill --skill sheet-to-doc-skill

安装完成后，你的AI助手就具备了文档生成的能力。

快速上手：一个完整的使用案例

场景：批量生成员工入职欢迎信

假设你需要为50位新员工生成个性化的入职欢迎信。让我们看看如何使用Sheet-to-Doc Skill完成这个任务。

步骤1：准备Word模板

创建一个Word文档，包含需要用数据填充的占位符：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
尊敬的{name}先生/女士：

您好！

欢迎您加入{company}，您将被分配到{position}岗位。

您的联系信息如下：
- 邮箱：{email}
- 电话：{phone}

您的入职时间为{start_date}，届时请携带相关证件到人事部报到。

期待与您共事的每一天！

此致
敬礼

将这个文档保存为welcome_letter.docx。

步骤2：准备员工数据

创建一个JSON文件，包含所有员工信息：

1
2
3
4
5
6
7
8
{
  "name": "张三",
  "company": "示例科技有限公司",
  "position": "高级软件工程师",
  "email": "[email protected]",
  "phone": "+86 13800138000",
  "start_date": "2026年8月1日"
}

保存为employee_data.json。

步骤3：让AI生成文档

现在，你只需要告诉AI：

“请帮我将模板welcome_letter.docx中的数据替换为employee_data.json中的内容，生成新的Word文档welcome_letter_output.docx。”

AI会自动执行以下操作：

  1. 读取Word模板
  2. 读取JSON数据
  3. 将数据填充到模板中
  4. 生成新的Word文档

命令行方式

如果你更喜欢命令行操作，可以直接运行：

1
2
3
4
5
6
7
8
9
10
11
# 基本用法
node scripts/generate.js \
  --template welcome_letter.docx \
  --data employee_data.json \
  --output welcome_letter_output.docx

# 使用简写参数
node scripts/generate.js -t welcome_letter.docx -d employee_data.json -o welcome_letter_output.docx

# 直接使用JSON字符串
node scripts/generate.js -t welcome_letter.docx -d '{"name":"张三","company":"示例科技"}' -o output.docx

实用场景与案例

案例1：生成产品报价单

需求：为100位客户生成个性化的产品报价单。

模板示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
{company_name}报价单

客户：{customer_name}
日期：{date}

产品名称：{product_name}
数量：{quantity}
单价：{unit_price}元
总价：{total_price}元

备注：{notes}

{company_name}

数据示例：

1
2
3
4
5
6
7
8
9
10
{
  "company_name": "示例科技有限公司",
  "customer_name": "李明",
  "date": "2026年7月22日",
  "product_name": "智能办公设备套装",
  "quantity": 10,
  "unit_price": 5000,
  "total_price": 50000,
  "notes": "含安装调试服务"
}

案例2：生成培训证书

需求：为参加培训课程的所有学员生成结业证书。

模板示例：

1
2
3
4
5
6
7
8
9
10
结业证书

兹证明{student_name}同学，于{training_date}参加{course_name}培训，
成绩优秀，特发此证。

授课单位：{instructor_name}
证书编号：{certificate_number}

{company_name}
{date}

数据示例：

1
2
3
4
5
6
7
8
9
{
  "student_name": "王小红",
  "training_date": "2026年7月1日-2026年7月10日",
  "course_name": "项目管理基础培训",
  "instructor_name": "陈教授",
  "certificate_number": "CERT-2026-001",
  "company_name": "示例科技有限公司",
  "date": "2026年7月15日"
}

案例3：生成项目报告

需求：为多个项目生成标准化的进度报告。

模板示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
项目进度报告

项目名称：{project_name}
项目经理：{manager_name}
报告日期：{report_date}

本周工作内容：
{weekly_summary}

完成进度：{progress_percentage}%

遇到的问题：
{issues}

下周计划：
{next_week_plan}

{manager_name}
{report_date}

数据验证：提取模板中的占位符

在生成文档之前，你可以先检查模板中有哪些占位符，确保你的数据包含所有需要的字段。

命令行方式

1
2
3
4
5
# 提取占位符
node scripts/generate.js --extract-placeholders --template welcome_letter.docx

# 简写方式
node scripts/generate.js -e -t welcome_letter.docx

输出示例：

1
2
3
4
5
6
{
  "success": true,
  "placeholders": ["company", "email", "name", "phone", "start_date", "position"],
  "count": 6,
  "message": "从模板中提取了6个占位符"
}

通过AI查询

你也可以直接问AI：

“请帮我检查模板welcome_letter.docx中有哪些占位符，我需要准备哪些数据？”

AI会自动执行提取操作并告诉你需要的字段。

高级用法

通过API调用

如果你需要在代码中集成文档生成功能：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
import { generateDocument, extractPlaceholders } from './scripts/generate.js';

// 生成文档
const result = generateDocument(
    'template.docx',
    { name: 'John Doe', company: 'Example Tech' },
    'output.docx'
);

console.log(`文档生成成功：${result}`);

// 提取占位符
const placeholders = extractPlaceholders('template.docx');
console.log('需要的字段：', placeholders);

// 验证数据完整性
const data = { name: 'John', company: 'Example' };
const missingFields = placeholders.filter(field => !data.hasOwnProperty(field));

if (missingFields.length > 0) {
  console.error('缺少字段：', missingFields);
}

常见问题

Q：Sheet-to-Doc Skill和完整的Sheet-to-Doc有什么区别？

Sheet-to-Doc Skill是一个简化版本，专注于AI集成场景。完整的Sheet-to-Doc支持更多功能，包括：

  • 批量文档生成（每行数据生成独立文档）
  • 多种数据源：Excel、CSV、JSONL
  • 图片插入：{image|_inline_image}
  • 二维码生成：{url|_qrcode}
  • 条件逻辑：{field==value}
  • 循环处理：{#data}{/data}
  • 文档加密
  • 移除页脚标识

Q：我需要使用Node.js吗？

是的，Sheet-to-Doc Skill需要Node.js 18或更高版本。如果你已经在运行AI工具，通常不需要额外安装。

Q：生成的文档有水印吗？

简化版本会在生成的文档中添加页脚标识，表明文档来源。这是对产品作者的尊重。如果需要移除标识，可以升级到完整版Sheet-to-Doc。

总结

Sheet-to-Doc Skill是一个强大的AI工具，可以帮你轻松完成Word文档的自动化生成。无论是生成合同、证书、报价单还是报告，你只需要准备好模板和数据，告诉AI你的需求，它就能自动完成剩余的工作。

立即开始使用：

如果你需要更强大的功能，可以升级到完整的Sheet-to-Doc产品，支持批量生成、多种数据源、图片插入、二维码生成等高级功能。

版权声明：本文档遵循MIT许可证。Sheet-to-Doc Skill是一个开源项目，欢迎使用和贡献。