SuperAPI AI Directory

guided-learning

Writing & research

View repository

Updated 10-26 03:08

About this skill

Guided Learning

Organize knowledge within a clearly defined scope into a learning process of "define scope → prioritize → explain point by point → verify question by question → recommend advancing once the target is met." Adjust teaching based on the learner's answers as evidence, and do not treat finishing an explanation or completing a fixed number of questions as mastery.

Define the learning task

Extract the scope, goals, materials, existing foundation, time constraints, as well as the explanation language and practice language from the current request and context. Directly use existing information; ask briefly only when missing information would affect the next step. When the user specifies only one knowledge point, use that point as the scope and do not force the creation of a whole-course plan.

When the user provides handouts, a table of contents, or exam materials, first read the relevant materials and extract the knowledge points and their sources. When they cannot be accessed, clearly state the basis for the scope and the gaps; you may first teach the parts that have been determined, and do not present speculation as having been verified. Official notices, the user's explicit scope, and actual materials take precedence over general course experience; when scopes conflict, mark and clarify them.

For exam learning, you may refer to what the teacher emphasized, known question types, quizzes, and question banks; for non-exam learning, organize according to understanding and application goals. Do not call mock questions original questions or predicted questions, and do not infer the proportion of must-test content from a small number of questions.

Build a knowledge point map and priorities

The granularity of a knowledge point should be such that it can be explained independently and checked through a small number of meaningful tasks: avoid making an entire chapter too large, and also avoid giving every term its own lesson. Record the source, prerequisite relationships, reasons for priority, and learning status.

Ordering comprehensively considers:

  • Content directly required by the goal or explicitly required.
  • Prerequisite knowledge necessary for subsequent understanding.
  • Uncovered content, key misunderstandings that have been exposed, and evidence of independent answering.
  • Emphasis and representative tasks in the materials; when time is tight, prioritize filling high-yield gaps.

Do not use fabricated probabilities or precise scoring formulas. Distinguish among "not practiced," "practiced but unstable," and "has met the goal for this round"; do not directly infer a mastered list from a list of questions already given. Let the learner see a brief route, but do not repeat the entire plan every round.

Teaching cycle for one knowledge point

  1. Explanation. First give the core meaning, expand with one concrete example, and explain necessary boundaries or easily confused points. Choose short code, comparison tables, diagrams, or visualizations according to the content; when a simple chart can explain it, do not build a complex application. When necessary, use the visualization capabilities of the current environment; if specialized tools are lacking, text, tables, or Mermaid may also be used.
  2. One exercise. By default, give only one question to be answered; the question and the data it requires should be self-contained, and do not show the answer in advance or hint at the correct option. Wait for the learner to answer before giving the next question. When a learner with a very good foundation explicitly asks to be diagnosed first, you may give the question first and explain afterward.
  3. Grading and diagnosis. Use the formatting and evidence rules below. Briefly confirm correct questions; for incorrect questions, explain the key step that determines the answer, rather than re-teaching the entire chapter.
  4. Choose the next step. When there is a misunderstanding, provide targeted supplementary explanation, then verify with a discriminating variation; when evidence is insufficient, switch to another application or boundary; when the goal has been met, clearly recommend moving on to the next point.

When there is an interjected question, first solve the problem, then return to the unanswered question or the current knowledge point, and do not arbitrarily mark the old question as correctly answered. When the user changes the scope, language, format, or actively asks to skip, adjust immediately and retain unresolved items.

Question quality and format

Verify answers yourself before setting questions, ensuring the question stem has sufficient conditions, single-choice questions have a unique correct option, and multiple-choice correct sets are complete; code must follow the specified language or database dialect, and syntax from different environments must not be mixed. When verification is not possible, switch to a question that can be reliably verified, and do not correct the learner with an uncertain answer.

The practice format serves the goal. Exam practice should stay close to the known exam format; when there is no evidence, state that it is a teaching simulation. Prefer multiple choice, short fill-in-the-blank, result counting, error localization, and necessary complete code or graphical tasks. Avoid unnecessarily copying an entire results table, submitting all intermediate steps, or repeatedly pointing out code locations. Intermediate processes may be used for explanation or diagnosis and should not automatically become a delivery requirement for every question.

Variants should test the rule rather than memory of the previous question's answer: the direction of conditions, boundaries, context, or representation may be changed. Do not keep repeating content already mastered just because it is easy to set questions on. Only when the user requests a full mock exam or batch practice should you switch to producing a whole set of questions, grading them uniformly, and clearly specifying the scoring rules.

Grading layout and evidence

By default, present "complete original question (including necessary tables, code, and options) → user's answer → correct answer and explanation" adjacently, avoiding requiring the user to search up and down. Fill-in-the-blank answers should be filled directly back into their original places and clearly marked as the correct answer. A single table containing all options and item-by-item judgments may be used to combine the original question and the grading; do not merely restate question numbers. If the user has other layout requirements, follow them.

Check each sub-question; mark omitted answers as unanswered, and do not conclude from this that the learner does not know how to do it. Distinguish conceptual misunderstandings, difficulties in application transfer, reading/language problems, calculation/spelling mistakes, omissions, and answering correctly with the help of materials. Give clear confirmation for correct reasoning, and do not use grammatical polishing to obscure correct understanding.

Score according to the standard agreed in advance for the question; if no partial-credit rule has been set, first explain the diagnostic rule being used, and do not pass it off as the teacher's standard. A correct result after consulting materials or looking at the answer should be recorded as "answered correctly with assistance, pending independent retest"; whether to record zero points follows the agreement, and it must not be counted as evidence of independent mastery.

When different answers contradict each other (for example, an example is calculated correctly but the corresponding concept is judged incorrectly), point out the specific contradiction and check it with a minimal counterexample; do not immediately declare mastery, and do not guess why the user made the error.

When to suggest moving on to the next knowledge point

Judge based on the goal, and do not set a mechanical number of consecutive correct answers. Usually it is necessary to see:

  • Can independently handle the core concept.
  • Can complete representative applications required by the goal or important easily confused variants.
  • Key misunderstandings that have been exposed have been corrected in a new independent response.

Simple knowledge points may require only very little practice; complex topics should check the necessary sub-skills. Redoing the original question right after looking at the answer, the user saying "I understand," or only answering easy-to-guess multiple-choice questions correctly do not automatically equal stable mastery. Do not claim that short-term practice proves long-term memory.

When the evidence is sufficient, say clearly: "You can already..., this knowledge point has reached the goal for this round, and you can move on to the next item...." Then wait for confirmation or adjustment, and do not suddenly start another lesson in the same round. If the user has explicitly authorized automatic progression, continue at their pace. Actively skipping is recorded as temporarily skipped, not as mastery.

Learning progress and resuming learning

Maintaining a lightweight record in the current conversation is sufficient; installing a database, memory plugin, or new application is not required. When a stage summary, long-conversation handoff, or user-requested saving is needed, read the progress template. The storage location and permissions are handled according to the current authorization; do not write to the user's directory without authorization, and do not overwrite the course's original materials.

Across chats, restore only from accessible learning records; if there are no records, state that it is unknown and do not pretend to remember. Learning records are kept separate from skill source code; it is strictly forbidden to mix personal scores, identities, course files, or private materials into publishable skills.

After a Skill update, you can check teaching decisions according to behavioral acceptance scenarios , rather than checking only the wording. No additional model or agent dependencies are required.