用途
summarize 用于把各种“东西”(URL、PDF、Word 文档、PowerPoint、HTML 页面、文本文件等)转换为 Markdown,使其能够像普通文本一样被检查、引用和处理。
markitdown 本身可以自行抓取 URL;这个技能主要是对它进行封装,让保存和摘要更加方便。
对于 PDF 输入,需要使用 markitdown[pdf] extra(或使用下方封装脚本,它现在会自动处理这一点)。
主要能力
- 将 URL 抓取为类似文档的 Markdown 表示
- 将二进制文档(PDF/DOCX/PPTX)转换为 Markdown 以便分析
- 在深入工作前,快速生成长文档的简短摘要
使用方式
将 URL 或文件转换为 Markdown
从该技能文件夹运行(智能体应先 cd 到这里):
uvx --from 'markitdown[pdf]' markitdown <url-or-path>
将 Markdown 写入临时文件(打印路径)可使用封装脚本:
node to-markdown.mjs <url-or-path> --tmp
提示:进行摘要时,脚本会始终把转换后的完整 Markdown 写入一个临时 .md 文件,并始终打印一行带有路径的最终 “Hint” 行(以便打开/检查完整内容)。
将 Markdown 写入指定文件:
uvx --from 'markitdown[pdf]' markitdown <url-or-path> > /tmp/doc.md
使用 haiku-4-5 转换 + 摘要(传入上下文!)
只有当你提供想要提取的内容以及受众/用途时,摘要才有用。
node to-markdown.mjs <url-or-path> --summary --prompt "Summarize focusing on X, for audience Y. Extract Z."
或:
node to-markdown.mjs <url-or-path> --summary --prompt "Focus on security implications and action items."
该命令会:
- 通过
uvx --from 'markitdown[pdf]' markitdown转换为 Markdown - 将完整 Markdown 写入临时 .md 文件,并打印其路径作为 “Hint” 行
- 运行
pi --model claude-haiku-4-5(no-tools、no-session),使用你提供的额外提示进行摘要
适用场景
- 需要把网页拉取为类似文档的 Markdown 表示
- 需要把二进制文档(PDF/DOCX/PPTX)转换为 Markdown 以便分析
- 需要在深入处理长文档前快速获得简短摘要
限制
- 摘要功能依赖
pi --model claude-haiku-4-5,且以 no-tools、no-session 方式运行 - 摘要质量取决于是否提供了明确的提取目标和受众/用途提示
- PDF 输入需要 markitdown[pdf] extra
- 其他功能、收费、价格、平台、效果等信息暂未提供