study-summary

study-summary - 学習ノートジェネレーター

2つのモードを備えた学習ノートジェネレーター： （2つのモードをサポートする学習ノート生成スキル）

• Classic：すばやく復習できる簡潔なまとめ
• Mastery：ルール、誤解、seed コードの履歴を含む詳細な記録

Instructions

用語ポリシー（初心者にやさしい用語ルール）

ノートでは、可能な限り韓国語を優先して使い、必要に応じて英語の用語を括弧内に併記します。 （ノート本文は可能な限り韓国語を優先して書き、必要な場合は英語の用語を括弧内に併記します。）

技術用語がノートに初めて登場するときは、簡単な説明を1行追加します。 （技術用語が初めて登場するときは、簡単な説明を1行添えます。）

例： （例）

• 隔離境界 (isolation boundary): actor の外部から内部状態を直接変更できないようにする境界
• データ競合 (data race): 同じ値を同時に変更して、結果が不整合になる問題

Step 0: 言語の選択

開始時に、自由入力ではなく選択式でユーザーに言語を選んでもらいます。 （スキル開始時に、自由入力ではなく選択式で言語を尋ねます）

• 한국어 - 韓国語でノートを作成します
• English - 英語でノートを作成します

プラットフォームに応じた選択方法を使用します：

• Codex CLI：利用可能な場合は、ネイティブの選択機能（2つの選択肢を指定した request_user_input）を使用します。利用できない場合は、番号付きの選択肢を表示し、1 または 2 で回答するよう求めます。
• Claude Code：利用可能な場合は、ネイティブの選択 UI を使用します。利用できない場合は、番号付きの選択肢を表示します。
• Gemini CLI：利用可能な場合は、ネイティブの選択 UI を使用します。利用できない場合は、番号付きの選択肢を表示します。

選択肢の対応：1 → 한국어、2 → English

選択された言語を、ノートの内容とすべてのコミュニケーションに使用します。コードと Swift のキーワードは英語のままにします。 （選択した言語でノートの内容とコミュニケーションを行います。コードと Swift のキーワードは英語のままにします。）

学習モードの選択

同じ選択方法で、ユーザーに学習モードを選んでもらいます： （同じ選択方法で学習モードを選んでもらいます）

• Classic（説明中心、おすすめ）

  • 核心となる概念を中心に、簡潔なノートを作りたい場合に適しています
  • すばやく復習できる形にまとめます
  • 初めて学習したテーマを気軽に記録するのに適しています

• Mastery（訓練中心）

  • 学習者のルール、誤答、混同しやすい点まで詳しく記録します
  • Core Loop の seed コードと gate の結果を残すため、再学習に役立ちます
  • 弱点の追跡や次のセッションとの連携に適しています

選択肢の対応： （選択値の対応）

• 1 -> Classic
• 2 -> Mastery

プロンプトの例： （案内文の例）

• 韓国語： "학습 노트 모드를 선택해주세요. 번호로 답해주세요.\n\n1) Classic (설명 중심, 추천)\n- 핵심 위주로 간결하게 정리\n- 빠른 복습에 적합\n\n2) Mastery (훈련 중심)\n- 규칙/혼동 포인트/seed 코드까지 상세 기록\n- 다음 세션 연계 학습에 적합"
• 英語： "Choose a notes mode (reply with a number):\n\n1) Classic (Explanation-first, Recommended)\n- Concise notes focused on core points\n- Best for quick review\n\n2) Mastery (Practice-first)\n- Detailed notes with rules, confusion points, and seed code history\n- Best for follow-up training"

選択後、モードを簡潔に確認してから続行します。 （選択後、モードを短く確認して進めます。）

Step 1: 会話の分析

現在の会話をスキャンして、以下を特定します： （現在の会話をスキャンして、以下を把握します）

会話で 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: トピックの確認

AskUserQuestion を使用して、何を含めるか確認します： （AskUserQuestion で含める内容を確認します）

• 全体をまとめる / Everything - この会話で学んだすべての内容をまとめる / すべてのトピックをまとめる
• 最後のトピックのみ / Last topic only - 最も最近扱ったトピックのみをまとめる / 最も最近のトピックのみ

ステップ 3：ノートを生成する

Markdown ノートを作成します。ステップ 1 で判明した内容に基づいて、適切な構成を使用します。 (マークダウンノートを生成します。Step 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 セッション：...
• Apple のドキュメント：...

復習問題

1. （セッションの重要な概念に基づいて生成）
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： を完了（<レベル：初級／中級／上級>）"
• "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. (이모지 사용 금지)