content-digest

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Content Digest

内容摘要

콘텐츠 → Quiz-First 학습 → 선택적 깊이 탐색 → 근본 개념 확장.
Task Agent 기반 설계: 긴 컨텍스트는 subagent가 처리하고, 메인 세션은 최종 결론만 소비
内容 → Quiz-First学习 → 选择性深度探索 → 核心概念拓展.
基于Task Agent的设计:长上下文由子代理(subagent)处理,主会话仅消费最终结论

아키텍처 원칙

架构原则

  1. Context Separation: 긴 자막/본문은 Task agent가 처리, 메인 세션은 가벼운 md 파일만 Read
  2. Clean Transcript: 자막에서 번호, 시간 제거 → 순수 영어 텍스트만 추출
  3. Web Research Integration: 추출된 키워드로 자동 웹 리서치
  4. Single Output: 모든 처리 결과는 단일 md 파일로 저장
  1. 上下文分离:长字幕/正文由Task Agent处理,主会话仅读取轻量化md文件
  2. 纯净字幕处理:移除字幕中的编号、时间戳 → 仅保留纯英文文本
  3. 集成网页调研:基于提取的关键词自动进行网页调研
  4. 单一输出:所有处理结果保存为单个md文件

지원 콘텐츠

支持的内容类型

타입추출 방법저장 경로
YouTubeTask agent (yt-dlp + 정제)
research/digests/youtube/
X/Twitterfetch-tweet 스킬 (api.fxtwitter.com)
research/digests/tweet/
WebpageTask agent (browser + 정제)
research/digests/web/
PDFTask agent (Read + 정제)
research/digests/pdf/
类型提取方法保存路径
YouTubeTask Agent(yt-dlp + 清洗)
research/digests/youtube/
X/Twitterfetch-tweet skill(api.fxtwitter.com)
research/digests/tweet/
网页Task Agent(浏览器 + 清洗)
research/digests/web/
PDFTask Agent(Read + 清洗)
research/digests/pdf/

핵심 원칙

核心原则

  1. Quiz-First: 요약 보기 전에 퀴즈부터 (Pretesting Effect → 9-12% 향상)
  2. Knowledge Gap: 틀린 문제가 호기심을 만들고, 호기심이 기억을 강화
  3. 선택적 깊이: 사용자가 더 알고 싶은 부분만 깊게
  4. 근본 확장: 콘텐츠 너머의 기초 개념까지 웹 검색으로 확장

  1. Quiz-First:先做测验再看摘要(预测试效应 → 提升9-12%的学习效果)
  2. 知识缺口:错题激发好奇心,好奇心强化记忆
  3. 选择性深度:仅对用户想深入了解的部分进行拓展
  4. 核心拓展:通过网页搜索拓展内容之外的基础概念

워크플로우 개요 (Task Agent 기반)

工作流概述(基于Task Agent)

Phase 1: 콘텐츠 타입 감지
Phase 2: Task Agent 실행 (콘텐츠 추출 + 정제 + 웹 리서치 + md 저장)
Phase 3: 메인 세션에서 결과 md Read
Phase 4: Pre-Quiz (3문제)
Phase 5: 선택적 콘텐츠 제공
Phase 6: 본 퀴즈 (9문제)
Phase 7: Elaborative Interrogation
Phase 8: Foundation Expansion
Phase 9: 스키마 연결
Phase 10: 문서 업데이트 (퀴즈 결과 반영)
Phase 11: 후속 선택

Phase 1: 内容类型检测
Phase 2: 执行Task Agent(内容提取 + 清洗 + 网页调研 + md保存)
Phase 3: 主会话读取结果md文件
Phase 4: 预测验(3题)
Phase 5: 提供可选内容
Phase 6: 正式测验(9题)
Phase 7: 精细化探究
Phase 8: 基础概念拓展
Phase 9: 知识图谱关联
Phase 10: 更新文档(同步测验结果)
Phase 11: 后续操作选择

Phase 1: 콘텐츠 타입 감지

Phase 1: 内容类型检测

