study-summary

study-summary - 学习笔记生成器

支持两种模式的学习笔记生成器： （支持两种模式的学习笔记生成技能）

• Classic：简洁回顾，便于快速复习
• Mastery：详细记录规则、误解和 seed 代码历史

Instructions

Terminology Policy（对初学者友好的术语规则）

尽可能在笔记中优先使用韩语表述，必要时在括号中保留英文术语。 （笔记正文尽可能优先使用韩语，必要时在括号中附上英文术语。）

如果某个技术术语首次出现在笔记中，请用一行简单说明对其进行解释。 （技术术语首次出现时，请附上一行通俗易懂的说明。）

Examples： （示例）

• 隔离边界 (isolation boundary)：阻止从 actor 外部直接更改其内部状态的边界
• 数据竞争 (data race)：同时更改同一个值，导致结果混乱的问题

Step 0: Language Selection

开始时通过选择流程让用户选择语言，而不是让用户自由输入。 （技能开始时，通过选择方式而不是自由输入来选择语言。）

• 한국어 - 用韩语撰写笔记
• English - 用英语撰写笔记

根据平台使用对应的选择方式：

• Codex CLI：如果可用，使用原生选项选择功能（带有 2 个选项的 request_user_input）。如果不可用，则显示编号选项并让用户回复 1 或 2。
• Claude Code：如果可用，使用原生选项选择 UI。如果不可用，则显示编号选项。
• Gemini CLI：如果可用，使用原生选项选择 UI。如果不可用，则显示编号选项。

选项映射：1 → 한국어，2 → English

使用用户选择的语言撰写笔记内容并进行所有交流。代码和 Swift 关键字保持英文。 （使用所选语言撰写笔记并进行交流。代码和 Swift 关键字保持英文。）

Study Mode Selection

使用相同的选择方式让用户选择学习模式： （使用相同的选择方式让用户选择学习模式。）

• Classic（讲解优先，推荐）

  • 适合希望围绕核心概念编写简洁笔记的情况
  • 整理成便于快速复习的形式
  • 适合轻量记录刚学过的主题

• Mastery（训练优先）

  • 详细记录学习者的规则、错误答案和易混淆点
  • 保留 Core Loop seed 代码和 gate 结果，便于重新学习
  • 适合追踪薄弱点并衔接后续学习

选项映射： （选项映射）

• 1 -> Classic
• 2 -> Mastery

提示示例： （提示语示例）

• 韩语： “请选择学习笔记模式。请用数字回复。\n\n1) Classic（讲解优先，推荐）\n- 简洁整理核心内容\n- 适合快速复习\n\n2) Mastery（训练优先）\n- 详细记录规则、易混淆点和 seed 代码\n- 适合衔接后续学习”
• 英语： “请选择笔记模式（请用数字回复）：\n\n1) Classic（讲解优先，推荐）\n- 简洁记录核心内容\n- 最适合快速复习\n\n2) Mastery（训练优先）\n- 详细记录规则、易混淆点和 seed 代码历史\n- 最适合后续训练”

选择后，简短确认模式并继续。 （选择后，简短确认模式并继续。）

Step 1: Analyze Conversation

扫描当前对话，以确定以下内容： （扫描当前对话，确定以下内容。）

如果对话采用 Core Loop 格式（Phase 1-3）： （如果对话采用 Core Loop 格式：）

• Mystery Hook 代码和学习者的初始预测
• Core Loop 各个周期中的每段 SEED 代码
• 预测 (PREDICT) 的结果：哪些回答通过，哪些需要补充
• 讲解 (REVEAL) 的内容和 ASCII 图示
• 学习者在 一句话总结 (RESTATE) 中整理的句子
• Anchor 输出：学习者的“如果 X，那么 Y”规则
• Anchor 输出：学习者陈述的误解／混淆点
• 引用的来源（SE 提案、WWDC、Apple 文档）

如果对话采用旧格式或自由讨论： （如果对话采用旧格式或自由讨论：）

• 涉及的主题
• 讲解的关键概念
• 展示的代码示例
• 提出的问题和给出的回答
• 学习者遇到困难或表现出色的地方

Step 2: Confirm Topics

使用 AskUserQuestion 确认要包含的内容： （使用 AskUserQuestion 确认要包含的内容。）

• 全部整理 / Everything - 整理本次对话中学到的所有内容 / 总结所有主题
• 仅最后一个主题 / Last topic only - 只整理最近讨论的主题 / 仅整理最近的主题

