work-export
用途
作为 work 命名空间的通用 Outflow 基座,提供从内容(Markdown / 结构化数据 / 大纲)到目标格式文档的统一导出管线。
本技能不实现格式生成逻辑,而是编排社区上游技能(docx/pdf/xlsx/pptx),提供:
- 统一的格式选择决策树
- 标准化的输出校验流程
- 与
work-markitdown(Inflow)形成闭环
依赖
- depends:
docx(md→docx)、pdf(md→pdf)、xlsx(data→xlsx)、pptx(outline→pptx) - 协作:
work-markitdown(Inflow 侧)、work-convert(格式互转) - 被依赖:
work-sc-*场景技能
适用场景
- 从 Markdown 内容导出为 Word 文档(报告、手册、合同等)
- 从 Markdown 内容导出为 PDF
- 从结构化数据导出为 Excel 表格
- 从大纲/结构导出为 PowerPoint 演示文稿
- 为
work-sc-*场景技能提供底层导出能力
不适用场景
- 需要精确格式控制的专业排版 → 直接调用社区上游
docx/pdf技能 - 文件格式互转(docx→pdf)→ 用
work-convert - 解析/读取文档内容 → 用
work-markitdown
格式选择决策树
用户需要导出什么格式?
├─ Word (.docx)
│ → 调用 docx 社区上游技能
│ → docx-js 生成 / pandoc 转换
├─ PDF (.pdf)
│ → 调用 pdf 社区上游技能
│ → reportlab 生成 / soffice 转换
├─ Excel (.xlsx)
│ → 调用 xlsx 社区上游技能
│ → openpyxl 生成
├─ PowerPoint (.pptx)
│ → 调用 pptx 社区上游技能
│ → pptxgenjs 生成
└─ 多种格式
→ 按依赖顺序:源文档 → 派生导出
→ 例:先生成 docx,再从 docx 转 pdf
工作流
Markdown → Word
- 确认 Markdown 源文件内容已确认
- 调用
docx技能生成.docx - 校验:在 Office/WPS 中打开确认格式正确
Markdown → PDF
- 确认 Markdown 源文件内容已确认
- 选择管线:
- 直接生成:
reportlab/md-to-pdf - 经 docx 中转:先生成 docx →
soffice --convert-to pdf
- 直接生成:
- 校验:渲染页面确认排版
数据 → Excel
- 确认数据源(CSV / JSON / 数据库查询结果)
- 调用
xlsx技能生成.xlsx - 校验:打开确认公式无错误、格式正确
大纲 → PowerPoint
- 确认大纲结构(标题/要点层级)
- 调用
pptx技能生成.pptx - 校验:缩略图预览确认布局
统一输出校验
每种格式导出后 MUST 执行:
| 格式 | 校验项 |
|---|---|
| docx | Office/WPS 打开无报错,标题/段落格式正确 |
| 页数正确,无截断/空白页,中文无乱码 | |
| xlsx | 公式无 #REF!/#VALUE! 错误,表头对齐 |
| pptx | 缩略图预览,文字不溢出,图片显示正常 |
与 work 生态的协作
内容 (Markdown/数据/大纲)
│
▼
work-export (本技能:内容→目标格式)
│
├─→ docx (社区上游:Word 生成)
├─→ pdf (社区上游:PDF 生成)
├─→ xlsx (社区上游:Excel 生成)
└─→ pptx (社区上游:PPT 生成)
推荐输出格式
执行完毕后按以下结构输出:
状态:✅ 成功 / ⚠️ 部分成功 / ❌ 失败
| <输入→输出文件/格式/路径> | <值/状态> | 说明 |
|---|
下一步:<可执行动作>
约束
- 不实现格式生成逻辑,完全依赖社区上游技能
- 多格式导出时按依赖顺序执行(源文档 → 派生导出)
- 每次导出后 MUST 输出校验结果和文件路径
- 中文文档默认使用思源黑体或微软雅黑