Feishu Sheet → DOCX 会议纪要生成 Skill

当用户希望:

• 提供一个 .docx 模板
• 模板中存在 [待更新] 占位符
• 从飞书 Sheets 读取数据
• 根据模板中的行/列语义自动匹配并替换内容
• 输出一个新的会议纪要/汇报 .docx 文件

就使用此 skill。

默认行为

• 默认数据源为飞书 Sheets
• 如果用户没有提供新的 Sheets 地址,默认使用:

https://seazen.feishu.cn/wiki/ZM1RwixcpiCfAMkpFACcMu4XnKe?sheet=S1YD9E

• 默认只处理 包含 [待更新] 的表格
• 默认输出为 新文件,不覆盖原模板
• 默认输出目录:/mnt/shared/openclaw/workspace
• 默认命名:原模板名-第N版.docx

执行前确认

如果用户信息不完整,按下面顺序补齐;一次只问一个问题:

1. 请用户提供 docx 模板
2. 请用户提供飞书 Sheet 地址;如果未提供,告知会使用默认地址
3. 确认输出方式:生成新文件
4. 确认如果找不到高置信匹配,是否保留空白并列出未匹配项
5. 确认是否允许公式自动计算为最终值
6. 确认是否允许规则推导字段(例如"有无风险")

如果用户已说明完整,不要重复追问。

处理流程

1) 读取模板

• 读取 docx 中所有表格
• 只处理 包含 [待更新] 的表格
• 提取:
• 表头行
• 当前行定位字段
• 每个 [待更新] 所在列标题

2) 读取飞书 Sheet

优先使用脚本:

• scripts/fill_from_feishu_sheet.py

脚本内部默认通过:

• skills/feishu-sheet/scripts/feishu-sheet.sh read ...

读取数据范围(默认到 A1:V200)

3) 建立匹配规则

默认规则:

• 以模板当前行的 指标类型 + 分项 作为第一优先匹配键
• 若匹配不到,回退为:
• 仅按指标类型匹配
• 或仅按分项匹配
• 列匹配默认按模板当前列标题进行模糊映射

典型列映射:

• 年完成值 → year_done
• 年完成进度 → year_progress
• X月指标 → month_target
• X月达成 → month_done
• 达成率 → month_rate
• 缺口 → month_gap
• 有无风险 → risk

公式与推导规则

公式计算

默认支持这类表达式:

• G4/F4
• K4/J4
• G4-F4
• K4-J4

处理规则:

1. 识别为单行单元格引用公式
2. 从同一行对应列取数
3. 计算最终值
4. 按目标列应有的显示格式输出
• 年完成进度:百分比
• 达成率:百分比
• 缺口:数字
• 其他列:尽量跟随数据源风格

无法安全计算时:

• 留空
• 记录到未匹配/待确认清单

推导字段:有无风险

如果用户允许规则推导,则:

• 缺口 > 0 → 无
• 缺口 = 0 → 无
• 缺口 < 0 → 有

自动日期更新

功能说明

脚本会自动从飞书 Wiki 文档标题中提取日期信息,并更新文档中的以下内容:

1. 文档标题日期:自动替换标题中的年月周信息
• 示例:2026年3月第四周周例会会议纪要 → 2026年4月第四周周例会会议纪要

1. 会议时间日期:自动计算并更新会议时间中的具体日期
• 示例:会议时间:2026年3月25日 09:00-10:00 → 会议时间:2026年4月22日 09:00-10:00

日期提取规则

从飞书文档标题中提取年月周信息,支持格式:

• 2026年4月第四周
• 2026年X月第X周

会议日期计算

根据"第X周"信息,自动计算该周的周一作为会议日期:

• 第1周:当月1-7日
• 第2周:当月8-14日
• 第3周:当月15-21日
• 第4周:当月22-28日
• 以此类推

执行时机

日期自动更新在表格数据填充完成之后、文件保存之前自动执行,无需额外参数。如果提取失败或更新出错,会跳过该步骤,不影响表格数据的正常填充。

可用性

• 需要飞书文档标题包含可识别的日期格式
• 需要使用 feishu_wiki API(自动调用)
• 如果无法获取文档标题或日期格式不匹配,会静默跳过

输出规则

• 生成新的 docx 文件
• 默认输出目录:/mnt/shared/openclaw/workspace
• 默认命名:原模板名-第N版.docx
• 不覆盖原模板
• 如果存在未匹配项:
• 文档内先留空
• 同时向用户汇报未匹配清单

建议执行方式

完整流程（推荐，在 OpenClaw 会话中使用）

1. 获取飞书文档标题（用于日期更新）
• 使用 feishu_wiki 工具获取 Wiki 文档标题
• 将标题设置为环境变量 FEISHU_DOC_TITLE

1. 运行主脚本生成文件

```bash

export FEISHU_DOC_TITLE="<文档标题>"

python3 /mnt/shared/openclaw/workspace/skills/feishu-sheet-docx-minutes/scripts/fill_from_feishu_sheet.py [sheet_url] [output.docx]

```

1. 检查并执行发送任务
• 脚本会创建发送任务文件：/mnt/shared/openclaw/workspace/.feishu_send_task.json
• 读取任务文件，获取 file_path 和 target_user
• 使用 message 工具发送文件：

```

message action=send channel=feishu to= filePath=

```

1. 清理任务文件
• 发送完成后删除 .feishu_send_task.json

简化方式（跳过自动发送）

直接运行主脚本：

python3 /mnt/shared/openclaw/workspace/skills/feishu-sheet-docx-minutes/scripts/fill_from_feishu_sheet.py <template.docx> [sheet_url] [output.docx]

输出文件后，需要手动使用 message 工具发送。

功能说明

该脚本会：

• 读取飞书表格数据
• 提取包含 [待更新] 的模板表格
• 模糊匹配行列数据
• 自动计算公式（如 G4/F4）
• 按目标格式输出最终值
• 自动从飞书文档标题提取日期并更新文档标题和会议时间（如果设置了 FEISHU_DOC_TITLE 环境变量）
• 创建发送任务文件（供外部进程调用 message 工具发送）

注意事项

• 飞书返回值可能是公式原文，不要盲信；必要时按引用关系计算
• 公式结果的显示格式必须与目标列一致，不能统一粗暴格式化
• DOCX 替换时优先做 单元格级替换，不要整段重写
• 多步骤任务必须在关键节点主动同步进度
• 如果用户要求先问清楚再执行，必须遵守"一次只问一个问题"
• 日期自动更新功能需要：
• 飞书文档标题包含可识别的日期格式（如 2026年4月第四周）
• 模板中存在包含"会议时间"的段落（用于更新具体日期）
• 如果日期提取或更新失败，会静默跳过，不影响表格数据填充
• 该 skill 依赖：
• Python python-docx
• 本地 skills/feishu-sheet 中的 feishu-sheet.sh 可用
• feishu_wiki API（用于获取文档标题）