입력 패턴에 따라 콘텐츠 타입 자동 결정:
패턴타입
youtube.com
,
youtu.be
YouTube
x.com
,
twitter.com
X/Twitter
http://
,
https://
(기타)
Webpage
.pdf
파일 경로
PDF
명확하지 않으면 사용자에게 확인:
AskUserQuestion:
questions:
  - question: "어떤 콘텐츠를 분석할까요?"
    header: "Type"
    options:
      - label: "YouTube 영상"
        description: "URL을 알려주세요"
      - label: "웹페이지/아티클"
        description: "URL을 알려주세요"
      - label: "PDF 문서"
        description: "파일 경로를 알려주세요"

根据输入模式自动判断内容类型:
模式类型
youtube.com
,
youtu.be
YouTube
x.com
,
twitter.com
X/Twitter
http://
,
https://
(其他)
网页
.pdf
文件路径
PDF
若无法明确判断,则向用户确认:
AskUserQuestion:
questions:
  - question: "要分析哪种类型的内容?"
    header: "Type"
    options:
      - label: "YouTube视频"
        description: "请提供链接"
      - label: "网页/文章"
        description: "请提供链接"
      - label: "PDF文档"
        description: "请提供文件路径"

Phase 2: Task Agent 실행 (핵심)

Phase 2: 执行Task Agent(核心环节)

메인 세션의 context를 보호하면서 긴 콘텐츠를 처리
在保护主会话上下文的同时处理长内容

2-1. Task Agent 호출 패턴

2-1. Task Agent调用模式

Task:
  subagent_type: "general-purpose"
  description: "콘텐츠 추출 및 분석"
  prompt: |
    ## 목표
    {URL/파일경로}에서 콘텐츠를 추출하고 분석하여 md 파일로 저장

    ## 단계 (순서 중요)
    1. 콘텐츠 추출 (타입별 방법 적용)
    2. 텍스트 정제 (번호, 시간 제거 → 영어만 추출)
    3. 핵심 키워드 추출 (5-10개)
    4. 웹 리서치 (키워드별 WebSearch)
    5. **핵심 요약 생성** (3-5문장)
    6. **주요 인사이트 도출** (3개)
    7. **퀴즈 재료 생성** (요약/인사이트 기반으로 핵심 주제만)
    8. md 파일 저장

    ## 출력 경로
    research/digests/{type}/{YYYY-MM-DD}-{sanitized-title}.md
Task:
  subagent_type: "general-purpose"
  description: "内容提取与分析"
  prompt: |
    ## 目标
    从{URL/文件路径}提取并分析内容,保存为md文件

    ## 步骤(顺序重要)
    1. 内容提取(按类型采用对应方法)
    2. 文本清洗(移除编号、时间戳 → 仅保留英文文本)
    3. 提取核心关键词(5-10个)
    4. 网页调研(按关键词执行WebSearch)
    5. **生成核心摘要**(3-5句话)
    6. **提炼主要见解**(3条)
    7. **生成测验素材**(基于摘要/见解,仅聚焦核心主题)
    8. 保存为md文件

    ## 输出路径
    research/digests/{type}/{YYYY-MM-DD}-{sanitized-title}.md

2-2. X/Twitter 추출 (fetch-tweet 스킬 활용)

2-2. X/Twitter内容提取(使用fetch-tweet skill)

Task Agent 불필요 - fetch-tweet 스크립트로 직접 추출 (짧은 콘텐츠)
bash
undefined
无需Task Agent - 直接通过fetch-tweet脚本提取(内容较短)
bash
undefined

트윗 원문 + 인게이지먼트 데이터 추출

提取推文原文 + 互动数据

python3 .claude/skills/fetch-tweet/scripts/fetch_tweet.py "{URL}" --json

JSON 응답에서 활용할 필드:
- `tweet.text`: 트윗 본문
- `tweet.author`: 작성자 정보 (name, bio, followers)
- `tweet.likes/retweets/views`: 인게이지먼트
- `tweet.quote`: 인용 트윗 (있을 경우 동일 구조)
- `tweet.media`: 첨부 이미지/영상

트윗은 짧으므로 Task Agent 없이 메인 세션에서 직접 처리.
인용 트윗이 있으면 함께 포함하여 분석.
저장 경로: `research/digests/tweet/{YYYY-MM-DD}-{author}-{short-topic}.md`
python3 .claude/skills/fetch-tweet/scripts/fetch_tweet.py "{URL}" --json

