菜单
把题目数组生成一个**可独立运行的网页练习页**（HTML 文件）。当用户完成 quiz-mastery 的「从资料出题」或「从文件提取题目」流程后，应主动询问是否需要"在网页里练习"，确认后调用本 skill 把题目注入模板，生成 HTML 给用户。也支持用户直接说"把这些题做成网页/HTML/练习页"时触发。**不处理**：出题（→ quiz-mastery）、评分（→ quiz-mastery）、长期复习计划（→ study-buddy）。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
把本地 HTML 文件或目录部署到飞书妙搭（Miaoda），生成一个公网可访问的应用及其链接（URL）。当用户要创建 HTML 或要把 HTML、静态网站或 Web demo 发布成公网可访问的链接 / 可分享链接、设置应用共享范围，或提到妙搭 / Miaoda 时使用。凡产出可独立访问的 HTML 产物都属本 skill 的潜在归宿，是否真要部署由 skill 内部协议判断。不用于：上传普通文件到云空间/云盘/云存储（用 lark-drive）、编辑飞书云文档内容（用 lark-doc）、创建飞书原生幻灯片 / 演示文稿（用 lark-slides）。
当需要用 lark-cli 操作飞书多维表格（Base）时调用：搜索 Base、建表、字段管理、记录读写、记录分享链接、视图配置、历史查询，以及角色/表单/仪表盘管理/工作流；也适用于把旧的 +table / +field / +record 写法改成当前命令写法。涉及字段设计、公式字段、查找引用、跨表计算、行级派生指标、数据分析需求时也必须使用本 skill。
飞书日历（calendar）：提供日历与日程（会议）的全面管理能力。核心场景包括：查看/搜索日程、创建/更新日程、管理参会人、查询忙闲状态及推荐空闲时段、查询/搜索与预定会议室。注意：涉及【预约日程/会议】或【查询/预定会议室】时，必须先读取 references/lark-calendar-schedule-meeting.md 工作流！高频操作请优先使用 Shortcuts：+agenda（快速概览今日/近期行程）、+create（创建日程并按需邀请参会人及预定会议室）、+update（更新既有日程字段，或独立增删参会人/会议室）、+freebusy（查询用户主日历的忙闲信息和rsvp的状态）、+rsvp（回复日程邀请）
飞书云文档 / Docx / 知识库 Wiki 文档（v2）：创建、打开、读取、获取、查看、总结、整理、改写、翻译、审阅和编辑飞书文档内容。当用户给出飞书文档 URL/token，或说查看/读取/打开某个文档、提取文档内容、总结文档、生成/创建文档、追加/替换/删除/移动内容、调整排版、插入或下载文档图片/附件/素材/画板缩略图时使用。文档内容中出现嵌入电子表格、多维表格、需要将重要信息可视化为画板（含 SVG 画板）、引用或同步块时，也先用本 skill 读取和提取 token，再切到对应 skill 下钻。使用本 skill 时，docs +create、docs +fetch、docs +update 必须携带 --api-version v2；默认使用 DocxXML，也支持 Markdown。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URL 路径模式和 token，而不是域名。
飞书云空间（云盘/云存储）：管理云空间（云盘/云存储）中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题（docx、sheet、bitable、file、folder、wiki）；也负责把本地 Word/Markdown/Excel/CSV/PPTX 以及 Base 快照（.base）导入为飞书在线云文档（docx、sheet、bitable、slides）。当用户需要上传或下载文件、整理云空间（云盘/云存储）目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base/幻灯片 时使用。"云空间"、"云盘"和"云存储"是同一概念，用户说"云盘"、"云存储"、"网盘"、"我的空间"时均路由到本 skill。当用户给出 doubao.com 的云空间资源 URL/token，或明确提到豆包里的 file/folder/docx/sheet/bitable/wiki 资源时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是资源类型、URL 路径模式和 token，而不是域名。
飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据时使用。
| name | quiz-html |
| description | 把题目数组生成一个**可独立运行的网页练习页**（HTML 文件）。当用户完成 quiz-mastery 的「从资料出题」或「从文件提取题目」流程后，应主动询问是否需要"在网页里练习"，确认后调用本 skill 把题目注入模板，生成 HTML 给用户。也支持用户直接说"把这些题做成网页/HTML/练习页"时触发。**不处理**：出题（→ quiz-mastery）、评分（→ quiz-mastery）、长期复习计划（→ study-buddy）。 |
把一组题目 JSON → 一个单文件 HTML 练习网页，包含：
这是本 skill 的主要入口。当 quiz-mastery 完成以下任一流程：
generate_from_material.py → 生成题目 JSON → service.import_questions() 入库import_quiz.py → 解析出题目 JSON → 入库quiz-mastery 出题完成、向用户展示题目前，主动问一句：
"题目准备好啦～ 要不要我把它们生成一个网页练习页？你可以在浏览器里慢慢做，错题会自动记下来，还能切换主题、模拟考试 🎯"
用户说"要 / 好 / 生成网页 / 来一个 / 嗯"任一肯定意思 → 调用本 skill。 用户说"不用 / 算了 / 直接在这里做" → 走原本的对话练习流程。
触发关键词：
python3 scripts/build_quiz_html.py <题目JSON文件> [--title "..." --open]
拿到题目 JSON（数组，每项是一道题）
data/sessions/<sid>/questions.json）写到临时 JSON 文件：
import json, tempfile
from pathlib import Path
tmp = Path(tempfile.mkdtemp()) / "questions.json"
tmp.write_text(json.dumps(questions, ensure_ascii=False), encoding="utf-8")
调用脚本：
python3 ~/Desktop/studybuddy_4.0/skills/quiz-html/scripts/build_quiz_html.py \
/tmp/xxx/questions.json \
--title "📚 物理 · 热学练习" \
--output ~/Desktop/quiz_物理热学_20260518.html \
--open
解析返回 JSON：
{
"success": true,
"output_path": "/Users/.../quiz_xxx.html",
"question_count": 8,
"title": "📚 物理 · 热学练习",
"subtitle": "共 8 题 · 选择×5 · 判断×2 · 填空×1 · 物理",
"id": "q_1779091201",
"size_bytes": 63752
}
告诉用户：把 HTML 路径报给用户，提示「已经在浏览器打开了，可以开始练啦 ✨」
完全兼容 quiz-mastery 输出格式，新增可选字段 category / memory_tip：
| 字段 | 必填 | 说明 |
|---|---|---|
type | ✅ | single_choice / true_false / fill_blank / short_answer |
prompt | ✅ | 题干。也兼容 question 字段（自动转换） |
options | 选择题必填 | ["A. xxx", "B. yyy", ...] |
answer | ✅ | 选择题填字母；判断题填 "True"/"False"；填空/简答填文本 |
explanation | 推荐 | 解析（强烈建议填，K12 学生需要） |
knowledge_point | 推荐 | 知识点名（侧边栏二级分组用） |
category | 推荐 | 分类路径，用"学科 / 子模块"格式："物理 / 电学"、"数学 / 分数" |
level | 可选 | 难度 1-3 |
memory_tip | 可选 | 记忆口诀，会用橙色卡片高亮显示（K12 神器） |
[
{
"type": "single_choice",
"prompt": "下列关于并联电路电流规律的说法，正确的是（ ）。",
"options": [
"A. 干路电流等于各支路电流之差",
"B. 干路电流等于各支路电流之和",
"C. 各支路电流相等",
"D. 干路电流大于任一支路电流的两倍"
],
"answer": "B",
"explanation": "并联电路中，**干路电流等于各支路电流之和**：I = I₁ + I₂ + ...",
"knowledge_point": "并联电路电流规律",
"category": "物理 / 电学",
"level": 1,
"memory_tip": "🧠 并联看路口：进多少、出多少，电流不会消失"
}
]
如果题目缺 category 字段，最好补上（哪怕基于学科推断）。否则所有题都堆到"通用"分类下，分类筛选就废了。
"物理 / 电学"、"物理 / 热学" → 顶部出 4 个细分类 chip"物理" → 只出 1 个，子模块在侧栏体现，但筛选粒度变粗category = 横向分类（哪个学科/章节），用于顶部 chips 筛选knowledge_point = 细粒度知识点，用于左侧栏二级分组默认输出到题目 JSON 同目录，文件名 quiz_<title_slug>_<时间戳>.html。
建议显式传 --output，放到 ~/Desktop/ 或一个固定目录方便用户找。
# 1. quiz-mastery 已完成出题，拿到题目数组
questions = [
{"type": "single_choice", "prompt": "...", "options": [...], "answer": "A",
"explanation": "...", "knowledge_point": "...", "category": "物理 / 电学"},
# ...
]
# 2. agent 问用户："要不要做成网页版？"
# 3. 用户："要"
# 4. agent 写临时文件 + 调用 skill
import json, subprocess, tempfile
from pathlib import Path
tmp_dir = Path(tempfile.mkdtemp(prefix="quiz_"))
qjson = tmp_dir / "questions.json"
qjson.write_text(json.dumps(questions, ensure_ascii=False), encoding="utf-8")
output = Path.home() / "Desktop" / "quiz_物理电学.html"
result = subprocess.run([
"python3",
str(Path.home() / "Desktop/studybuddy_4.0/skills/quiz-html/scripts/build_quiz_html.py"),
str(qjson),
"--title", "📚 物理 · 电学练习",
"--output", str(output),
"--open",
], capture_output=True, text=True)
info = json.loads(result.stdout)
# info["output_path"] = "/Users/.../Desktop/quiz_物理电学.html"
然后告诉用户：
「已经做好啦～ 网页已自动打开 ✨ 路径：
~/Desktop/quiz_物理电学.html慢慢做，做完会自动记录错题，下次可以筛"错题"专门攻克 💪」
| 任务 | 用谁 |
|---|---|
| 从资料出题 | quiz-mastery |
| 从文件提取题目 | quiz-mastery |
| 评分、掌握度追踪、艾宾浩斯安排 | quiz-mastery |
| 把题目做成网页给用户在浏览器练 | quiz-html（本 skill） |
| 学习计划、长期跟进 | study-buddy |
exit 1：参数错误 / 文件不存在 / 模板缺失 → 报错给用户，让用户检查路径exit 2：JSON 格式问题 / 题目数据非法 → 告诉用户哪几题被跳过，提示检查字段