菜单
把任意文档（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 当前能够提供的文件。
制作知识类短视频完整 skill（**主题通用** — 适用于任何 C 端知识科普：AI 工具 / 美食 / 职场 / 育儿 / 历史 / 健身 / 财经 ...）。Step 0 一次性确认 4 个开关（封面风格 4 选 1 / IP 信息默认不放 / 引导关注默认不引导 / 配音默认系统默认 TTS 或用户提供 4 参数+文档链接+代码路径）。覆盖：写口播稿（账号定位 + 三类栏目 + 钩子 + 小白细化 + **≥ 20 句硬下限 + segments.txt 拆段**）→ 选定视觉风格（swiss-grid/warm-grain/nyt-graph/embedded-captions）→ 3:4 封面 → GSAP 动画视频 composition（**不是图片拼接**）→ TTS 配音 → 渲染 → 3 文件精简发布包。每个任务 = 一个带 `YYYYMMDD_HHMMSS_` 时间戳的独立目录（避免连续任务冲突）。用户按自己的账号主题和定位替换示例占位符（`<主题>` / `<IP名>` / `<定位>` / `<slogan>`）。
零基础用户的一站式开源管家：既能「发布」本地项目到 GitHub/AtomGit/Gitee，也能「拉取」网上开源项目到本地装依赖跑起来，还能在发布或拉取后顺手「生成」结构化的 `wiki/` 项目文档（风格参考 popdf repowiki，默认中文并可选同步英文）。覆盖注册、SSH、推送、迭代、文档全流程，GitHub 拉不动自动切国内镜像。适用于代码、文档、图片、笔记等任何项目。Invoke when user wants to publish OR clone/run a project on an open-source platform (GitHub, AtomGit, or Gitee) but is unfamiliar with git / open-source workflow, OR wants to generate a structured project wiki / repowiki documentation for an existing project.
为任意项目生成结构化的 `wiki/` 知识库文档（风格参考 popdf 的 repowiki）。当用户希望 (1) 为当前项目生成仓库 Wiki / 项目知识库；(2) 把代码仓库结构化整理为可浏览的 Markdown 文档；(3) 输出项目概述、核心功能、API 参考、开发者指南；(4) 在某个项目下生成 `repowiki-metadata.json` 元数据；(5) 让 AI Agent 自动读懂项目整体架构并写出带 mermaid 图、cite 块、章节来源的 Markdown 文档时，使用此 skill。触发关键词：生成 repowiki、生成项目 wiki、生成仓库文档、生成项目知识库、输出项目概述、生成 API 参考文档、整理项目文档、repowiki、生成 wiki 文档、为项目生成文档、生成项目 README、生成开发者指南、生成安装文档、生成快速入门、为任意项目生成 wiki、analyze and document this project、generate project documentation。
正在显示 SKILL.md
基于 SOC 职业分类
| 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。