从JSON响应中使用以下字段:
- `tweet.text`: 推文正文
- `tweet.author`: 作者信息(name, bio, followers)
- `tweet.likes/retweets/views`: 互动数据
- `tweet.quote`: 引用推文(若有则结构相同)
- `tweet.media`: 附加图片/视频

推文内容较短,直接在主会话中处理,无需Task Agent。若存在引用推文,需一并纳入分析。保存路径: `research/digests/tweet/{YYYY-MM-DD}-{author}-{short-topic}.md`

2-3. YouTube 추출 (Task Agent 내부)

2-3. YouTube内容提取(Task Agent内部执行)

bash
undefined
bash
undefined

1. 자막 추출

1. 提取字幕

yt-dlp --write-auto-sub --sub-lang "en" --skip-download
--convert-subs vtt -o "%(title)s" "{URL}"
yt-dlp --write-auto-sub --sub-lang "en" --skip-download
--convert-subs vtt -o "%(title)s" "{URL}"

2. VTT → 순수 텍스트 변환

2. 将VTT转换为纯文本

sed -E 's/^[0-9]+$//' | \ # 번호 제거 sed -E 's/[0-9]{2}:[0-9]{2}:[0-9]{2}.*//g' | \ # 타임스탬프 제거 sed -E 's/<[^>]+>//g' | \ # HTML 태그 제거 tr -s '\n' | \ # 빈 줄 정리 grep -v '^$' # 빈 줄 삭제

정제 결과: 순수 영어 텍스트만 남음 (시간, 번호, 중복 없음)
sed -E 's/^[0-9]+$//' | \ # 移除编号 sed -E 's/[0-9]{2}:[0-9]{2}:[0-9]{2}.*//g' | \ # 移除时间戳 sed -E 's/<[^>]+>//g' | \ # 移除HTML标签 tr -s '\n' | \ # 清理空行 grep -v '^$' # 删除空行

清洗结果:仅保留纯英文文本(无时间戳、编号、重复内容)

2-4. Webpage 추출 (Task Agent 내부)

2-4. 网页内容提取(Task Agent内部执行)

1. mcp__claude-in-chrome__tabs_context_mcp
2. mcp__claude-in-chrome__tabs_create_mcp
3. mcp__claude-in-chrome__navigate: url="{URL}"
4. mcp__claude-in-chrome__get_page_text: tabId={tabId}
5. 스크롤 후 추가 콘텐츠 확인
1. mcp__claude-in-chrome__tabs_context_mcp
2. mcp__claude-in-chrome__tabs_create_mcp
3. mcp__claude-in-chrome__navigate: url="{URL}"
4. mcp__claude-in-chrome__get_page_text: tabId={tabId}
5. 滚动页面检查附加内容

2-5. PDF 추출 (Task Agent 내부)

2-5. PDF内容提取(Task Agent内部执行)

Read: file_path="{PDF 경로}"
Read: file_path="{PDF路径}"

2-6. 웹 리서치 (Task Agent 내부)

2-6. 网页调研(Task Agent内部执行)

추출된 텍스트에서 핵심 키워드 5-10개 식별 후:
WebSearch (병렬 실행):
  - "{키워드1} explained"
  - "{키워드2} research"
  - "{저자/발표자} {주제}"
  - "{핵심개념} fundamentals"
从提取的文本中识别5-10个核心关键词后:
WebSearch(并行执行):
  - "{关键词1} explained"
  - "{关键词2} research"
  - "{作者/演讲者} {主题}"
  - "{核心概念} fundamentals"

2-7. 최종 md 파일 저장 (Task Agent 내부)

2-7. 保存最终md文件(Task Agent内部执行)

경로:
research/digests/{type}/{YYYY-MM-DD}-{sanitized-title}.md
markdown
---
title: {콘텐츠 제목}
type: {youtube|web|pdf}
url: {URL 또는 파일경로}
author: {저자/채널명}
date: {발행 날짜}
processed_at: {처리 일시}
keywords: [{키워드1}, {키워드2}, ...]
---
路径:
research/digests/{type}/{YYYY-MM-DD}-{sanitized-title}.md
markdown
---
title: {内容标题}
type: {youtube|web|pdf}
url: {URL或文件路径}
author: {作者/频道名}
date: {发布日期}
processed_at: {处理时间}
keywords: [{关键词1}, {关键词2}, ...]
---

{콘텐츠 제목}

{内容标题}

