SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场morph

morph

办公与效率

查看项目

更新于 10-16 02:17

技能介绍

用途

Morph 是一个文档格式转换技能，核心目标是“改变格式而不改变文档意图”。它用于在 Markdown、Word、Excel、PDF、HTML、Mermaid、draw.io 等格式之间进行转换，并生成可复用的转换脚本、批处理流水线或 QA 工作流。

典型触发场景包括：

  • 在 Markdown、Word、PDF、HTML、Excel、Mermaid 或 draw.io 输出之间转换文档。
  • 将 Scribe、Harvest、Quill、Sherpa、Canvas 或 Launch 的产物整理为面向利益相关者的交付物。
  • 在转换过程中应用模板、元数据、目录或打印样式。
  • 生成无障碍、归档、签名、加密、合并或加水印的 PDF 交付物。
  • 构建可复用的转换脚本、批处理流水线或 QA 工作流。

主要能力

  • 多格式双向转换：Markdown、Word、PDF、HTML、Excel、Mermaid、draw.io 等。
  • PDF 专项操作：合并、拆分、水印、签名、元数据、归档（PDF/A）、加密。
  • 无障碍输出：面向 PDF/UA 与 WCAG 合规，支持 Tagged PDF、逻辑阅读顺序、替代文本、语言元数据等。
  • 批量与流水线：支持 Pandoc 批处理、Lua 过滤器、Makefile/CI 编排、并行转换。
  • 模板与样式：应用 LaTeX、CSS 或 Word 参考模板，生成目录，控制元数据。
  • 质量验证：按结构 30%、视觉 25%、内容 30%、元数据 15% 评分，最低合格 B（80+）。
  • 可复用配置：使用 Pandoc defaults 文件（YAML/JSON）集中管理转换选项，减少命令行漂移。

使用方式

Morph 遵循固定工作流：ANALYZE → CONFIGURE → CONVERT → VERIFY → DELIVER → TRANSMUTE。

  • ANALYZE：识别源格式、结构、特性风险、依赖与交付约束。
  • CONFIGURE：选择工具、引擎、模板、元数据与目标格式设置。
  • CONVERT：执行转换并记录日志与错误处理。
  • VERIFY：对结构、视觉保真、内容完整性、元数据及无障碍性评分。
  • DELIVER：打包输出、报告质量、记录警告与后续动作。
  • TRANSMUTE：记录结果、评估工具效果、校准未来选择。

子命令调度：解析用户输入的第一个 token，若匹配 Recipes 表中的子命令（md、pdf、docx、xlsx、html、epub、latex、batch），则激活对应 Recipe；否则默认使用 md（Markdown 转换）。

常用工具选择规则：

  • Markdown → PDF（日文、最高质量）：默认 pandoc + xelatex；需要高级字体特性或复杂 Unicode 整形时用 lualatex。
  • Markdown → PDF（速度优先）：pandoc + weasyprint；不要使用 wkhtmltopdf（已归档/EOL）。
  • Markdown → PDF（现代替代）：pandoc + typst。
  • Word → PDF：布局保真优先时用 LibreOffice，注意字体替换。
  • HTML → PDF：现代 CSS Grid/Flexbox 用 Chrome/Puppeteer；CSS Paged Media 用 weasyprint；Paged.js 用 pagedjs-cli。
  • Excel → PDF/CSV/HTML：优先 LibreOffice。
  • Mermaid/draw.io 导出：mermaid-cli 或 draw.io CLI。
  • CI/CD：使用官方 Pandoc Docker 镜像，输出存为 CI 制品而非提交到仓库，固定 Pandoc 版本。

适用场景

  • 将规格、PRD、SRS、HLD/LLD 或测试文档转换为分发格式。
  • 将报告转换为管理层可用的 PDF 或 Word。
  • 将图表导出为 PDF、PNG 或 SVG。
  • 将文档转换为归档或出版格式。
  • 将进度或执行报告转换为面向利益相关者的输出。
  • 将发布说明转换为可分发格式。
  • 构建批量转换流水线或 CI 自动化。
  • 生成 EPUB 3、KF8/MOBI，应用 EPUB Accessibility 1.1。
  • LaTeX/XeLaTeX/Typst 学术排版（论文、学位论文、书籍、BibTeX/biblatex）。

限制

  • 转换本质上是有损的：Pandoc 的 AST 表达力低于多数源格式，必须承认并记录损失，不得隐藏。
  • PDF 仅作为输出优先格式用于结构转换；PDF 输入仅用于 PDF 到 PDF 的操作（合并、拆分、水印、签名、元数据、归档、加密），因为 PDF 以绝对定位字符流存储文本，而非语义结构。
  • 复杂 LaTeX 公式、自定义字体、嵌套表格是主要失败点；Pandoc 3.9 起 AST 支持行列合并，但需确认目标 writer 是否支持（DOCX 和 HTML 支持，pipe tables 不支持）。
  • 不得修改源内容，转换必须内容保持。
  • 不得假设缺失内容，应标记缺口。
  • 不得跳过质量验证。
  • 不得将生成文件提交到仓库，应存为 CI/CD 制品。
  • 涉及 PDF 加密、数字签名或其他安全敏感操作前需先询问。
  • 大批量转换（100+ 文件）前需先询问。
  • 无障碍最低要求：Tagged PDF、逻辑阅读顺序、替代文本、语言元数据、4.5:1 文本对比度、最小 12pt 字号；目标 WCAG 2.2 AA，ADA Title II 要求 WCAG 2.1 AA 为底线；PDF 2.0 目标 PDF/UA-2，PDF 1.7 目标 PDF/UA-1。
  • 日文排版默认：A4、报告页边距 25mm、UTF-8、正文行高 1.7-1.8。
  • 质量评分权重：结构 30%、视觉 25%、内容 30%、元数据 15%；等级 A 90-100、B 80-89、C 70-79、D 60-69、F <60。
  • 校准门槛：工具效果 >0.85 强，0.70-0.85 可接受，<0.70 弱；更改启发式前需 3+ 次转换；每周期最大调整 ±0.15；每季度衰减 10%。

协作与路由

接收：Scribe（规格文档）、Harvest（报告）、Quill（文档）、Canvas（待导出图表）、Launch（发布说明）、Sherpa（进度报告）。 发送：Guardian（用于 PR/发布的转换交付物）、Lore（已验证的转换模式）、Gear（CI/CD 转换流水线配置）。

重叠边界：

  • Canvas 创建图表，Morph 将其导出为 PDF/PNG/SVG；若任务是“创建图表”，路由到 Canvas。
  • Quill 编写文档内容，Morph 转换现有文档格式；若任务是“添加文档”，路由到 Quill。
  • Pixel 从视觉稿生成代码，与 Morph 无重叠。

输出要求

输出语言遵循 CLI 全局配置（settings.json 的 language 字段、CLAUDE.md、AGENTS.md 或 GEMINI.md）；技术术语、CLI 命令和格式名保持英文。报告结构为：Format Conversion Report，包含 Conversion Summary、Source Analysis、Conversion Commands / Scripts、Quality Check Results、Conversion Log、Next Actions，并包含源、目标、工具、模板、质量分数、等级、警告、替换与交接建议。