mcpField
S
save-md

save-md

github.com/mblode文档处理169287 次安装1 天前更新
代码仓库

关于 save-md

save-md 用于将一个指定来源完整保存为用户目录中的 Markdown 文件。它要求依据获取到的原始内容写入，而非摘要，并通过末段检查确认保存完整。

主要功能

  1. 01将指定来源保存为 .md 文件
  2. 02支持 URL、附件、粘贴内容、视频、Docs 和 PDF
  3. 03依据获取的原始内容写入
  4. 04检查保存文件是否包含来源末段

适用场景

  1. 01将网页存档为 Markdown
  2. 02在本地保存指定 PDF 或文档
  3. 03确认存档包含来源结尾

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mblode/agent-skills --skill save-md

安装后在 Claude Code 中输入/save-md确认已加载。

附带文件evals/evals.jsonreferences/source-endpoints.md

详细介绍

保存为 Markdown

将指定来源的完整内容写入 .md 文件，并说明文件位置。正文必须来自获取到的字节，不能来自摘要。

  • **是：**将一个指定来源（URL、附件、粘贴内容、YouTube 视频、Google 文档、PDF）保存为用户目录树中的一个 .md 文件。
  • **不是：**根据获取的内容直接作答、在聊天中总结、抓取指定 URL 之外的内容，或凭记忆重构演讲内容。

完成标准

用户可以打开某个位置的 .md 文件，其中包含以下 frontmatter，且读回文件后能看到来源的最后一段：

---
title: "<title>"
source: "<URL or path>"
date: "<date -u +%Y-%m-%dT%H:%M:%SZ, run now>"
type: web | youtube | gdoc | sheet | slides | pdf | docx | tweet | conversation
---

使用 curl -sSL -o <file> <url> 获取并读取文件。优先选择文本端点，而不是包含 HTML 界面元素的页面。若文件缺失且注明了原因（付费墙、登录墙、机器人检测、私有文档），也好过提供看似合理的内容。

文件何时阅读
references/source-endpoints.md始终阅读，查看对应 URL 主机的测试端点、curl 命令、各端点显示的失败情况，以及需选择启用的备用读取器

注意事项

  • WebFetch 会把页面交给一个小模型并返回它的回答：一篇 1,200 词的文章可能只返回 120 词。只有 Content-Type: text/markdown 且内容少于 100K 个字符时，才能原样传递。
  • oEmbed、GitHub ?raw=true 和 Drive 下载会跨主机重定向。若不使用 -L，保存的会是空的 301 响应。
  • YouTube 显示的“Sign in to confirm you're not a bot”表示 IP 被屏蔽：在笔记本电脑上使用 --cookies-from-browser；在沙盒中则停止操作。视频描述并非演讲内容。
  • 如果较大的 PDF 旁边有一个空的 .md 文件，说明 PDF 是扫描件，而不是空白文档：渲染页面并阅读。

仅用于维护：evals/evals.json 保存了供修改此技能的人员使用的场景和路由提示词。

评论

支持 Markdown