핵심 요약

核心摘要

{3-5문장 요약}
{3-5句话的摘要}

주요 인사이트

主要见解

  1. {인사이트1}: 설명
  2. {인사이트2}: 설명
  3. {인사이트3}: 설명
  1. {见解1}: 说明
  2. {见解2}: 说明
  3. {见解3}: 说明

웹 리서치 결과

网页调研结果

{키워드1}

{关键词1}

  • 발견 내용 요약
  • 출처: {URL}
  • 发现内容摘要
  • 来源: {URL}

{키워드2}

{关键词2}

  • 발견 내용 요약
  • 출처: {URL}
  • 发现内容摘要
  • 来源: {URL}

원문 (정제됨)

清洗后原文

{번호/시간 제거된 순수 텍스트}
{移除编号/时间戳的纯文本}

Quiz 재료 (Pre-Quiz + 본 Quiz용)

测验素材(预测验 + 正式测验用)

생성 순서: 반드시 위의 "핵심 요약"과 "주요 인사이트"를 먼저 작성한 후, 이를 기반으로 퀴즈 생성 출제 원칙: 핵심 주제만 출제. 날짜, 통계, 지엽적 세부사항 제외.
生成顺序: 务必先撰写上述“核心摘要”和“主要见解”,再基于此生成测验 出题原则: 仅聚焦核心主题。排除日期、统计数据、次要细节。

기본 레벨 (3문제 후보)

基础级(3道候选题)

  • Q1: {핵심 개념/메시지 관련}
  • Q2: {주요 원칙 관련}
  • Q3: {저자 핵심 주장 관련}
  • Q1: {核心概念/相关信息}
  • Q2: {相关主要原则}
  • Q3: {作者核心主张相关}

중급 레벨 (3문제 후보)

进阶级(3道候选题)

  • Q4: {개념 간 관계}
  • Q5: {근거와 논리 연결}
  • Q6: {핵심 아이디어 비교}
  • Q4: {概念间的关系}
  • Q5: {论据与逻辑关联}
  • Q6: {核心观点对比}

심화 레벨 (3문제 후보)

深入级(3道候选题)

  • Q7: {실제 적용/응용}
  • Q8: {핵심 원리의 확장}
  • Q9: {저자 관점의 함의}

---
  • Q7: {实际应用/运用}
  • Q8: {核心原理的拓展}
  • Q9: {作者观点的隐含意义}

---

Phase 3: 메인 세션에서 결과 Read

Phase 3: 主会话读取结果

Task Agent 완료 후:
Read: file_path="research/digests/{type}/{YYYY-MM-DD}-{sanitized-title}.md"
메인 세션은 정제된 md 파일만 읽음 → context 효율 극대화

Task Agent完成后:
Read: file_path="research/digests/{type}/{YYYY-MM-DD}-{sanitized-title}.md"
主会话仅读取清洗后的md文件 → 最大化上下文效率

Phase 4: Pre-Quiz (핵심)

Phase 4: 预测验(核心环节)

목적: 정보 갭 생성 → 주의력 프라이밍 → 능동적 학습 유도
目的: 制造信息缺口 → 引导注意力 → 激发主动学习

퀴즈 출제 원칙

测验出题原则

핵심 주제만 질문: 사소한 세부사항이나 숫자가 아닌, 콘텐츠의 핵심 메시지와 직결되는 내용만 출제
  • ✅ 핵심 개념, 주요 원칙, 저자의 핵심 주장
  • ❌ 날짜, 통계 수치, 부수적 예시, 지엽적 세부사항
결과 md 파일의 "Quiz 재료" 섹션을 활용하여 3문제 출제:
AskUserQuestion:
questions:
  - question: "[Pre-Quiz] 이 콘텐츠에서 다룰 것 같은 핵심 개념은?"
    header: "PQ1"
    options: [4개 선택지]
  - question: "[Pre-Quiz] 저자가 강조할 것 같은 메시지는?"
    header: "PQ2"
    options: [4개 선택지]
  - question: "[Pre-Quiz] 이 주제에서 가장 중요한 원칙은?"
    header: "PQ3"
    options: [4개 선택지]
결과 처리:
  • 정답/오답 즉시 표시
  • 틀린 문제 → "이 부분을 콘텐츠에서 확인해보세요" 안내
  • Knowledge Gap 생성: "이제 콘텐츠를 보면 답을 찾고 싶어질 것입니다"

