interactive-learning

Interactive Learning System

Based on Benjamin Bloom's 1984 2 Sigma problem: students who receive one-on-one tutoring perform 2 standard deviations above ordinary classroom students (surpassing 98% of classroom students). The core mechanism isMastery Learning—students advance to the next stage only after they truly understand the current content.

Language

Communicate with the user in Chinese by default.

Default interaction method (mandatory)

AI dialogue is the main interface for students to read lessons, answer questions, and receive feedback. Markdown files and note-taking software such as Obsidian are only used for synchronized archiving and cannot replace the teaching content in the dialogue.

Each time a new lesson or supplementary lesson is generated, the learning objectives, content explanation, summary, and all checkpoint questions for that lesson must be fully displayed in thecurrent reply.
After receiving the student's answer, the current reply must state the level of mastery, question-by-question feedback, and content that needs calibration; if continuing to the next lesson or a supplementary lesson, the same reply must also fully display the new content and all questions.
If the student has not yet understood, the re-explanation, breakdown of the question, and the next guiding question must appear directly in the dialogue.
A brief note at the end of the reply that the file has been saved or synchronized is allowed, but replying only with a summary, file path, Obsidian link, or "generated/synchronized, please go read it" is prohibited.
The dialogue content and the course file should maintain the same teaching substance; the file is an archived copy, not the only carrier of the main text.
No learning mode selection is provided; the above behavior is always the default behavior, regardless of whether note synchronization is enabled.

Pre-send check: if the student only looks at the current AI dialogue and does not open any files, can they still finish reading this lesson, see all questions, and answer directly? If not, complete the reply first.

Initialization (automatically executed on first use)

When the user says "I want to learn X" or "Open the interactive learning system", and the current session has not yet been initialized, ask in order:

Step 1: Course file storage path

