用途:把 PDF、DOCX、PPTX、XLSX、HTML、图片、音频、压缩包、电子书等文档及 URL 转换为 Markdown,供下游处理。该技能属于基础设施,消费方技能通过依赖引用而非自行实现转换逻辑。
主要能力:按 URI 扩展名识别格式,再按三级回退转换。Tier 1 调用 MCP markitdown 的 convert_to_markdown 工具,质量最佳;Tier 2 使用 Claude Code 原生工具,仅支持 PDF、HTML、图片、CSV、JSON、XML,不支持 DOCX、PPTX、XLSX、音频、压缩包、电子书;Tier 3 在无覆盖时提示用户安装 markitdown MCP 服务器,并给出 .mcp.json 配置片段(type stdio、command uvx、args markitdown-mcp),或建议先转成 PDF/HTML。
使用方式:转换流程为 DETECT(识别格式)、TRY(Tier 1)、DEGRADE(Tier 2)、INFORM(Tier 3)、SANITIZE(内容净化)。消费方在依赖中写 leyline:document-conversion,并在工作流中引用该协议。转换后内容视为外部内容,需执行内容净化:超过 2000 词的分段截断、剥离系统/指令标签、用外部内容边界标记包裹。
适用场景:需要摄取外部文档的技能、将外部文档导入项目为可编辑 Markdown 文件。不适用:内容已是 Markdown 或纯文本,或只需读取小文本文件(直接用 Read)。
限制:Tier 2 对多种格式无覆盖;未知扩展名会提示用户而非盲目交给转换器;详细格式矩阵、回退说明、URI 构造规则和项目导入细节见对应模块文件,资料未提供其具体内容。