仅围绕核心主题出题: 不涉及琐碎细节或数字,仅聚焦与内容核心信息直接相关的内容
  • ✅ 核心概念、主要原则、作者核心主张
  • ❌ 日期、统计数值、次要示例、边缘细节
利用结果md文件中的“测验素材”板块出3道题:
AskUserQuestion:
questions:
  - question: "[预测验] 该内容可能涉及的核心概念是?"
    header: "PQ1"
    options: [4个选项]
  - question: "[预测验] 作者可能强调的信息是?"
    header: "PQ2"
    options: [4个选项]
  - question: "[预测验] 该主题中最重要的原则是?"
    header: "PQ3"
    options: [4个选项]
结果处理:
  • 即时显示正确/错误
  • 错题 → 提示“请在内容中查看这部分”
  • 制造知识缺口: “现在查看内容的话,你会想要找到答案的”

Phase 5: 선택적 콘텐츠 제공

Phase 5: 提供可选内容

Pre-Quiz 결과에 따라 사용자에게 선택지 제공:
AskUserQuestion:
questions:
  - question: "어떤 콘텐츠를 먼저 보시겠습니까?"
    header: "Content"
    options:
      - label: "틀린 문제 관련 섹션만"
        description: "Pre-Quiz에서 틀린 부분의 답을 찾아보기"
      - label: "핵심 인사이트 3개"
        description: "콘텐츠의 가장 중요한 포인트만"
      - label: "전체 요약 + 인사이트"
        description: "종합적인 콘텐츠 분석"
      - label: "바로 본 퀴즈로"
        description: "요약 없이 9문제 퀴즈 진행"
根据预测验结果为用户提供选项:
AskUserQuestion:
questions:
  - question: "您想先查看哪种内容?"
    header: "Content"
    options:
      - label: "仅查看错题相关板块"
        description: "查找预测验错题的答案"
      - label: "3条核心见解"
        description: "仅查看内容的最重要要点"
      - label: "完整摘要 + 见解"
        description: "综合性内容分析"
      - label: "直接进入正式测验"
        description: "跳过摘要,进行9道题的测验"

5-1. 틀린 문제 관련 섹션

5-1. 错题相关板块

Pre-Quiz 오답과 관련된 섹션만 추출:
  • YouTube: 해당 타임스탬프
  • Webpage: 관련 단락
  • PDF: 해당 페이지/섹션
仅提取与预测验错题相关的板块:
  • YouTube: 对应时间戳
  • 网页: 相关段落
  • PDF: 对应页面/板块

5-2. 핵심 인사이트 (간결 모드)

5-2. 核心见解(简洁模式)

markdown
undefined
markdown
undefined

핵심 인사이트 3개

3条核心见解

  1. [키워드]: 1-2문장 설명
  2. [키워드]: 1-2문장 설명
  3. [키워드]: 1-2문장 설명
undefined
  1. [关键词]: 1-2句话说明
  2. [关键词]: 1-2句话说明
  3. [关键词]: 1-2句话说明
undefined

5-3. 전체 요약 + 인사이트

5-3. 完整摘要 + 见解

markdown
undefined
markdown
undefined

요약

摘要

{3-5문장}
{3-5句话}

인사이트

见解

핵심 아이디어

核心观点

적용 가능한 점

可应用要点


---

---

Phase 6: 본 퀴즈 (9문제)

Phase 6: 正式测验(9道题)

3단계 × 3문제. AskUserQuestion으로 각 단계 진행.
출제 원칙: 모든 문제는 콘텐츠의 핵심 주제와 직결되어야 함. 지엽적 세부사항, 날짜, 통계 수치는 출제 금지.
단계난이도출제 기준
1기본핵심 메시지, 주요 개념
2중급개념 간 관계, 근거 연결
3심화사례 분석, 적용, 구체적 데이터
문제 유형 상세:
references/quiz-patterns.md
즉각 피드백: 각 단계 완료 후 정답/해설 즉시 제공

