learning-cards（学习卡）

Learning Cards

Spaced-repetition flashcard system on Feishu Bitable.

基于飞书多维表格的间隔复习学习卡片系统。

Full design details: references/system-design.md

完整设计文档：references/system-design.md

Prerequisites

This skill requires Feishu (Lark) Bitable access. Ensure the following before use:

本技能依赖飞书多维表格。使用前请确认以下条件：

1. OpenClaw Feishu plugin configured — The openclaw-lark plugin must be installed and connected to a Feishu tenant. See OpenClaw Feishu setup docs.

OpenClaw 飞书插件已配置 — 需安装 openclaw-lark 插件并连接到飞书租户。

1. User OAuth authorization — The user must grant Bitable read/write permissions when prompted (standard Feishu OAuth flow, handled automatically by OpenClaw).

用户 OAuth 授权 — 用户需在首次使用时授权多维表格读写权限（OpenClaw 自动处理）。

1. Bitable app scope — The Feishu app needs scopes: bitable:app, bitable:app:readonly. These are standard in the OpenClaw Feishu plugin.

多维表格权限范围 — 飞书应用需开通 bitable:app、bitable:app:readonly 权限（OpenClaw 飞书插件标配）。

No additional API keys or credentials are needed — authentication is handled by the OpenClaw Feishu plugin's existing OAuth infrastructure.

无需额外 API 密钥 — 认证由 OpenClaw 飞书插件的 OAuth 基础设施统一处理。

Setup

Create a Bitable app with one table containing these fields.

创建一个飞书多维表格，包含以下字段。

Content fields / 内容字段

Tracking fields / 追踪字段

Three Learning Phases

Phase 1: Sequential coverage / 顺序覆盖

First pass through all cards in order by 学习顺序. Goal: build a mental map of the entire knowledge base.

按学习顺序首轮过一遍，建立全局地图感。

Phase 2: Spaced review / 间隔复习

After first pass. Schedule by 下次复习时间. Mix in remaining new cards.

首轮完成后按复习时间调度，穿插新卡。

Phase 3: Mastery & transfer / 融会贯通

Cross-topic quizzes, scenario-based questions, reverse prompts (give answer → guess concept).

跨章节混合抽问、情境题、反向提问（给答案猜概念）。

Quiz Flow

1. Read all cards from Bitable
2. Compute recent accuracy (last 5 scores) → determine new:review ratio
3. Select cards:
   - Review: 下次复习时间 <= today, sorted by overdue days
   - New: 学习次数 = 0, sorted by 学习顺序
4. Mix per ratio, present one at a time
5. After each answer: score → show answer → update Bitable

Card presentation format / 出题格式

第 X 题（复习/新卡）
> [概念名] | [阶段] | [站点] | [类型]
[正面问题]

User can say "讲讲" to skip answering and see the explanation directly (score = 0).

用户可说"讲讲"跳过作答，直接看答案（计 0 分）。

85% Rule — Dynamic Ratio

Target ~85% accuracy for optimal learning speed (Wilson et al., Nature Communications, 2019).

目标保持 85% 正确率以获得最优学习速度。

Accuracy = proportion of scores >= 4 in last 5 attempts.

正确率 = 最近 5 次中得分 >= 4 的比例。

Spaced Review Algorithm

Interval based on consecutive correct answers (连续答对次数):

Post-Answer Update

After each answer, immediately update the card record:

每题答完立即更新卡片记录：

学习次数 += 1
最近得分 = score
上次复习 = today
首次学习时间 = today  (if null)

if score >= 4:       连续答对次数 += 1
elif score <= 2:     连续答对次数 = 0; 答错次数 += 1 (if score > 0)
else (score == 3):   streak unchanged

intervals = [1, 1, 3, 7, 14, 30, 90]
下次复习时间 = today + intervals[min(streak, 6)] days  (if score >= 4)
               today + 1 day                           (otherwise)

掌握程度:
  streak >= 5 → 深度理解
  streak >= 3 → 基本掌握
  studied    → 初步了解

Card Generation Guidelines

When creating cards from a book:

从书籍生成卡片时：

• 2–4 cards per chapter for conceptual books / 概念类书籍每章 2-4 张
• 1–2 per tool/API for technical books / 技术类每个工具 1-2 张
• Target 30–50 cards total / 总量 30-50 张
• Questions should be specific, not vague / 问题要具体
• Answers: 150–300 chars, use ①②③ for key points / 答案 150-300 字，序号标注

User Commands