Morph 文档格式转换
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/morph。
技能介绍
要解决什么问题
工程团队里常见断层:Scribe / Quill 产出的是 Markdown 或 Word,利益相关者却要 PDF;Harvest、Sherpa 的报告要「能发出去」的版式;Canvas 的 Mermaid / draw.io 图要变成 PNG、SVG 或 PDF。若把「改内容」和「改格式」混在一起,链接、标题层级和表格很容易在来回导出中变形。Morph 的定位是:只改变输出格式,不改变文档意图。
如何工作
Morph 按 分析 → 配置 → 转换 → 验证 → 交付 → 转化 推进,并以 Pandoc 等工具链为默认路径:
- 标准互转:在 Markdown、Word、PDF、HTML、Excel、Mermaid、draw.io 等之间转换;命令中显式指定
--from/--to,避免格式误检测。 - 交付增强:应用模板、元数据、目录与打印样式;需要时可走 PDF/A、水印、合并拆分、签名与加密等 PDF 操作。
- 质量门禁:交付前用加权评分验证——结构 30%、视觉 25%、内容 30%、元数据 15%,B 级(80+) 为最低及格线;有风险时在转换前记录不支持特性与预期损失。
- 协作接口:从 Scribe、Harvest、Quill、Canvas、Launch、Sherpa 接收产物;向 Guardian 交 PR/发布附件,向 Lore 沉淀已验证模式,向 Gear 输出 CI/CD 转换配置。
配方上可用子命令聚焦场景,例如 md(Markdown 主路径)、pdf(PDF/UA 与存档)、batch(批量与 Makefile/CI)。
边界与注意点
- 不要用 PDF 当结构化转换源:PDF 文本是绝对定位字符流,语义结构不可靠;PDF 输入主要用于 PDF→PDF 类操作。
- 从 PDF 抽结构化数据给 LLM 应走 Docling / MarkItDown,不是 Morph 的主场景。
- 不改源内容:不代写文档(Quill/Prose)、不画新图(Canvas);转换必须保真声明有损点(复杂 LaTeX、嵌套表格、自定义字体等)。
- 大批量(100+ 文件)或敏感 PDF 操作 应先确认模板选项、质量降级与安全约束;产物宜作为 CI 产物存储,而非直接提交仓库。
使用场景
- Scribe 产出的 Markdown 规范已定稿,需要导出带目录与元数据的 PDF 供设计评审与外部分发。
- Harvest 数据分析报告写完,需要转成 Word 或 PDF,方便非技术利益相关者阅读与批注。
- Canvas 中的 Mermaid 或 draw.io 架构图要导出为 SVG/PNG/PDF,嵌入 Launch 发布说明或 Confluence 页面。
- Quarto 或 Markdown 源文档要在 CI 中批量转为 HTML/PDF,产物作为构建附件存储而不提交进 Git 仓库。
适合人员
- 维护 PRD/SRS 的系统架构师,要把 Markdown 规范转成可签审、可归档的 PDF 并记录保真损失。
- 撰写项目周报与里程碑汇报的项目经理,需要把 Sherpa 进度报告做成可外发的 PDF 或 Word。
- 负责 GitHub Release 的发布工程师,要把 Launch 发布说明转成多格式附件并交给 Guardian 挂到 PR/发布流程。
- 搭建内部文档平台的 DevOps 工程师,要用 Pandoc 默认文件、Lua 过滤器编排批量转换并 enforce B 级质量门禁。