summary-generator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Summary Generator

摘要生成器

Overview

概述

This skill generates concise, scannable summaries for educational lessons by extracting the essential learning elements through Socratic questioning. Summaries serve two user needs: quick review (students returning to refresh understanding) and just-in-time reference (students checking back mid-practice).

本技能通过苏格拉底式提问提取核心学习要素，为教学课程生成简洁、易读的摘要。摘要满足两类用户需求：快速复习（学生回顾知识点以巩固理解）和即时参考（学生在练习过程中查阅相关内容）。

Extraction Process (Socratic Style)

提取流程（苏格拉底式）

To generate a summary, work through these questions in order. Each question extracts content for one section of the summary.

要生成摘要，请按顺序回答以下问题。每个问题对应摘要中的一个板块内容。

Question 1: Core Concept

问题1：核心概念

"If a student remembers only ONE thing from this lesson tomorrow, what must it be?"

Extract the single most important takeaway in 1-2 sentences. This should be the foundational insight that unlocks everything else.

Test: Could someone who only read this sentence explain the lesson's purpose to a peer?

"如果学生明天只能记住这节课的一个知识点，那必须是什么？"

提取最核心的知识点，用1-2句话表述。这应该是能串联起所有其他内容的基础性洞见。

验证标准：只读过这句话的人能否向同伴解释本节课的核心目标？

Question 2: Key Mental Models

问题2：关键思维模型

"What mental frameworks does this lesson install in the student's mind? What 'lenses' do they now see problems through?"

Extract 2-3 mental models—these are the reusable thinking patterns, not facts. Look for:

Cause → Effect relationships
Decision frameworks ("When X, do Y")
Conceptual metaphors or analogies

Test: Are these transferable to new situations, or are they lesson-specific facts?

"本节课会在学生脑中建立哪些思维框架？他们现在能用什么‘视角’来看待问题？"

提取2-3个思维模型——这些是可复用的思考模式，而非具体事实。重点关注：

因果关系
决策框架（"当出现X情况时，采取Y行动"）
概念隐喻或类比

验证标准：这些模型能否迁移到新场景，还是仅适用于本节课的特定事实？

Question 3: Critical Patterns

问题3：关键实践模式

"What practical techniques or patterns does this lesson teach? What can the student now DO that they couldn't before?"

Extract 2-4 actionable patterns from the lesson. These come from:

Code examples and their purpose
AI collaboration techniques
Tools or commands introduced
Workflows demonstrated

Test: Could a student apply these patterns without re-reading the lesson?

"本节课教授了哪些实用技巧或模式？学生现在能完成哪些之前无法做到的事？"

从课程中提取2-4个可落地的实践模式，来源包括：

代码示例及其用途
AI协作技巧
介绍的工具或命令
演示的工作流程

验证标准：学生无需重读课程就能应用这些模式吗？

Question 4: AI Collaboration Keys

问题4：AI协作要点

"How does AI help with this topic? What prompts or collaboration patterns make the difference?"

Extract 1-2 insights about working with AI on this topic. This should NOT expose the Three Roles framework—focus on practical collaboration patterns.

Note: Skip this section if the lesson doesn't involve AI collaboration (Layer 1 content).

AI如何助力该主题的学习？哪些提示词或协作模式能带来关键差异？

提取1-2个关于AI协作该主题的要点。请勿提及“三重角色框架”，重点关注实用的协作模式。

注意：如果课程不涉及AI协作（即第一层内容），请跳过此板块。

Question 5: Common Mistakes

问题5：常见错误

"Where do students typically go wrong? What misconceptions does this lesson correct?"

Extract 2-3 common mistakes from:

Explicit "Common Mistakes" sections
Error examples in the lesson
Counterintuitive points that contradict assumptions

Test: Would knowing these prevent a real mistake?

"学生通常会在哪些地方出错？本节课纠正了哪些误解？"

从以下来源提取2-3个常见错误：

明确标注的“常见错误”板块
课程中的错误示例
与直觉相反、打破固有认知的知识点

验证标准：了解这些内容能否避免实际错误？

Question 6: Connections

问题6：关联知识点

"What prerequisite knowledge does this build on? Where does this lead next?"

Extract navigation links:

Builds on: What prior concepts are assumed
Leads to: What this enables in future lessons

Note: This section is optional. Skip if connections aren't clear or useful.

"本节课基于哪些前置知识？学习完本节课后可继续深入哪些内容？"

提取导航链接：

基于：课程预设的前置概念
延伸至：本节课为后续课程奠定的基础内容

注意：此板块为可选内容。如果关联不清晰或无实用价值，请跳过。

Output Template

输出模板

Generate the summary following this exact structure:

markdown

undefined

请严格按照以下结构生成摘要：

markdown

undefined

Core Concept

[1-2 sentences from Question 1]

Key Mental Models

[Model Name]: [Brief explanation]
[Model Name]: [Brief explanation]
[Model Name if needed]: [Brief explanation]

[Model Name]: [Brief explanation]
[Model Name]: [Brief explanation]
[Model Name if needed]: [Brief explanation]

Critical Patterns

[Pattern/technique 1]
[Pattern/technique 2]
[Pattern/technique 3 if applicable]
[AI collaboration pattern if applicable]

[Pattern/technique 1]
[Pattern/technique 2]
[Pattern/technique 3 if applicable]
[AI collaboration pattern if applicable]

Common Mistakes

