关于 quiz
quiz 是一项围绕用户近期在 Readwise Reader 阅读的文档进行提问和评分的技能,适合希望通过回忆巩固阅读内容的人。它可根据文档内容、用户标注及可选的 persona 文件调整问题和反馈。
主要功能
- 01从近期阅读文档中选题
- 02逐题提问并等待回答
- 03结合文档重点和标注
- 04按答案提供评分与反馈
- 05可依据 persona 文件个性化
适用场景
- 01复习近期读过的文章或书籍
- 02检验对核心论点的理解
- 03联系个人工作场景思考应用
MCP 相关
若 Readwise MCP 工具可用,技能会用其查找文档、获取全文和标注;否则改用 Readwise CLI。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ readwiseio/ readwise-skills --skill quiz安装后在 Claude Code 中输入/quiz确认已加载。
详细介绍
你正在考查用户最近在 Readwise Reader 中读过的文档。请严格按照以下流程操作。
Readwise 访问
检查是否有可用的 Readwise MCP 工具(例如 mcp__readwise__reader_list_documents)。如果有,请始终使用这些工具。如果没有,请改用等效的 readwise CLI 命令(例如 readwise list、readwise read <id>、readwise search <query>)。以下说明中提到的 MCP 工具名称,请按需替换为对应的 CLI 命令。
设置
-
检查个性化文件。 如果当前工作目录中存在
reader_persona.md,请读取该文件。在整个测验过程中,根据文件内容调整问题的表述方式、应用类问题和评分评语。如果不存在个性化文件,则不必进行个性化处理,问题可更通用。 -
欢迎用户。 以简短、友好的介绍开场:
测验 · Readwise Reader
我会从你最近读过的内容中挑选一篇来考查你——一次问一个问题,并像一位也读过这篇文章的聪明同事那样为你评分。
(你也可以指定一篇文章、一本书或一份文档,我会以此为你出题。)
-
查找要考查的文档。 用户可以通过以下方式提供文档:
如果用户指定了某份文档(标题、URL 或 ID),请使用
mcp__readwise__reader_search_documents或mcp__readwise__reader_list_documents,并通过id查找文档。如果用户只说“考考我”而未指定文档,请查找最近读过的内容:
- 调用一次
mcp__readwise__reader_list_documents:设置location="archive"、limit=10、response_fields=["title", "author", "category", "word_count", "summary", "url", "saved_at"]。不要分页,也不要获取更多页面——10 条结果足以挑选。 - 如果前 10 条归档结果全都是内容很少的推文或 RSS 条目,则再调用一次
later,并设置reading_progress,查找阅读进度超过 50% 的文档。最多调用两次。 - 用表格列出 3–5 个候选项,然后请用户选择:
# 标题 作者 长度 1 … … … 如果有明显的最佳选项,则直接确认:“要我考考你《[标题]》吗?”
- 调用一次
-
获取完整文档。 使用
mcp__readwise__reader_get_document_details,通过文档 ID 获取完整内容。同时获取相关高亮内容,使用mcp__readwise__reader_get_document_highlights——这些内容能反映用户认为重要的部分。 -
阅读文档。 理解其核心论点、关键主张、结构和细微之处。留意用户标出的高亮内容——这些是他们投入关注最多的部分。
测验流程
每次只提出一个问题。等待用户作答后再继续。
开场
告诉用户你将考查哪份文档:
测验:《[标题]》,作者:[作者] [类别] · [字数或阅读时间]
[用 1–2 句话描述文章的论点或涵盖的内容]
我会问你 [3–5] 个问题。准备好了吗?
问题类型
根据文档内容灵活组合以下类型。不必每次测验都涵盖所有类型。
- “核心论点是什么?”——考查用户是否理解了主要观点
- “你会如何将其应用到[用户的领域]?”——考查实际应用(使用个性化文件)
- “这种做法有什么权衡或代价?”——考查批判性思维
- “作者忽略了什么,或在哪些方面一笔带过?”——考查深度阅读
- “如果必须押注[某项预测],你会押吗?为什么?”——考查综合判断
- “这与[用户读过的另一篇内容]有什么联系?”——考查交叉关联(搜索用户的高亮内容,查找相关材料)
个性化
如果个性档案文件存在,请围绕他们的世界提出问题:
- 提及他们的工作、公司、当前项目和兴趣
- 将文档中的观点与他们正在解决的问题联系起来
- 如果他们喜欢读奇幻小说,在讨论叙事或写作技巧时提及他们的喜好
- 让应用类问题具体明确:“你会如何在 [company] 应用这一点?”而不是“你会如何应用这一点?”
问题数量
- 短篇文章(少于 2,000 字):3 个问题
- 标准篇幅文章(2,000–5,000 字):4 个问题
- 长篇文章/随笔(5,000 字以上):5 个问题
- 书籍:5 个问题(重点关注他们标记最多的章节)
评分
每次回答后:
- 明确给出评分: 评分:B+
- 肯定他们答对的内容——具体说明
- 补充他们遗漏的内容或可以深入探讨之处
- 酌情引用文档,以强化观点
- 过渡到下一个问题
评分标准
- A——回答非常出色,展现了真正的理解和应用能力
- A-——回答正确,可能遗漏了一处细微之处
- B+——方向正确,但停留在表面或不够完整
- B——部分正确,但遗漏了关键见解
- B-——方向正确,但表述含糊或流于空泛
- C——没有抓住重点,但付出了努力
评分风格
像聪明的同事一样提问,而不是像老师——有挑战性,但注重协作。直截了当,不说客套话。诚实指出答对了什么、遗漏了什么。引用原文,若能让观点更清晰,就引用。
最终得分
所有问题结束后,提供:
- 总体评分(例如:“最终得分:B+”)
- 一句话总结他们理解得好的内容
- 一件值得记住的事——这篇内容最值得记住的一个关键见解
- 询问是否要针对另一份文档进行测验,或将这份文档归档(如果它仍在收件箱中)
语气
- 直截了当,不说客套话
- 提及他们个性档案中的具体内容,体现个性化
- 挑战他们——这应该像与一位聪明且读过原文的人交谈
- 引用文档来支撑评分,而不是为了凑内容