3个难度等级 × 3道题。通过AskUserQuestion分阶段进行。
出题原则: 所有题目必须与内容核心主题直接相关。禁止出题涉及边缘细节、日期、统计数值。
阶段难度出题依据
1基础核心信息、主要概念
2进阶概念间关系、论据关联
3深入案例分析、应用、具体数据
题目类型详情:
references/quiz-patterns.md
即时反馈: 每个阶段完成后立即提供正确答案/解析

Phase 7: Elaborative Interrogation

Phase 7: 精细化探究

"왜?" 질문이 깊은 처리를 유발 (76% vs 69% 정답률 향상)
퀴즈 완료 후, 핵심 개념에 대해 심화 질문:
AskUserQuestion:
questions:
  - question: "다음 중 더 깊이 이해하고 싶은 개념은?"
    header: "Deep Dive"
    multiSelect: true
    options:
      - label: "{개념 A}"
        description: "왜 이것이 중요한지 탐구"
      - label: "{개념 B}"
        description: "이것의 근본 원리 이해"
      - label: "{개념 C}"
        description: "실제 적용 사례 확장"
      - label: "바로 다음 단계로"
        description: "현재 이해 수준으로 충분"
선택된 개념에 대해:
  1. "왜 이것이 사실인가?" 질문과 답변
  2. 콘텐츠 내 근거 위치 (타임스탬프/페이지/섹션)
  3. 웹 검색으로 추가 맥락 제공

“为什么?”的问题能引发深度处理(正确率从69%提升至76%)
测验完成后,针对核心概念提出深入问题:
AskUserQuestion:
questions:
  - question: "您想更深入理解哪个概念?"
    header: "Deep Dive"
    multiSelect: true
    options:
      - label: "{概念A}"
        description: "探究其重要性"
      - label: "{概念B}"
        description: "理解其核心原理"
      - label: "{概念C}"
        description: "拓展实际应用案例"
      - label: "直接进入下一阶段"
        description: "当前理解程度已足够"
针对选中的概念:
  1. 提出并解答“为什么这是正确的?”
  2. 标注内容中的依据位置(时间戳/页码/板块)
  3. 通过网页搜索提供额外背景信息

Phase 8: Foundation Expansion (근본 확장)

Phase 8: 核心概念拓展(基础拓展)

콘텐츠 너머의 기초 지식 확장
拓展内容之外的基础知识

8-1. 기초 개념 웹 검색 (WebSearch 병렬 3-5개)

8-1. 基础概念网页搜索(并行执行3-5次WebSearch)

검색 쿼리:
- "{핵심 개념} fundamentals explained"
- "{핵심 개념} 기초 원리"
- "{이론/방법론} research paper original"
- "{저자/발표자} other works recommendations"
搜索查询:
- "{核心概念} fundamentals explained"
- "{核心概念} 基础原理"
- "{理论/方法论} research paper original"
- "{作者/演讲者} other works recommendations"

8-2. 근본 지식 정리

8-2. 整理基础知识

markdown
undefined
markdown
undefined

Foundation Expansion

核心概念拓展

이 콘텐츠의 기초가 되는 개념들

支撑本内容的基础概念

개념설명출처
{기초 개념 1}1줄 설명{URL}
{기초 개념 2}1줄 설명{URL}
概念说明来源
{基础概念1}1句话说明{URL}
{基础概念2}1句话说明{URL}

더 깊이 들어가려면

进一步学习建议

  • 선수 지식: {이 콘텐츠를 완전히 이해하려면 알아야 할 것}
  • 후속 학습: {이 콘텐츠 다음에 볼 만한 것}
  • 관련 연구: {학술적 배경}

---
  • 前置知识: {完全理解本内容所需的知识}
  • 后续学习: {本内容之后可学习的内容}
  • 相关研究: {学术背景}

---

Phase 9: 스키마 연결 (이전 학습과 연결)

Phase 9: 知识图谱关联(与过往学习关联)

기존 지식과 연결할 때 학습 효과 극대화
research/digests/
폴더의 기존 다이제스트 스캔:
markdown
undefined
与已有知识关联时,学习效果最大化
扫描
research/digests/
文件夹中的已有摘要:
markdown
undefined

관련 학습 기록

相关学习记录

이 콘텐츠와 연결되는 이전 학습:
콘텐츠타입연결 포인트날짜
{이전 제목}{youtube/web/pdf}{공통 개념/대조되는 관점}{날짜}
与本内容相关的过往学习:
内容类型关联点日期
{过往标题}{youtube/web/pdf}{共同概念/对立观点}{日期}