[Mistake 1 and why it's wrong]
[Mistake 2 and why it's wrong]
[Mistake 3 if applicable]

[Mistake 1 and why it's wrong]
[Mistake 2 and why it's wrong]
[Mistake 3 if applicable]

Connections

Builds on: [Prior concept/chapter]
Leads to: [Next concept/chapter]

undefined

Builds on: [Prior concept/chapter]
Leads to: [Next concept/chapter]

undefined

Length Guidelines

篇幅指南

Adjust summary length based on lesson complexity (from frontmatter

proficiency_level

Proficiency	Target Length	Reason
A1-A2 (Beginner)	150-250 words	Simpler concepts, fewer patterns
B1-B2 (Intermediate)	200-350 words	More nuanced, multiple techniques
C1-C2 (Advanced)	250-400 words	Complex topics, many interconnections

根据课程的熟练程度等级（从前端元数据

proficiency_level

获取）调整摘要篇幅：

熟练等级	目标篇幅	原因
A1-A2（初学者）	150-250词	概念简单，模式较少
B1-B2（中级）	200-350词	内容更细致，包含多种技巧
C1-C2（高级）	250-400词	主题复杂，存在大量关联

Anti-Patterns (What NOT to Include)

反模式（请勿包含以下内容）

Following Principle 7: Minimal Sufficient Content, summaries must NOT contain:

❌ Full explanations — Summaries point to concepts, not re-teach them
❌ Code examples — The full lesson contains these
❌ Practice exercises — Students return to the lesson for practice
❌ "What's Next" navigation — Course structure handles this
❌ Motivational content — No "Congratulations!" or fluff
❌ Layer/Stage labels — Students experience pedagogy, not study it
❌ Framework terminology — No "Three Roles", "Layer 2", etc.

遵循原则7：最小必要内容，摘要中禁止包含：

❌ 完整解释 — 摘要仅指向概念，而非重新教授内容
❌ 代码示例 — 完整课程中已包含这些内容
❌ 练习题目 — 学生需返回原课程进行练习
❌ “下一步”导航 — 课程结构会处理该内容
❌ 激励性内容 — 禁止出现“恭喜你！”之类的冗余内容
❌ 层级/阶段标签 — 学生只需体验教学过程，无需研究教学法
❌ 框架术语 — 禁止提及“三重角色”、“第二层”等术语

File Naming Convention

文件命名规范

Summary files are named by appending

.summary.md

to the lesson filename (without extension):

undefined

摘要文件的命名规则为：在课程文件名（不含扩展名）后追加

.summary.md

：

undefined

Lesson file:

课程文件：

apps/learn-app/docs/05-Python/17-intro/01-what-is-python.md

Summary file:

摘要文件：

apps/learn-app/docs/05-Python/17-intro/01-what-is-python.summary.md

undefined

apps/learn-app/docs/05-Python/17-intro/01-what-is-python.summary.md

undefined

Workflow

工作流程

Read the target lesson file completely
Extract the lesson's proficiency level from frontmatter
Answer each Socratic question, noting extracted content
Compose the summary using the template
Validate against anti-patterns checklist
Check word count against length guidelines
Write the
```
.summary.md
```
file

阅读完整的目标课程文件
提取课程元数据中的熟练等级
回答每个苏格拉底式问题，记录提取的内容
撰写符合模板要求的摘要
验证是否符合反模式检查清单
核对字数是否符合篇幅指南
生成
```
.summary.md
```
文件

Example: Data Types Lesson Summary

示例：数据类型课程摘要

For a lesson teaching Python data types at A2 proficiency:

markdown

undefined

针对教授Python数据类型的A2等级课程：

markdown

undefined

Core Concept

Data types are Python's classification system—they tell Python "what kind of data is this?" and "what operations are valid?"

Key Mental Models

Types → Operations: Numbers enable math; text enables joining; booleans enable decisions
Type Mismatch → Error:
```
5 + "hello"
```
fails because Python can't add numbers to text
Type Decision Framework: Ask "What kind of data?" to determine the right type

Types → Operations: Numbers enable math; text enables joining; booleans enable decisions
Type Mismatch → Error:
```
5 + "hello"
```
fails because Python can't add numbers to text
Type Decision Framework: Ask "What kind of data?" to determine the right type

Critical Patterns

Use
```
type()
```
to verify what type Python assigned:
```
type(42)
```
returns
```
<class 'int'>
```
Type hints express intent:
```
age: int = 25
```
tells both AI and humans what you expect
7 categories cover all data: Numeric, Text, Boolean, Collections, Binary, Special (None)

Use
```
type()
```
to verify what type Python assigned:
```
type(42)
```
returns
```
<class 'int'>
```
Type hints express intent:
```
age: int = 25
```
tells both AI and humans what you expect
7 categories cover all data: Numeric, Text, Boolean, Collections, Binary, Special (None)

Common Mistakes

Storing numbers as text (
```
"25"
```
instead of
```
25
```
) prevents math operations
Forgetting that
```
0.1 + 0.2
```
doesn't exactly equal
```
0.3
```
(floating point precision)
Mixing types in operations without explicit conversion

Storing numbers as text (
```
"25"
```
instead of
```
25
```
) prevents math operations
Forgetting that
```
0.1 + 0.2
```
doesn't exactly equal
```
0.3
```
(floating point precision)
Mixing types in operations without explicit conversion

Connections

Builds on: Python installation and first programs (Chapter 17)
Leads to: Deep dive into numeric types and text handling (Chapters 18-20)


**Word count**: ~175 words (appropriate for A2)

Builds on: Python installation and first programs (Chapter 17)
Leads to: Deep dive into numeric types and text handling (Chapters 18-20)


**字数统计**：约175词（符合A2等级要求）