day2-mcp-and-context-sync

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Day 2: MCP & Context Sync

Day 2: MCP & Context Sync

이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.

该Skill被调用时必须严格遵守以下STOP PROTOCOL

용어 정리

术语整理

이 스킬에서 사용하는 핵심 용어:
용어설명
MCPModel Context Protocol. AI와 외부 도구를 연결하는 오픈 표준. USB-C처럼 다양한 서비스를 하나의 규격으로 연결
Host / Client / ServerMCP의 3요소. Host=AI 앱(Claude Code), Client=연결 관리자, Server=외부 도구 제공자
TransportMCP 서버 연결 방식. HTTP(클라우드 서비스)와 stdio(로컬 실행) 2가지
PluginSkill + MCP + Hook + Agent를 묶은 패키지. 설치 한 줄이면 MCP 서버까지 자동 연결
subagentClaude가 다른 Claude를 불러서 일을 시키는 것. 여러 일을 동시에 처리할 때 사용
Explore 에이전트프로젝트 폴더 구조를 파악해주는 전문 subagent. 읽기 전용
API서비스가 제공하는 데이터 창구. MCP가 없을 때 직접 코드로 데이터를 가져오는 방법
스킬(Skill)Claude Code에게 특정 작업 방법을 가르치는 문서. Day 1 Block 3-2에서 체험한 것
STUB나중에 채울 빈칸. "여기에 나중에 내용이 들어갑니다"라는 표시. Part B에서 블록마다 하나씩 채워나간다
스켈레톤빈칸(STUB)만 있는 뼈대. 건물로 치면 철골 구조만 세운 상태
frontmatter파일 맨 위에
---
로 감싼 정보 영역. 스킬의 이름, 설명, 트리거 등을 적는 곳
YAML / JSON데이터를 정리하는 형식. 엑셀이 표로 데이터를 정리하듯, 텍스트로 정리하는 방식
CLICommand Line Interface. 터미널에 직접 명령어를 입력하는 방식

本Skill中使用的核心术语:
术语说明
MCPModel Context Protocol。连接AI与外部工具的开放标准。类似USB-C,可通过统一标准连接各类服务
Host / Client / ServerMCP的3要素。Host=AI应用(Claude Code),Client=连接管理器,Server=外部工具提供者
TransportMCP服务器连接方式。分为HTTP(云服务)和stdio(本地运行)2种
Plugin捆绑了Skill + MCP + Hook + Agent的包。只需一行安装命令即可自动连接到MCP服务器
subagentClaude调用其他Claude完成工作的机制。用于同时处理多项任务
Explore Agent用于识别项目文件夹结构的专业subagent,只读权限
API服务提供的数据接口。没有MCP时通过代码直接获取数据的方式
Skill向Claude Code教授特定工作方法的文档。即Day 1 Block 3-2中体验的内容
STUB后续需要填充的空白占位符,标识“此处后续会补充内容”。Part B中每个模块会填充一个STUB
骨架(스켈레톤)仅包含STUB占位符的基础框架。类比建筑中仅搭建好钢结构的状态
frontmatter文件最顶部用
---
包裹的信息区域,用于填写Skill的名称、描述、触发条件等
YAML / JSON数据结构化格式。类似Excel用表格整理数据,这是用文本整理数据的方式
CLICommand Line Interface。直接在终端输入命令的交互方式

STOP PROTOCOL — 절대 위반 금지

STOP PROTOCOL — 绝对禁止违反

이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다.
本协议是该Skill的最高优先级规则。 违反以下规则会导致课程无法正常进行。

각 블록은 반드시 2턴에 걸쳐 진행한다

每个模块必须分2轮进行