지식 네트워크

知识网络

mermaid
graph LR
    A[이번 콘텐츠] --> B[공통 개념]
    C[이전 콘텐츠 1] --> B
    D[이전 콘텐츠 2] --> B

---
mermaid
graph LR
    A[本次内容] --> B[共同概念]
    C[过往内容1] --> B
    D[过往内容2] --> B

---

Phase 10: 문서 업데이트 (퀴즈 결과 반영)

Phase 10: 更新文档(同步测验结果)

Task Agent가 저장한 md 파일에 퀴즈 결과 추가:
markdown
undefined
在Task Agent保存的md文件中添加测验结果:
markdown
undefined

Pre-Quiz 결과

预测验结果

{점수 및 Knowledge Gap 기록}
{分数及知识缺口记录}

본 퀴즈 결과

正式测验结果

{점수, 오답 노트}
{分数、错题笔记}

Elaborative Interrogation

精细化探究

{선택한 개념에 대한 심화 탐구}

> 기본 콘텐츠는 Phase 2에서 이미 저장됨. 여기서는 학습 결과만 추가.

---
{选中概念的深入探究内容}

> 基础内容已在Phase 2中保存。此处仅添加学习结果。

---

Phase 11: 후속 선택

Phase 11: 后续操作选择

AskUserQuestion:
questions:
  - question: "다음으로 무엇을 하시겠습니까?"
    header: "Next"
    options:
      - label: "다른 문제로 재퀴즈"
        description: "같은 콘텐츠, 새로운 9문제"
      - label: "Deep Research"
        description: "웹 심층 조사로 확장 (references/deep-research.md)"
      - label: "관련 콘텐츠 추천"
        description: "이 주제의 다른 콘텐츠 찾기"
      - label: "종료"
        description: "학습 완료"

AskUserQuestion:
questions:
  - question: "接下来您想做什么?"
    header: "Next"
    options:
      - label: "重新测验(新题目)"
        description: "同一内容,9道新题"
      - label: "深度调研"
        description: "通过网页深度调研拓展(references/deep-research.md)"
      - label: "推荐相关内容"
        description: "查找该主题的其他内容"
      - label: "结束"
        description: "完成学习"

필수: Quiz-First 모드

强制要求:Quiz-First模式

모드 선택 없음. 항상 Quiz-First로 진행.
연구에 따르면 학습 전 테스트가 9-12% 향상 효과를 가져오며, 요약을 먼저 보면 이 효과가 사라짐.
워크플로우 (고정):
1. 콘텐츠 타입 감지
2. Task Agent 실행 (추출 + 정제 + 웹 리서치 + md 저장)
3. 메인 세션에서 결과 md Read
4. Pre-Quiz (3문제) ← 반드시 먼저
5. 선택적 콘텐츠 제공
6. 본 퀴즈 (9문제)
7-9. 심화 학습 (Elaboration, Foundation, 스키마)
10. 문서 업데이트
11. 후속 선택
사용자가 "요약만", "퀴즈 없이" 등을 요청해도:
  • "Quiz-First가 학습 효과가 9-12% 더 높습니다. 먼저 3문제만 풀어볼까요?"
  • 강하게 요청 시에만 요약 제공, 단 퀴즈 권유 메시지 포함

无模式可选。始终以Quiz-First模式运行。
研究表明,学习前进行测试可提升9-12%的效果,而先看摘要会抵消这一效果。
固定工作流:
1. 内容类型检测
2. 执行Task Agent(提取 + 清洗 + 网页调研 + md保存)
3. 主会话读取结果md文件
4. 预测验(3题)← 必须优先执行
5. 提供可选内容
6. 正式测验(9题)
7-9. 深入学习(精细化探究、基础拓展、知识图谱关联)
10. 更新文档
11. 后续操作选择
即使用户要求“仅摘要”“无需测验”等:
  • 回复“Quiz-First模式能提升9-12%的学习效果。先做3道题试试如何?”
  • 仅在用户强烈要求时提供摘要,但需包含推荐测验的信息

콘텐츠 타입별 참고사항

各内容类型注意事项

YouTube

YouTube

자막 언어 우선순위

