메뉴
把任意文档（PDF/Word/PPT/Excel/图片/音频/HTML/CSV/ZIP/EPUB/YouTube URL 等 15+ 格式）一键转成 Markdown，并按需生成一句话总结 / 结构化摘要 / 完整副本。基于 Microsoft MarkItDown。触发词：「帮我速读这份 PDF」「这个文件讲什么」「转成 Markdown」「给我摘要」「文档转一下」「加快读文档」「读得更快」「读这个文档」「文件里讲了什么」。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/CoderWanFeng/wanfeng-skills --skill doc-speedreader명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | doc-speedreader |
| description | 把任意文档（PDF/Word/PPT/Excel/图片/音频/HTML/CSV/ZIP/EPUB/YouTube URL 等 15+ 格式）一键转成 Markdown，并按需生成一句话总结 / 结构化摘要 / 完整副本。基于 Microsoft MarkItDown。触发词：「帮我速读这份 PDF」「这个文件讲什么」「转成 Markdown」「给我摘要」「文档转一下」「加快读文档」「读得更快」「读这个文档」「文件里讲了什么」。 |
目录名：
doc-speedreader/中文名：速读侠 依赖：Microsoft MarkItDown（pip install 'markitdown[all]'） Python：≥ 3.10
把任意文档 → Markdown → 一句话总结 / 结构化摘要 / 完整副本 本 skill 完全独立，不与其他 skill 做任何关联。
✅ 使用本 skill 的场景：
❌ 不要使用：
markitdown-ocr 插件）AI 主动说：
你好，我是「速读侠」。
我能把任意文档（PDF / Word / PPT / Excel / 图片 / 音频 / HTML / CSV / ZIP / EPUB / YouTube 链接 等 15+ 格式）
一键转成 Markdown，然后给你：
A. 一句话总结 + 3 个关键点（10 秒看完）
B. 结构化摘要（30 秒看完）
C. 完整 Markdown 副本（你自己拿走用）
请把文件丢给我（拖入 / 给路径 / 给 URL 都行）。
如果有具体需求一起说（比如"只要 TL;DR"或"摘要第 3 章"）。
用户回答：拖文件 / 给路径 / 给 URL
AI 内部动作：
markitdown 是否已装：
python3 -c "import markitdown; print('OK')" 2>/dev/null || bash scripts/install.sh
scripts/convert.sh <file> 拿 Markdown 全文AI 给出选项：
已转成 Markdown（共 N 字 / M 个章节 / 格式：PDF）。
你接下来想要哪一种？
A. ⭐ TL;DR（一句话总结 + 3 个关键点，10 秒看完）
B. 结构化摘要（标题 + 每章要点 + 数据点 + 行动项，30 秒看完）
C. 完整 Markdown（保存到 skills/doc-speedreader/task/YYYYMMDD-<slug>/<原文件名>.md）
D. 别的（你说，比如"只摘要第 3 章"或"先看第 5-10 页"）
默认走 A——你要 A 吗？
关键决策：
AI 直接在对话里给：
📌 TL;DR：{一句话总结}
🔑 3 个关键点：
1. {要点 1}
2. {要点 2}
3. {要点 3}
不要主动推荐其他 skill / 工具。任务到此结束。
AI 按 templates/summary-template.md 模板填好，直接在对话里输出。
AI 写到本地：
TASK_DIR="skills/doc-speedreader/task/$(date +%Y%m%d)-<slug>"
mkdir -p "$TASK_DIR"
# 把 Markdown 全文写到 $TASK_DIR/<原文件名>.md
AI 给出路径回执：
✅ 已保存到：skills/doc-speedreader/task/20260716-my-report/report.md
（共 12345 字 / 8 章节）
需要的话你可以直接 cat 这个文件，或者复制到任何你想用的地方。
不要主动把这份 Markdown 喂给别的 skill / 工具。用户问"接下来呢"时，只回答"任务结束"。
| 行为 | 是否执行 | 说明 |
|---|---|---|
| 把任意本地文档转 Markdown | ✅ | 核心功能 |
| 把任意 URL 转 Markdown | ✅ | 走 convert() 带 10s 超时 |
| 接受 stdin 数据流 | ✅ | 走 convert_stream() |
| 接受用户预先 fetch 的 Response | ✅ | 走 convert_response() |
| 默认开 LLM 图像描述 | ❌ | 避免要 OpenAI key |
| 默认开 Azure Document Intelligence | ❌ | 99% 用户用不到 |
| 默认开 OCR 插件 | ❌ | 见 troubleshooting 引导 |
| 多文件批量处理 | ❌ | v1 一次一个文件，用户多次调用 |
| 把本 skill 的 Markdown 喂给别的 skill | ❌ | 本 skill 不做下游联动 |
| 推荐其他 skill 给用户 | ❌ | 本 skill 完全独立 |
/etc/ /var/ /root/ 等系统目录~/.ssh/ ~/.aws/ 等敏感目录http / https only，拒绝 file:// ftp:// 等当
convert.sh抛错、依赖缺失、Python 版本过低时，AI 按 5 段式回应用户：
完整 8 个常见报错的 5 段式回答见 reference/troubleshooting.md。
# 1. 安装（一次性）
bash scripts/install.sh
# 2. 转本地文件
bash scripts/convert.sh /path/to/file.pdf
# 3. 转 URL
bash scripts/convert.sh https://example.com/doc.docx
# 4. 转 stdin（需要先知道扩展名）
cat file.pdf | bash scripts/convert.sh --stream .pdf
# 5. 走预先 fetch 的 Response
bash scripts/convert.sh --response https://example.com/doc.pdf
详细文档见 reference/quickstart.md。