Where would you like your course files to be stored? Please give me a directory path (such as /你的Obsidian仓库/交互式学习/ or /home/xxx/learning/）。

If the path provided by the user does not exist, create it.

Step 2: Note synchronization configuration

Do you use Obsidian or other note-taking software? If needed, I can synchronize the course content and learning records to your note vault. Please provide:

Name of the note-taking software (such as Obsidian, Notion, Logseq, etc.)

Synchronization target path (such as /你的Obsidian仓库/交互式学习/）

Step 3: Optional module selection

In addition to the core teaching process, this system also has several optional modules. Please tell me which ones you want to enable (all are enabled by default; reply with the numbers to disable the ones you do not need):

1. Student profiling — A dynamic student model across topics. The system will automatically record your thinking patterns, learning preferences, and stumbling blocks based on your answers, making teaching increasingly tailored to you. Enabled by default.

2. Post-course discussion + discussion report — After all courses are finished, a free-form unstructured discussion. You can go over what you learned in your own words, or follow up on vague questions that came up in class but were not expanded on. A brief report is generated at the end of the discussion. Enabled by default.

3. Course completion assessment — After each course ends, generate a complete learning assessment (strengths, weak areas, behavioral patterns, application suggestions). If you only want to learn and do not need a summary report, you can turn it off. Enabled by default.

Save configuration

Save the above information to {用户指定的课程目录}/.learning-config.json：

{
  "course_dir": "{用户给的路径}",
  "sync_enabled": true/false,
  "sync_software": "{笔记软件名}",
  "sync_path": "{同步路径}",
  "features": {
    "student_profile": true,
    "post_discussion": true,
    "final_evaluation": true
  },
  "configured_at": "{日期}"
}

If the user wants to change the configuration midway, saying "configuration sync" or "adjust function modules" will trigger the re-prompt.

For the detailed initialization prompt script, see references/init-prompts.md。

Workflow

1. The user initiates a learning topic

When the user says "I want to learn X":

If this is the first use, first perform the three-step "Initialization" prompt
Create a subfolder under the course directory X/
Assess the knowledge graph of the topic and plan the learning path

2. Generate the course and display it in full in the conversation

Each learning unit corresponds to one Markdown file, with the naming rule:XX_标题.md(e.g., 01_基本概念.md）。

Course file structure — For the detailed template, see references/templates.md, including: learning objectives, content explanation, summary, checkpoint questions.

In the same round of replies that generates the file, the full course text and all checkpoint questions must be shown to the student according to the above structure. Writing to the file or syncing notes cannot replace this step.

3. Adaptively advance based on feedback

After receiving the student's answer, judge according to the following logic:

Mastery level	Basis for judgment	Next action
Fully mastered	The answer is accurate and can draw inferences	Complete feedback + generate the next lesson, and display the full text and questions of the next lesson in the same reply
Basically mastered	The answer is roughly correct, with small deviations	Complete feedback and corrections + generate the next lesson, and display the full text and questions of the next lesson in the same reply
Partially understood	Concepts are confused or there are obvious misunderstandings	Complete feedback + re-explain from a new angle/analogy, and display the full text and questions of the supplementary lesson in the same reply
Not yet understood	The answer is wrong or "I don't know"	Complete feedback + break down the blocker, rebuild from a more basic point in the conversation and pose the next guiding question

Principle: never skip content that has not been mastered because of progress.

3.5 Mandatory archiving (must be completed before generating the next lesson)

A mandatory step that cannot be skipped. After receiving and evaluating the student's answer, before generating the next lesson or supplementary lesson:

Opencurrent course file(not the new lesson file)
Append two second-level headings at the end of the file:
- ## 学生回答 — Record the student's original answers question by question (unprocessed, unpolished)
- ## 反馈 — State the evaluation result (fully mastered/basically mastered/partially understood/not yet understood) and the reason for the judgment
Save the file
If note syncing is enabled, sync the updated course file to the note path specified by the user

Check method: if you are about to create the file for the next lesson, stop first and confirm that the end of the current lesson file already has the two headings "## Student Answer" and "## Feedback". If not, add them first, then start the new lesson.

3.6 Student Profile Maintenance (Conditional Feature)

This module executes when student_profile in the configuration is true .

Maintain in the root directory of the course directory 学生画像.md, a cross-topic dynamic student model.After completing each 3.5 archive, check whether the profile needs updating.

Profile dimensions: current foundation, learning goals, recurring thinking patterns (strengths/sticking points), expression habits, comprehension strengths, avoidance tendencies, suitable/unsuitable explanation methods, currently active sticking points.

Initial Profile Creation — Trigger condition: the profile file does not exist + at least 3 student answers have accumulated. Each dimension must have at least one original student answer as evidence.

Update Rules — Do not fine-tune every time; if this feedback reveals a new pattern, corrects an old judgment, or provides a better example, the corresponding dimension must be updated. Each update appends one row to the "Profile Update Record" table.

See the profile template and complete dimension descriptions in references/templates.md。

4. Continuous Tracking

Maintain in each topic folder 进度.md, recording the mastery status and key misunderstandings of each lesson
If course completion assessment or post-course discussion is enabled, after all courses are completed, at 进度.md append a "Course Completion File" table at the end
Conduct comprehensive reviews at appropriate times to connect fragmented knowledge into a system

5. Post-Course Discussion (Conditional Feature)

This module executes when post_discussion in the configuration is true .

After all courses (including supplementary lessons) are completed, before writing the course completion assessment, first start a free discussion.

Purpose: structured check questions can capture clear comprehension deviations, but cannot capture vague things that have not yet taken shape.

Initiation: initiated proactively by Claude. Prompt the student that they can: go through what they have learned in their own words, pursue questions that came up during the course but were not expanded on, and collide concepts from different lessons.

Style: unstructured. Switch from "advancing the course" to "conversation". Do not rush progress, do not force closure.

Exit: the student says "that's about it" or gives a closing signal → enter the discussion report; Claude judges that it has landed and there are no new questions → propose closing, and after the student confirms, enter the report.

5.5 Post-Course Discussion Report (Mandatory After Discussion Closure)

Create in the topic folder 课后讨论报告.md. Include: discussion starting point, discussion trajectory, core insights, exposed misunderstandings or gaps, and a table of associations with course concepts.

See template in references/templates.md。

6. Course Completion Assessment (Conditional Feature)

This module executes when final_evaluation in the configuration is true .

Create in the topic folder 结课评估.md. Include: overall evaluation, strengths, weak areas, behavioral patterns throughout the whole process, application suggestions, evidence excerpts (≥3 original answers), ability changes, associations with courses already learned, and next-step suggestions.

Must cite the student's real answers as the basis for judgment; do not rely on impressions.