字幕语言优先级

  1. 한국어 수동 → 2. 영어 수동 → 3. 한국어 자동 → 4. 영어 자동
  1. 韩语手动字幕 → 2. 英语手动字幕 → 3. 韩语自动字幕 → 4. 英语自动字幕

yt-dlp 옵션

yt-dlp选项

  • --list-subs
    : 자막 목록 확인
  • --cookies-from-browser chrome
    : 로그인 필요 시
  • --list-subs
    : 查看字幕列表
  • --cookies-from-browser chrome
    : 需要登录时使用

Webpage

网页

항상 claude-in-chrome 사용. WebFetch 사용 금지.
必须使用claude-in-chrome。禁止使用WebFetch。

claude-in-chrome 워크플로우

claude-in-chrome工作流

1. tabs_context_mcp로 탭 컨텍스트 확인
2. tabs_create_mcp로 새 탭 생성
3. navigate로 URL 이동
4. get_page_text로 텍스트 추출
5. scroll로 전체 콘텐츠 로드 (무한 스크롤 대응)
6. get_page_text 재호출로 추가 콘텐츠 확인
7. read_page로 구조 파악 (필요시)
1. 通过tabs_context_mcp查看标签页上下文
2. 通过tabs_create_mcp新建标签页
3. 通过navigate访问URL
4. 通过get_page_text提取文本
5. 滚动页面加载全部内容(支持无限滚动)
6. 再次调用get_page_text检查附加内容
7. 通过read_page分析结构(必要时)

장점

优势

  • 동적 콘텐츠 완벽 지원
  • 페이월/로그인 콘텐츠 접근 가능
  • 무한 스크롤 페이지 처리
  • 본문 전체를 정확히 가져옴
  • 完美支持动态内容
  • 可访问需要登录/有墙的内容
  • 处理无限滚动页面
  • 准确获取完整正文

PDF

PDF

Read 도구 특성

Read工具特性

  • 텍스트와 이미지를 동시에 인식
  • 페이지별로 처리
  • 표/차트 구조 인식 가능
  • 同时识别文本和图片
  • 按页处理
  • 可识别表格/图表结构

대용량 PDF

大容量PDF

  • 페이지 범위 지정하여 분할 처리
  • 목차 먼저 확인 후 관심 섹션 집중

  • 指定页码范围分批处理
  • 先查看目录,再聚焦感兴趣的板块

리소스

资源

  • scripts/extract_metadata.sh
    - YouTube 메타데이터 추출
  • scripts/extract_transcript.sh
    - YouTube 자막 추출
  • references/quiz-patterns.md
    - 퀴즈 문제 유형 상세
  • references/deep-research.md
    - Deep Research 워크플로우
  • references/learning-science.md
    - 학습 과학 연구 근거

  • scripts/extract_metadata.sh
    - YouTube元数据提取
  • scripts/extract_transcript.sh
    - YouTube字幕提取
  • references/quiz-patterns.md
    - 测验题目类型详情
  • references/deep-research.md
    - 深度调研工作流
  • references/learning-science.md
    - 学习科学研究依据

학습 과학 근거

学习科学依据

이 워크플로우는 다음 연구에 기반:
  1. Pretesting Effect (Richland et al., Roediger & Karpicke)
    • 학습 전 테스트 → 9-12% 향상, effect size g = 0.34-0.54
  2. Information Gap Theory (Loewenstein, 1994)
    • 지식 갭 인식 → 도파민 회로 활성화 → 기억 강화
  3. Elaborative Interrogation (Dunlosky et al., 2013)
    • "왜?" 질문 → 깊은 처리 → 76% vs 69% 정답률
  4. PACE Framework (Gruber et al., 2019)
    • 호기심 상태에서 무관한 정보도 기억력 향상
상세:
references/learning-science.md
本工作流基于以下研究:
  1. 预测试效应(Richland等人, Roediger & Karpicke)
    • 学习前测试 → 提升9-12%,效应值g = 0.34-0.54
  2. 信息缺口理论(Loewenstein, 1994)
    • 感知到知识缺口 → 激活多巴胺回路 → 强化记忆
  3. 精细化探究(Dunlosky等人, 2013)
    • “为什么?”的问题 → 深度处理 → 正确率从69%提升至76%
  4. PACE框架(Gruber等人, 2019)
    • 好奇状态下,无关信息的记忆力也会提升
详情:
references/learning-science.md