SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场generate-flashcards

generate-flashcards

写作与研究

查看项目

更新于 10-16 07:50

技能介绍

用途

generate-flashcards 用于从课程内容（lesson content）生成基于学习科学的 flashcard YAML 文件。它从课程 .md 文件中提取概念，生成两类卡片：记忆卡（recall cards）和思考卡（thinking cards），两者各占约一半。

主要能力

记忆卡（Recall Cards）

  • 遵循最小信息原则：一个问题，一个答案。
  • 问题简洁但明确，不超过 40 词。
  • 每张卡片自包含、原子化，只测试一个概念。
  • 聚焦关键术语、公式和关系。
  • 答案不超过 15 词，只给事实，不含解释。
  • 难度为 basic 或 intermediate。
  • 不包含 why 字段。

思考卡（Thinking Cards）

  • 聚焦理解而非死记硬背。
  • 问题必须是 Why 或 How 问题。
  • 答案需包含因果推理链（BECAUSE/THEREFORE），20-40 词。
  • 始终包含 why 字段（单个问题，不超过 20 词）。
  • 难度为 intermediate 或 advanced。
  • 问题形式需多样化：场景、反事实、比较、因果链等；每套卡片中最多 2 张使用“Why does the [source] argue/say/recommend...”模板。

卡片生成流程

  1. 定位课程文件（通过章节号或课程名查找）。
  2. 检查是否已有 flashcard 文件：存在且未要求重新生成则跳过；存在且要求重新生成则提升 deck.version 后重新生成；不存在则新建（version: 1）。
  3. 通读课程 .md 文件，识别值得记忆和值得理解的内容。
  4. 提取概念清单，为每个概念标记 R（记忆候选）或 T（思考候选）。
  5. 按概念清单生成卡片，先确定卡片类型再撰写。
  6. 自检：自包含性、是否可被鹦鹉回答、思考卡是否含推理链、是否测试两个概念、答案是否以 Yes/No 开头、词数限制、问题是否以 ? 结尾、why 字段规则、记忆/思考比例（目标 45%-55%）、难度分布（basic 25-35%，intermediate 45-55%，advanced 15-25%）等。
  7. 覆盖审计：每个 H2/H3 标题至少一张卡片；每个编号列表至少一张记忆卡和一张思考卡。
  8. 类型纯度检查：思考卡答案是否含因果链，记忆卡答案是否超 15 词或含解释。
  9. 按 YAML schema 写出 <lesson-basename>.flashcards.yaml，与 .md 文件同目录。

卡片密度

  • 目标约每 150-200 词正文一张卡片（不计代码块和配置示例）。
  • 下限 8 张，上限 25 张。
  • 若课程可制卡概念少于 8 个，则生成更少卡片，不得填充。

编号列表规则

当课程围绕编号列表组织时（如“8 个反对意见”“5 个部署阶段”“4 种变现模式”），每个条目至少一张卡片。

卡片 ID 策略

卡片 ID 必须全局唯一，格式为 {deck.id}-\d{3}，例如 deck.id 为 ch05-reusable-skills 时，卡片 ID 为 ch05-reusable-skills-001。

课程文件中的标题约定

在课程 .md 文件中添加 flashcard 时使用：

## Flashcards Study Aid

<Flashcards />

使用方式

该技能通过命令行查找课程文件，例如：

# "ch N" 或 "chapter N" — 替换章节号：
ls -d apps/learn-app/docs/*/NN-*/

# 直接使用课程名：
find apps/learn-app/docs -name "*lesson-slug*" -name "*.md"

检查已有卡片：

ls "$(dirname /absolute/path/to/lesson.md)/$(basename /absolute/path/to/lesson.md .md).flashcards.yaml" 2>/dev/null

生成时需先规划，使用 tasks 工具组织计划并跟踪进度。

适用场景

  • 课程 .md 文件需要生成 flashcard。
  • 章节目录需要生成 flashcard。
  • 需要为编号列表、框架、定义等结构化内容制作复习卡片。

限制

  • 卡片答案不得以 Yes 或 No 开头（校验脚本会拒绝）。
  • 记忆卡答案必须少于 15 词，思考卡答案 20-40 词。
  • 思考卡问题必须显式包含 Why 或 How。
  • 记忆卡不得包含 why 字段，思考卡必须包含非空 why 字段。
  • 每张卡片中的数字、百分比和专有名词必须与源课程逐字一致；若为推断或计算所得，需核实或移除。
  • 不得将多个概念合并到一张卡片。
  • 难度分布需满足 basic 25-35%、intermediate 45-55%、advanced 15-25%。
  • 若任一质量门未通过，需修改卡片并重新检查。

暂未提供

关于该技能的具体安装命令、收费方式、支持平台等信息，资料中暂未提供。