SYuan03/Skill-Anything

Any source (PDF, video, web, audio, text) to interactive learning package with quizzes, flashcards and spaced repetition. One command, 12-section study guide.

Skill‑Anything

是什么 – 一个 Python CLI / 库，可将任何类型的资料（PDF、视频、网页、纯文本文件、音频或代码仓库）转换为一个 结构化学习包。该学习包包含12个部分的学习指南、测验、闪卡、练习题、术语表、概念图图像，以及可选的 AI代理技能（SKILL.md），可被 Claude Code、Cursor 或 Codex 等工具使用。

为何重要 – 人类学习常受被动阅读的困扰。Skill‑Anything 自动化了教育者通常手动完成的整个流程：总结、提取关键概念、生成主动回忆项目，并组织学习路径。所有这些均由 LLM 调用（任何 OpenAI 兼容 API）驱动，一旦学习包生成，即可完全离线运行。

核心功能（如 README 所述）

源无关的摄入 – PDF（支持大纲）、网页、YouTube/视频字幕、音频（Whisper）、纯文本或整个 Git 仓库。
章节感知的映射-归约管道 – 每个章节并行总结，然后通过全局归约步骤生成最终指南。并发默认为 6，可配置。
缓存 – 将提示 + 模型 + 版本的 SHA-256 哈希值存储在磁盘上；重复运行时跳过相同的 LLM 调用。
双层模型路由 – 使用快速模型处理各章节的“映射”调用，使用更智能的模型处理最终的“归约”调用。
12部分输出 – 摘要、概念图、大纲、详细笔记、关键概念、术语表、速查表、要点、测验、闪卡、练习题。
多种导出格式 –
- --format all → 学习指南、YAML 包、离线网站、Anki TSV 和 SKILL.md 套件。
- --format web → 单个自包含的 index.html（无 CDN，离线可用）。
- --format anki → UTF-8 TSV，可直接导入 Anki，支持 HTML 字段和标签。
- --format skill → 包含 SKILL.md、资源、引用和 AI 代理脚本的目录。
引用感知生成（v0.4.1） – 每个测验/闪卡/练习题均包含可验证的原始引用文本。
CLI 工具 – sa audit 用于 CI 风格验证，sa share 用于打包并发送网页套件，sa lint 用于验证技能包，交互式 sa quiz 和 sa review 命令。
可扩展配置 – 支持环境变量设置 API 基地址、模型名称、并发数、缓存控制等。

典型工作流程

# 1️⃣ 安装（可编辑开发版本或从 PyPI）
pip install skill-anything[all]   # 或克隆后运行 pip install -e .[all,dev]

# 2️⃣ 设置 LLM 凭据
cp .env.example .env && nano .env   # 设置 API_KEY、API_BASE、模型名称

# 3️⃣ 从任意源生成学习包
sa pdf textbook.pdf --format all          # PDF → 完整包 + 网站 + Anki + 技能
sa repo https://github.com/openai/openai-python --format study
sa video https://youtu.be/… --format web

# 4️⃣ 共享或使用输出
sa share output/textbook.yaml               # 生成 index.html + ZIP
sa export output/textbook.yaml --format anki # Anki 导入用 TSV
sa export output/textbook.yaml --format skill # AI 代理就绪的 SKILL.md 套件

# 5️⃣ 本地交互
sa quiz output/textbook.yaml                # 交互式测验（6种类型）
sa review output/textbook.yaml              # 闪卡间隔重复模式

谁会用它？

学生与自学学习者 – 将讲座视频或教科书章节转化为包含测验和闪卡的即学即用指南。
团队负责人用于新员工入职 – 将代码仓库输入 sa repo，生成入职包（术语表、概念、练习题）和可回答代码库问题的 AI 代理技能。
教育者与内容创作者 – 快速从现有资源生成学习材料，并导出为 Anki 或静态网站用于分发。
AI 工具开发者 – 使用 SKILL.md 导出，为代理提供特定领域的结构化知识库。

安装与要求

Python 3.10 或更高版本。
特定源类型可选扩展（pdf、video、web、audio）。
推荐使用 OpenAI 兼容 API 密钥以获得最佳质量；无密钥时将回退至规则生成。
通过 PyPI 安装：
```
pip install skill-anything[all]
```
或克隆仓库后以可编辑模式安装用于开发。

许可证

MIT – 宽松的开源许可证。