work-export

办公文档通用 Outflow 编排:从内容(Markdown/数据/大纲)出发,调度社区上游技能生成目标格式文档(docx/pdf/xlsx/pptx)。depends on docx, pdf, xlsx, pptx 社区上游技能。用户提到'导出为 Word''生成 PDF''做成 Excel''做成 PPT''导出文档'时使用。

SKILL.md

GitHub

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

  1. 确认 Markdown 源文件内容已确认
  2. 调用 docx 技能生成 .docx
  3. 校验:在 Office/WPS 中打开确认格式正确

Markdown → PDF

  1. 确认 Markdown 源文件内容已确认
  2. 选择管线:
    • 直接生成:reportlab / md-to-pdf
    • 经 docx 中转:先生成 docx → soffice --convert-to pdf
  3. 校验:渲染页面确认排版

数据 → Excel

  1. 确认数据源(CSV / JSON / 数据库查询结果)
  2. 调用 xlsx 技能生成 .xlsx
  3. 校验:打开确认公式无错误、格式正确

大纲 → PowerPoint

  1. 确认大纲结构(标题/要点层级)
  2. 调用 pptx 技能生成 .pptx
  3. 校验:缩略图预览确认布局

统一输出校验

每种格式导出后 MUST 执行:

格式 校验项
docx Office/WPS 打开无报错,标题/段落格式正确
pdf 页数正确,无截断/空白页,中文无乱码
xlsx 公式无 #REF!/#VALUE! 错误,表头对齐
pptx 缩略图预览,文字不溢出,图片显示正常

与 work 生态的协作

内容 (Markdown/数据/大纲)
    │
    ▼
work-export (本技能:内容→目标格式)
    │
    ├─→ docx (社区上游:Word 生成)
    ├─→ pdf  (社区上游:PDF 生成)
    ├─→ xlsx (社区上游:Excel 生成)
    └─→ pptx (社区上游:PPT 生成)

推荐输出格式

执行完毕后按以下结构输出:

状态:✅ 成功 / ⚠️ 部分成功 / ❌ 失败

<输入→输出文件/格式/路径> <值/状态> 说明

下一步:<可执行动作>

约束

  • 不实现格式生成逻辑,完全依赖社区上游技能
  • 多格式导出时按依赖顺序执行(源文档 → 派生导出)
  • 每次导出后 MUST 输出校验结果和文件路径
  • 中文文档默认使用思源黑体或微软雅黑