┌─ Phase A (첫 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 EXPLAIN 섹션을 읽는다    │
│ 2. 기능을 설명한다                                        │
│ 3. references/에서 해당 블록 파일의 EXECUTE 섹션을 읽는다    │
│ 4. "지금 직접 실행해보세요"라고 안내한다                     │
│ 5. ⛔ 여기서 반드시 STOP. 턴을 종료한다.                    │
│                                                          │
│ ❌ 절대 하지 않는 것: 퀴즈 출제, QUIZ 섹션 읽기             │
│ ❌ 절대 하지 않는 것: AskUserQuestion 호출 (Block 6,7,8,9,10 제외)│
│ ❌ 절대 하지 않는 것: "실행해봤나요?" 질문                   │
└──────────────────────────────────────────────────────────┘

  ⬇️ 사용자가 돌아와서 "했어", "완료", "다음" 등을 입력한다

┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다       │
│ 2. AskUserQuestion으로 퀴즈를 출제한다                     │
│ 3. 정답/오답 피드백을 준다                                 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다         │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터.                │
└──────────────────────────────────────────────────────────┘
┌─ Phase A(第一轮) ──────────────────────────────┐
│ 1. 读取references/对应模块文件的EXPLAIN部分    │
│ 2. 讲解对应功能                                        │
│ 3. 读取references/对应模块文件的EXECUTE部分    │
│ 4. 提示“请现在直接动手操作”                     │
│ 5. ⛔ 此处必须停止,结束本轮交互。                    │
│                                                          │
│ ❌ 绝对禁止操作:出测验题、读取QUIZ部分             │
│ ❌ 绝对禁止操作:调用AskUserQuestion(Block 6、7、8、9、10除外)│
│ ❌ 绝对禁止操作:询问“你操作完了吗?”                   │
└──────────────────────────────────────────────────────────┘

  ⬇️ 用户返回后输入“做了”、“完成”、“下一步”等内容

┌─ Phase B(第二轮) ──────────────────────────────┐
│ 1. 读取references/对应模块文件的QUIZ部分       │
│ 2. 通过AskUserQuestion出测验题                     │
│ 3. 给出答对/答错的反馈                                 │
│ 4. 通过AskUserQuestion询问是否进入下一个模块         │
│ 5. ⛔ 进入下一个模块后重新从Phase A开始。                │
└──────────────────────────────────────────────────────────┘

핵심 금지 사항 (절대 위반 금지)

核心禁止事项(绝对禁止违反)

  1. Phase A에서 AskUserQuestion을 호출하지 않는다 (Block 6, 7, 8, 9, 10 제외) — 이 5개 블록은 사용자 선택/확인이 필수이므로 예외
  2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
  3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
  4. 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다
  1. Phase A中禁止调用AskUserQuestion(Block 6、7、8、9、10除外) — 这5个模块必须要用户选择/确认,属于例外情况
  2. Phase A中禁止出测验题 — QUIZ部分仅在Phase B中读取
  3. Phase A中禁止询问“你操作完了吗?” — 等待用户主动告知完成状态
  4. 同一轮中禁止同时讲解EXPLAIN和进行QUIZ — 必须拆分为2轮进行

공식 문서 URL 출력 (절대 누락 금지)

官方文档URL输出(绝对禁止遗漏)

모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의
> 공식 문서:
URL을 반드시 그대로 출력한다.
📖 공식 문서: [URL]
  • reference 파일에 URL이 여러 개 있으면 전부 출력한다
  • URL을 요약하거나 생략하지 않는다
  • 참가자가 직접 클릭해서 공식 문서를 볼 수 있어야 한다
所有模块的Phase A开始时,必须原样输出对应参考文件顶部的
> 官方文档:
URL。
📖 官方文档: [URL]
  • 参考文件中有多个URL时全部输出
  • 不得对URL进行缩写或省略
  • 必须保证参与者可以直接点击访问官方文档

Phase A 종료 시 필수 문구

Phase A结束时的固定提示语

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:
---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.
이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.

Phase A的末尾必须输出以下格式的提示语后停止交互:
---
👆 请动手操作以上内容。
操作完成后请输入“完成”或“下一步”。
该提示语之后不得输出任何工具调用(包括AskUserQuestion)或额外文本。

소요 시간

所需时间

Part블록예상 시간
Part A: MCP 딥다이브Block 0~4~60분
Part B: Context Sync 스킬 만들기Block 5~10~110분
합계Block 0~10~170분

部分模块预计耗时
Part A: MCP深入学习Block 0~4约60分钟
Part B: 制作Context Sync SkillBlock 5~10约110分钟
总计Block 0~10约170分钟

핵심 전략

核心策略

Part A: MCP 개념부터 Plugin까지 체계적으로 배우기

Part A: 从MCP概念到Plugin体系化学习

MCP의 개념(Block 0)부터 시작해서, 서버 추가(Block 1), 도구 탐색(Block 2), 인기 서버 설치(Block 3), Plugin으로 확장(Block 4)까지 순서대로 진행한다.
从MCP概念(Block 0)开始,按顺序完成添加服务器(Block 1)、工具探索(Block 2)、安装热门服务器(Block 3)、通过Plugin扩展(Block 4)的流程。

Part B: 4개 도구 × 4가지 연결 방법 — 점진적 빌드

Part B: 4个工具 × 4种连接方式 — 渐进式构建

아래 방식으로 진행한다:
  1. Block 5에서
    templates/context-sync.md
    기반으로 4개 소스 STUB이 포함된 스켈레톤 스킬 파일을 생성한다
  2. Block 6~9에서 블록마다 하나의 도구를 다른 연결 방법으로 연결하고, 해당 소스 STUB을 실제 내용으로 채운다
  3. Block 10에서 실행 흐름 + 출력 포맷을 완성하고, 전체 스킬을 실행한다
핵심: 4개 도구를 일괄 연결하는 것이 아니라, 블록마다 다른 연결 방식을 실습한다.
按以下方式推进:
  1. Block 5中基于
    templates/context-sync.md
    生成包含4个数据源STUB的骨架Skill文件
  2. Block 6~9中每个模块用不同的连接方式对接一个工具,将对应数据源的STUB替换为实际内容
  3. Block 10中完成执行流程 + 输出格式,运行完整Skill
核心:不是一次性连接4个工具,而是每个模块练习不同的连接方式

Part B 블록 구조

Part B模块结构

Block연결 방법도구난이도시간
5전체~12min
6claude.ai ConnectorSlack★☆☆☆~15min
7
claude mcp add
Notion★★☆☆~18min
8Official Plugin (
/plugin
)
Linear★★★☆~15min
9커뮤니티 Plugin (구조 분석)Google Calendar/Gmail★★★★~20min
10— (병렬 수집 + Output + 마무리)전체~20min
Block连接方式工具难度耗时
5全部约12分钟
6claude.ai ConnectorSlack★☆☆☆约15分钟
7
claude mcp add
Notion★★☆☆约18分钟
8官方Plugin(
/plugin
Linear★★★☆约15分钟
9社区Plugin(结构分析)Google Calendar/Gmail★★★★约20分钟
10—(并行采集 + 输出 + 收尾)全部约20分钟

점진적 빌드 — 템플릿 채움 순서

渐进式构建 — 模板填充顺序

Block 5:  [STUB] [STUB] [STUB] [STUB] [STUB흐름] [STUB포맷]
Block 6:  [Slack] [STUB] [STUB] [STUB] [STUB흐름] [STUB포맷]
Block 7:  [Slack] [Notion] [STUB] [STUB] [STUB흐름] [STUB포맷]
Block 8:  [Slack] [Notion] [Linear] [STUB] [STUB흐름] [STUB포맷]
Block 9:  [Slack] [Notion] [Linear] [Google] [STUB흐름] [STUB포맷]
Block 10: [Slack] [Notion] [Linear] [Google] [완성흐름] [완성포맷] → 실행!
Block 5:  [STUB] [STUB] [STUB] [STUB] [STUB流程] [STUB格式]
Block 6:  [Slack] [STUB] [STUB] [STUB] [STUB流程] [STUB格式]
Block 7:  [Slack] [Notion] [STUB] [STUB] [STUB流程] [STUB格式]
Block 8:  [Slack] [Notion] [Linear] [STUB] [STUB流程] [STUB格式]
Block 9:  [Slack] [Notion] [Linear] [Google] [STUB流程] [STUB格式]
Block 10: [Slack] [Notion] [Linear] [Google] [完成流程] [完成格式] → 运行!

블록-소스 매핑

模块-数据源映射

Block채우는 소스연결 방법스킬 파일 변경 영역
5— (골격 생성)전체 스켈레톤 생성
6소스 1: SlackConnector소스 1 STUB → 실제 내용
7소스 2: Notion
claude mcp add
소스 2 STUB → 실제 내용
8소스 3: Linear
/plugin install
소스 3 STUB → 실제 내용
9소스 4: Google커뮤니티 Plugin소스 4 STUB → 실제 내용
10— (완성 + 실행)실행 흐름 + 출력 포맷 완성

Block填充的数据源连接方式Skill文件修改区域
5—(生成骨架)生成完整骨架
6数据源1: SlackConnector数据源1 STUB → 实际内容
7数据源2: Notion
claude mcp add
数据源2 STUB → 实际内容
8数据源3: Linear
/plugin install
数据源3 STUB → 实际内容
9数据源4: Google社区Plugin数据源4 STUB → 实际内容
10—(完成+运行)完成执行流程 + 输出格式

블록 특수 규칙

模块特殊规则

Part A (Block 0~4)

Part A(Block 0~4)

  • Block 4 [BONUS]: 시간이 남을 때만 진행한다
  • Block 3 완료 후 Part A 마무리 안내 → Part B 전환 안내
  • Part A에서 배운 MCP 지식이 Part B의 도구 연결(Block 7)에서 직접 활용된다
  • Block 4 [彩蛋]:仅在时间充裕时进行
  • Block 3完成后提示Part A收尾 → 引导进入Part B
  • Part A中学到的MCP知识会直接应用到Part B的工具连接(Block 7)中

Part B (Block 5~10)

Part B(Block 5~10)

  • Block 5 (스켈레톤 생성): Phase A에서 Context Sync 개념 + 4가지 연결 방법 소개 + Explore로 프로젝트 탐색 +
    templates/context-sync.md
    기반 스켈레톤 생성 → Stop. Phase B에서 퀴즈.
  • Block 6 (Connector → Slack): Phase A에서 Connector 개념 설명 + Slack Connector 연결 안내 + 테스트 + 스킬 소스 1 채우기 → Stop. Phase B에서 퀴즈.
  • Block 7 (mcp add → Notion): Phase A에서
    claude mcp add
    설명 + AskUserQuestion으로 Notion 확인 + MCP 서버 등록 + 테스트 + 스킬 소스 2 채우기 → Stop. Phase B에서 퀴즈.
  • Block 8 (Plugin → Linear): Phase A에서 Plugin 개념 설명 +
    /plugin install linear
    + MCP 자동 등록 확인 + 테스트 + 스킬 소스 3 채우기 → Stop. Phase B에서 퀴즈.
  • Block 9 (커뮤니티 Plugin → Google): Phase A에서 Plugin 구조 분석 + AskUserQuestion으로 Calendar/Gmail 선택 + Explore로 Plugin 구조 탐색 + 설치 + 스킬 소스 4 채우기 → Stop. Phase B에서 퀴즈.
  • Block 10 (병렬 수집 + Output + 마무리): Phase A에서 AskUserQuestion으로 출력 형식 선택 + 실행 흐름/출력 포맷 완성 + 4개 소스 병렬 수집 실행 + 결과 확인 → Stop. Phase B에서 종합 퀴즈 + 마무리.
  • Block 5(生成骨架):Phase A中讲解Context Sync概念 + 4种连接方式介绍 + 用Explore探索项目 + 基于
    templates/context-sync.md
    生成骨架 → 停止。Phase B中进行测验。
  • Block 6(Connector → Slack):Phase A中讲解Connector概念 + 引导连接Slack Connector + 测试 + 填充Skill数据源1 → 停止。Phase B中进行测验。
  • Block 7(mcp add → Notion):Phase A中讲解
    claude mcp add
    + 用AskUserQuestion确认Notion使用情况 + 注册MCP服务器 + 测试 + 填充Skill数据源2 → 停止。Phase B中进行测验。
  • Block 8(Plugin → Linear):Phase A中讲解Plugin概念 + 执行
    /plugin install linear
    + 确认MCP自动注册成功 + 测试 + 填充Skill数据源3 → 停止。Phase B中进行测验。
  • Block 9(社区Plugin → Google):Phase A中讲解Plugin结构分析 + 用AskUserQuestion选择Calendar/Gmail/两者都选 + 用Explore Agent探索Plugin结构 + 安装 + 填充Skill数据源4 → 停止。Phase B中进行测验。
  • Block 10(并行采集 + 输出 + 收尾):Phase A中用AskUserQuestion选择输出格式 + 完成执行流程/输出格式 + 运行4个数据源并行采集 + 确认结果 → 停止。Phase B中进行综合测验 + 收尾。

AskUserQuestion 예외 블록

AskUserQuestion例外模块

Block이유
Block 6Slack 사용 여부 확인 (회사 계정 제한 시 대안 안내)
Block 7Notion workspace 사용 여부 확인
Block 8Linear 사용 여부 확인 (미사용 시 대안 Plugin 안내)
Block 9Google Calendar vs Gmail vs 둘 다 선택
Block 10Output format 선택
Block原因
Block 6确认是否使用Slack(公司账号受限的话提供替代方案)
Block 7确认是否使用Notion workspace
Block 8确认是否使用Linear(不使用的话提供替代Plugin指引)
Block 9选择Google Calendar / Gmail / 两者都选
Block 10选择输出格式

Block 6 예외 규칙

Block 6例外规则

Block 6의 Phase A는 AskUserQuestion을 사용한다. Slack 사용 여부와 연결 가능 여부를 확인해야 한다.
Slack 사용 시:
  1. claude.ai/settings/connectors에서 Slack Connector 연결
  2. /mcp
    로 claude.ai 섹션에 등록 확인
  3. 연결 테스트 후 스킬 소스 1 채우기
Slack 미사용 또는 회사 계정 제한 시 (Plan B):
  1. 개인 Slack workspace나 AI Native Camp Slack으로 연결
  2. Connector 연결 방식 자체를 체험하는 것이 핵심임을 안내
⚠️ 보안 안내: 회사 Slack은 관리자 정책상 외부 앱 연결이 차단될 수 있다. 이 경우 개인 workspace를 사용한다.
Block 6的Phase A可以使用AskUserQuestion,需要确认是否使用Slack以及是否可以正常连接。
使用Slack时:
  1. 在claude.ai/settings/connectors中连接Slack Connector
  2. /mcp
    确认claude.ai板块已注册
  3. 连接测试后填充Skill数据源1
不使用Slack或公司账号受限(备选方案):
  1. 连接个人Slack workspace或AI Native Camp Slack
  2. 说明核心目标是体验Connector连接方式本身
⚠️ 安全提示:公司Slack可能因管理员政策禁止外部应用连接,这种情况请使用个人workspace。

Block 7 예외 규칙

Block 7例外规则

Block 7의 Phase A는 AskUserQuestion을 사용한다. Notion 사용 여부를 확인해야 한다.
핵심 원칙: Claude가 설정을 대신 수행하고, 사용자는 결과를 확인한다.
Notion 사용 시:
  1. claude mcp add --transport http notion https://mcp.notion.com/mcp
    실행
  2. /mcp
    로 local 섹션에 등록 확인
  3. 연결 테스트 후 스킬 소스 2 채우기
Notion 미사용 시 (Plan B):
  1. scripts/mcp_servers.py
    를 사용하여 대체 MCP 서버 검색
  2. 검색 결과에서 선택하여
    claude mcp add
    로 등록
Block 7的Phase A可以使用AskUserQuestion,需要确认是否使用Notion。
核心原则:Claude自动完成配置,用户仅需确认结果。
使用Notion时:
  1. 执行
    claude mcp add --transport http notion https://mcp.notion.com/mcp
  2. /mcp
    确认local板块已注册
  3. 连接测试后填充Skill数据源2
不使用Notion(备选方案):
  1. 使用
    scripts/mcp_servers.py
    搜索替代MCP服务器
  2. 从搜索结果中选择后用
    claude mcp add
    注册

Block 8 예외 규칙

Block 8例外规则

Block 8의 Phase A는 AskUserQuestion을 사용한다. Linear 사용 여부를 확인해야 한다.
Linear 사용 시:
  1. /plugin install linear
    실행
  2. /mcp
    로 local 섹션에 Linear MCP 자동 등록 확인
  3. 연결 테스트 후 스킬 소스 3 채우기
Linear 미사용 시 (Plan B):
  1. /plugin
    명령어로 설치 가능한 다른 공식 Plugin 목록 확인
  2. 사용 중인 도구의 Plugin이 있으면 그것을 설치
  3. Plugin이 없으면 Block 8은 skip하고 Block 9로 이동 가능
  4. 핵심: Plugin 설치 → MCP 자동 등록이라는 과정을 체험하는 것이 목표
⚠️ Plugin 설치 후 Claude Code 재시작이 필요할 수 있다. MCP 연결이 안 보이면 Claude Code를 재시작한다.
Block 8的Phase A可以使用AskUserQuestion,需要确认是否使用Linear。
使用Linear时:
  1. 执行
    /plugin install linear
  2. /mcp
    确认local板块已自动注册Linear MCP
  3. 连接测试后填充Skill数据源3
不使用Linear(备选方案):
  1. /plugin
    命令查看可安装的其他官方Plugin列表
  2. 有正在使用的工具对应的Plugin就安装该Plugin
  3. 没有对应Plugin可以跳过Block 8直接进入Block 9
  4. 核心:目标是体验「安装Plugin → 自动注册MCP」的流程
⚠️ 安装Plugin后可能需要重启Claude Code。如果看不到MCP连接请重启Claude Code。

Block 9 예외 규칙

Block 9例外规则

Block 9의 Phase A는 AskUserQuestion을 사용한다. Google Calendar vs Gmail vs 둘 다를 선택해야 한다.
Phase A 진행 순서:
  1. references/block9-skill-google.md
    의 EXPLAIN 섹션을 읽고 Plugin 구조를 설명한다
  2. /plugin marketplace add team-attention/plugins-for-claude-natives
    실행
  3. AskUserQuestion으로 Calendar/Gmail/둘 다/Skip 선택
  4. Explore 에이전트로 Plugin 디렉토리 구조 탐색 + 설명
  5. 선택한 도구 Plugin 설치 + 테스트 + 스킬 소스 4 채우기 → Stop
Block 9的Phase A可以使用AskUserQuestion,需要选择Google Calendar / Gmail / 两者都选。
Phase A执行顺序:
  1. 读取
    references/block9-skill-google.md
    的EXPLAIN部分,讲解Plugin结构
  2. 执行
    /plugin marketplace add team-attention/plugins-for-claude-natives
  3. 用AskUserQuestion让用户选择Calendar/Gmail/两者都选/跳过
  4. 用Explore Agent探索Plugin目录结构并讲解
  5. 安装选中的工具Plugin + 测试 + 填充Skill数据源4 → 停止

Block 10 예외 규칙

Block 10例外规则

Block 10의 Phase A는 AskUserQuestion을 사용한다. Output format을 선택해야 한다.

Block 10的Phase A可以使用AskUserQuestion,需要选择输出格式。

References 파일 맵

参考文件映射

Part A: MCP 딥다이브

Part A: MCP深入学习

블록파일주제
Block 0
references/block0-concept.md
MCP 개념 이해
Block 1
references/block1-add-server.md
MCP 서버 추가하기
Block 2
references/block2-mcp-command.md
/mcp 명령어로 도구 탐색
Block 3
references/block3-popular-servers.md
인기 MCP 서버 탐색 및 설치
Block 4 [BONUS]
references/block4-plugin-mcp.md
/plugin으로 MCP 확장
模块文件主题
Block 0
references/block0-concept.md
理解MCP概念
Block 1
references/block1-add-server.md
添加MCP服务器
Block 2
references/block2-mcp-command.md
用/mcp命令探索工具
Block 3
references/block3-popular-servers.md
探索并安装热门MCP服务器
Block 4 [彩蛋]
references/block4-plugin-mcp.md
用/plugin扩展MCP能力

Part B: Context Sync 스킬 만들기 (4개 도구 × 4가지 연결 방법)

Part B: 制作Context Sync Skill(4个工具 × 4种连接方式)

블록파일주제
Block 5
references/block5-template-creation.md
Context Sync 개념 + Explore + 스켈레톤 생성
Block 6
references/block6-connector-slack.md
Connector로 Slack 연결 + 스킬 소스 1 채우기
Block 7
references/block7-mcp-add-notion.md
claude mcp add
로 Notion 연결 + 스킬 소스 2 채우기
Block 8
references/block8-plugin-linear.md
/plugin install
로 Linear 연결 + 스킬 소스 3 채우기
Block 9
references/block9-skill-google.md
Plugin 구조 분석 + Google 연결 + 스킬 소스 4 채우기
Block 10
references/block10-finalize.md
병렬 수집 + Output 선택 + 최종 실행 + 마무리
파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은
## EXPLAIN
,
## EXECUTE
,
## QUIZ
섹션으로 구성된다.

模块文件主题
Block 5
references/block5-template-creation.md
Context Sync概念 + Explore + 生成骨架
Block 6
references/block6-connector-slack.md
用Connector连接Slack + 填充Skill数据源1
Block 7
references/block7-mcp-add-notion.md
claude mcp add
连接Notion + 填充Skill数据源2
Block 8
references/block8-plugin-linear.md
/plugin install
连接Linear + 填充Skill数据源3
Block 9
references/block9-skill-google.md
Plugin结构分析 + 连接Google服务 + 填充Skill数据源4
Block 10
references/block10-finalize.md
并行采集 + 选择输出格式 + 最终运行 + 收尾
文件路径是相对于当前SKILL.md的相对路径。 每个参考文件都由
## EXPLAIN
## EXECUTE
## QUIZ
三个部分构成。

Templates / Scripts 파일 맵

模板/脚本文件映射

파일용도
templates/context-sync.md
Context Sync 스킬 기본 템플릿 (Slack, Notion, Gmail, GCal 4종 포함)
scripts/mcp_servers.py
GitHub에서 MCP 서버 검색 + README.md 파싱 + 설치 안내
Gmail/Calendar 등의 수집 스크립트는 Block 7에서 Claude가 사용자의 선택에 맞춰 직접 작성한다.

文件用途
templates/context-sync.md
Context Sync Skill基础模板(包含Slack、Notion、Gmail、GCal 4种数据源)
scripts/mcp_servers.py
从GitHub搜索MCP服务器 + 解析README.md + 提供安装指引
Gmail/Calendar等采集脚本会在Block 7中由Claude根据用户选择自动生成。

진행 규칙

执行规则

  • 한 번에 한 블록씩 진행한다
  • "다음", "skip", 블록 번호/이름으로 이동한다
  • BONUS 블록(Block 4)은 시간이 남을 때만 진행한다
  • Part A(Block 04) 완료 후 Part B(Block 510)로 자연스럽게 전환한다. Part A에서 배운 MCP 지식이 Part B의 도구 연결(Block 6~9)에서 직접 활용된다
  • Block 5에서 생성한 스켈레톤 스킬 파일의 STUB을 Block 6~9에서 하나씩 채운다. 각 블록에서 도구를 연결한 뒤 해당 소스 섹션을 실제 내용으로 교체한다
  • 사용자 프로젝트의
    .claude/skills/my-context-sync/
    디렉토리에 스킬을 생성한다
  • Block 6~9에서 각각 Connector, mcp add, Plugin, 커뮤니티 Plugin을 통해 다른 연결 방식을 실습한다
  • Explore 에이전트와 subagent 사용이 핵심이므로 적극 활용한다
  • Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를
    curl
    로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다

  • 一次只推进一个模块
  • 可以通过“下一步”、“skip”、模块编号/名称跳转
  • 彩蛋模块(Block 4)仅在时间充裕时进行
  • Part A(Block 04)完成后自然过渡到Part B(Block 510)。Part A学到的MCP知识会直接应用到Part B的工具连接(Block 6~9)中
  • Block 5生成的骨架Skill文件的STUB会在Block 6~9中逐个填充。每个模块完成工具连接后将对应数据源部分替换为实际内容
  • Skill生成在用户项目的
    .claude/skills/my-context-sync/
    目录下
  • Block 6~9分别练习Connector、mcp add、官方Plugin、社区Plugin四种不同的连接方式
  • Explore Agent和subagent的使用是核心,需要积极引导用户使用
  • 收到Claude Code相关问题时用claude-code-guide Agent(内置工具)回答。回答后给出可一步步操作的指引,需要用户反馈时使用AskUserQuestion。如果判断内置Agent回答不准确,用
    curl
    将官方文档保存到文件后用Read工具仔细读取,用准确信息重新回答

시작

开始

스킬 시작 시 먼저 최신 커리큘럼을 설치한 뒤 블록을 선택한다.
Skill启动时先安装最新课程包再选择开始模块。

Step 1: 최신 스킬 설치

Step 1: 安装最新Skill

아래 명령어를 출력하고 Bash로 실행한다:
bash
npx skills add ai-native-camp/camp-2 --agent claude-code --yes
실행 결과를 간략히 안내한다 (예: "스킬이 최신 버전으로 설치되었습니다").
输出以下命令并用Bash执行:
bash
npx skills add ai-native-camp/camp-2 --agent claude-code --yes
简要说明执行结果(例:“Skill已安装为最新版本”)。

Step 2: 블록 선택

Step 2: 选择开始模块

아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.
Part A: MCP 딥다이브
Block주제내용
0MCP 개념MCP가 뭔지, USB-C 비유, 아키텍처
1서버 추가
claude mcp add
로 실제 서버 연결
2/mcp 탐색연결된 서버와 도구 목록 확인
3인기 서버공식 목록에서 유용한 서버 설치
4 [BONUS]Plugin + MCP/plugin으로 MCP 포함 플러그인 설치
Part B: 나만의 Context Sync 스킬 만들기 (4개 도구 × 4가지 연결 방법)
Block연결 방법도구내용
5전체Context Sync 개념 + 스켈레톤 생성
6ConnectorSlack브라우저 클릭으로 Slack 연결
7
claude mcp add
NotionCLI 명령어로 Notion 연결
8Plugin (
/plugin
)
Linear공식 Plugin으로 Linear 연결
9커뮤니티 PluginGooglePlugin 구조 분석 + Google 연결
10전체병렬 수집 + Output + 최종 실행
json
AskUserQuestion({
  "questions": [{
    "question": "Day 2: MCP & Context Sync\n\n어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "Part A: MCP 개념 (Block 0)", "description": "MCP가 뭔지, 왜 필요한지부터 시작"},
      {"label": "Part A: 서버 추가 (Block 1)", "description": "MCP 개념을 알고 있어서 실습부터"},
      {"label": "Part B: 스켈레톤 생성 (Block 5)", "description": "MCP를 이미 알고 있어서 스킬 만들기부터"},
      {"label": "Part B: Notion 연결 (Block 7)", "description": "Slack은 연결했고, mcp add로 Notion 연결부터"}
    ],
    "multiSelect": false
  }]
})
시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.
展示以下表格,用AskUserQuestion询问从哪个模块开始。
Part A: MCP深入学习
Block主题内容
0MCP概念MCP是什么、USB-C类比、架构
1添加服务器
claude mcp add
连接实际服务器
2/mcp探索查看已连接的服务器和工具列表
3热门服务器从官方列表安装实用服务器
4 [彩蛋]Plugin + MCP用/plugin安装包含MCP的插件
Part B: 制作专属于你的Context Sync Skill(4个工具 × 4种连接方式)
Block连接方式工具内容
5全部Context Sync概念 + 生成骨架
6ConnectorSlack点击浏览器即可连接Slack
7
claude mcp add
Notion用CLI命令连接Notion
8Plugin(
/plugin
Linear用官方Plugin连接Linear
9社区PluginGooglePlugin结构分析 + 连接Google服务
10全部并行采集 + 输出设置 + 最终运行
json
AskUserQuestion({
  "questions": [{
    "question": "Day 2: MCP & Context Sync\n\n请问从哪里开始?",
    "header": "开始模块",
    "options": [
      {"label": "Part A: MCP概念(Block 0)", "description": "从MCP的定义和使用价值开始学习"},
      {"label": "Part A: 添加服务器(Block 1)", "description": "已经了解MCP概念,直接从实操开始"},
      {"label": "Part B: 生成骨架(Block 5)", "description": "已经掌握MCP,直接从制作Skill开始"},
      {"label": "Part B: 连接Notion(Block 7)", "description": "已经连接Slack,从用mcp add连接Notion开始"}
    ],
    "multiSelect": false
  }]
})
选择开始模块后 → 从对应模块的Phase A开始推进。