第 3 步：生成笔记

创建一篇 Markdown 笔记。根据第 1 步中发现的内容，使用合适的结构。 （创建 Markdown 笔记。根据第 1 步中发现的内容，使用合适的结构。）

文件路径：notes/YYYY-MM-DD-<topic-in-english>.md

模板分支标准（模式路由）： （按模式路由模板）

• Mastery 模式：使用下面的 Core Loop 详细模板。
• Classic 模式：使用下面的精简模板，除非用户明确要求使用 Core Loop 详细格式。

Mastery 模板（Core Loop 详细版）： （Mastery 模板：Core Loop 详细版）

# <Topic>

> Date: YYYY-MM-DD

## My Rules (from Anchor)

1. if X, then Y
2. if X, then Y
3. if X, then Y

## Where I Got Confused

- (learner's own description from Anchor phase)

## Key Mechanisms

(해설하기(REVEAL) 단계에서 사용한 ASCII 다이어그램과 쉬운 설명)

## Seed Codes (for review)

### Cycle 1 (easy)

```swift
// seed code from cycle 1

答案：...

第 2 轮（中等）

// seed code from cycle 2

答案：...

第 3 轮（困难）

// seed code from cycle 3

答案：...

来源

• SE-XXXX：...
• WWDC session：...
• Apple 文档：...

复习问题

1.（根据 session 的关键概念生成） 2. ... 3. ...

---

由 /study-summary 生成

**Classic template (concise recap):**
(Classic 템플릿: 간결 요약형)

```markdown
# <Topic>

> Date: YYYY-MM-DD

## Key Concepts

1. **Concept 1**: one-line explanation
2. **Concept 2**: one-line explanation
3. **Concept 3**: one-line explanation

## Code Examples

```swift
// key code examples from the session

总结

（用 3-5 行总结核心内容）

复习问题

1. ...
2. ...
3. ...

---

由 /study-summary 生成

### Step 4: Save Note

Use the Write tool to save the note to the `notes/` directory.
(Write tool을 사용하여 `notes/` 디렉토리에 노트를 저장한다.)

### Step 5: Update Learning Progress

Record learning progress in memory using `mcp__plugin_everything-claude-code-ios_memory__add_observations` (or `create_entities` if the entity doesn't exist yet):
(memory에 학습 진도를 기록한다)

Entity: `SwiftLearningProgress`

**If mode is Mastery (or detailed Core Loop template used):**
(Mastery 모드이거나 Core Loop 상세 템플릿을 사용했으면)

观察记录：

• "YYYY-MM-DD： 已完成（<level：初级/中级/高级>）"
• "YYYY-MM-DD： 误解：<Anchor 中的具体描述>"
• "YYYY-MM-DD： 关卡：第 1 轮 <通过/需改进>，第 2 轮 <通过/需改进>，第 3 轮 <通过/需改进>"

**If mode is Classic (concise template used):**
(Classic 모드의 간결 템플릿을 사용했으면)

观察记录：

• "YYYY-MM-DD： 已完成（<预估级别>）"
• "YYYY-MM-DD： 薄弱环节：<如已识别，则填写具体概念>"

### Step 6: Wrap Up

After saving, inform the user:
(저장 완료 후 안내)

笔记已保存：notes/YYYY-MM-DD-.md

进度已记录：

• 已完成：（）
• 已跟踪的误解：<简要描述>

使用 /swift-study 继续学习，或使用 /swift-quiz 进行复习。

### Rules

1. **Use the selected language** - from Step 0. Code in English. (선택한 언어로 작성)
2. **Apply mode consistently** - Classic = concise recap, Mastery = detailed training artifacts (모드 일관성 유지)
3. **Prioritize learner's own words** - Anchor rules and misconceptions should be quoted from the learner, not rewritten. (학습자 본인의 표현을 우선한다)
4. **Include seed codes in Mastery** - preserve cycle code snippets for later review. (Mastery에서는 seed 코드 포함)
5. **Specific misconception tracking** - not "weak area: concurrency" but "misconception: thought state preserved across await". (구체적인 misconception 기록)
6. **Review questions required** - at least 3 self-check questions. (복습 질문 최소 3개)
7. **Progress tracking required** - always save to memory. (진도 기록 필수)
8. **Graceful fallback** - work with old-format sessions too. (이전 형식 세션도 지원)
9. **No emojis** - clean Markdown only. (이모지 사용 금지)