day2-mcp-and-context-sync
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseDay 2: MCP & Context Sync
Day 2: MCP & Context Sync
이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.
该Skill被调用时必须严格遵守以下STOP PROTOCOL。
용어 정리
术语整理
이 스킬에서 사용하는 핵심 용어:
| 용어 | 설명 |
|---|---|
| MCP | Model Context Protocol. AI와 외부 도구를 연결하는 오픈 표준. USB-C처럼 다양한 서비스를 하나의 규격으로 연결 |
| Host / Client / Server | MCP의 3요소. Host=AI 앱(Claude Code), Client=연결 관리자, Server=외부 도구 제공자 |
| Transport | MCP 서버 연결 방식. HTTP(클라우드 서비스)와 stdio(로컬 실행) 2가지 |
| Plugin | Skill + MCP + Hook + Agent를 묶은 패키지. 설치 한 줄이면 MCP 서버까지 자동 연결 |
| subagent | Claude가 다른 Claude를 불러서 일을 시키는 것. 여러 일을 동시에 처리할 때 사용 |
| Explore 에이전트 | 프로젝트 폴더 구조를 파악해주는 전문 subagent. 읽기 전용 |
| API | 서비스가 제공하는 데이터 창구. MCP가 없을 때 직접 코드로 데이터를 가져오는 방법 |
| 스킬(Skill) | Claude Code에게 특정 작업 방법을 가르치는 문서. Day 1 Block 3-2에서 체험한 것 |
| STUB | 나중에 채울 빈칸. "여기에 나중에 내용이 들어갑니다"라는 표시. Part B에서 블록마다 하나씩 채워나간다 |
| 스켈레톤 | 빈칸(STUB)만 있는 뼈대. 건물로 치면 철골 구조만 세운 상태 |
| frontmatter | 파일 맨 위에 |
| YAML / JSON | 데이터를 정리하는 형식. 엑셀이 표로 데이터를 정리하듯, 텍스트로 정리하는 방식 |
| CLI | Command Line Interface. 터미널에 직접 명령어를 입력하는 방식 |
本Skill中使用的核心术语:
| 术语 | 说明 |
|---|---|
| MCP | Model Context Protocol。连接AI与外部工具的开放标准。类似USB-C,可通过统一标准连接各类服务 |
| Host / Client / Server | MCP的3要素。Host=AI应用(Claude Code),Client=连接管理器,Server=外部工具提供者 |
| Transport | MCP服务器连接方式。分为HTTP(云服务)和stdio(本地运行)2种 |
| Plugin | 捆绑了Skill + MCP + Hook + Agent的包。只需一行安装命令即可自动连接到MCP服务器 |
| subagent | Claude调用其他Claude完成工作的机制。用于同时处理多项任务 |
| Explore Agent | 用于识别项目文件夹结构的专业subagent,只读权限 |
| API | 服务提供的数据接口。没有MCP时通过代码直接获取数据的方式 |
| Skill | 向Claude Code教授特定工作方法的文档。即Day 1 Block 3-2中体验的内容 |
| STUB | 后续需要填充的空白占位符,标识“此处后续会补充内容”。Part B中每个模块会填充一个STUB |
| 骨架(스켈레톤) | 仅包含STUB占位符的基础框架。类比建筑中仅搭建好钢结构的状态 |
| frontmatter | 文件最顶部用 |
| YAML / JSON | 数据结构化格式。类似Excel用表格整理数据,这是用文本整理数据的方式 |
| CLI | Command 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开始。 │
└──────────────────────────────────────────────────────────┘핵심 금지 사항 (절대 위반 금지)
核心禁止事项(绝对禁止违反)
- Phase A에서 AskUserQuestion을 호출하지 않는다 (Block 6, 7, 8, 9, 10 제외) — 이 5개 블록은 사용자 선택/확인이 필수이므로 예외
- Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
- Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
- 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다
- Phase A中禁止调用AskUserQuestion(Block 6、7、8、9、10除外) — 这5个模块必须要用户选择/确认,属于例外情况
- Phase A中禁止出测验题 — QUIZ部分仅在Phase B中读取
- Phase A中禁止询问“你操作完了吗?” — 等待用户主动告知完成状态
- 同一轮中禁止同时讲解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 Skill | Block 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种连接方式 — 渐进式构建
아래 방식으로 진행한다:
- Block 5에서 기반으로 4개 소스 STUB이 포함된 스켈레톤 스킬 파일을 생성한다
templates/context-sync.md - Block 6~9에서 블록마다 하나의 도구를 다른 연결 방법으로 연결하고, 해당 소스 STUB을 실제 내용으로 채운다
- Block 10에서 실행 흐름 + 출력 포맷을 완성하고, 전체 스킬을 실행한다
핵심: 4개 도구를 일괄 연결하는 것이 아니라, 블록마다 다른 연결 방식을 실습한다.
按以下方式推进:
- Block 5中基于生成包含4个数据源STUB的骨架Skill文件
templates/context-sync.md - Block 6~9中每个模块用不同的连接方式对接一个工具,将对应数据源的STUB替换为实际内容
- Block 10中完成执行流程 + 输出格式,运行完整Skill
核心:不是一次性连接4个工具,而是每个模块练习不同的连接方式。
Part B 블록 구조
Part B模块结构
| Block | 연결 방법 | 도구 | 난이도 | 시간 |
|---|---|---|---|---|
| 5 | — | 전체 | — | ~12min |
| 6 | claude.ai Connector | Slack | ★☆☆☆ | ~15min |
| 7 | | Notion | ★★☆☆ | ~18min |
| 8 | Official Plugin ( | Linear | ★★★☆ | ~15min |
| 9 | 커뮤니티 Plugin (구조 분석) | Google Calendar/Gmail | ★★★★ | ~20min |
| 10 | — (병렬 수집 + Output + 마무리) | 전체 | — | ~20min |
| Block | 连接方式 | 工具 | 难度 | 耗时 |
|---|---|---|---|---|
| 5 | — | 全部 | — | 约12分钟 |
| 6 | claude.ai Connector | Slack | ★☆☆☆ | 约15分钟 |
| 7 | | Notion | ★★☆☆ | 约18分钟 |
| 8 | 官方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: Slack | Connector | 소스 1 STUB → 실제 내용 |
| 7 | 소스 2: Notion | | 소스 2 STUB → 실제 내용 |
| 8 | 소스 3: Linear | | 소스 3 STUB → 실제 내용 |
| 9 | 소스 4: Google | 커뮤니티 Plugin | 소스 4 STUB → 실제 내용 |
| 10 | — (완성 + 실행) | — | 실행 흐름 + 출력 포맷 완성 |
| Block | 填充的数据源 | 连接方式 | Skill文件修改区域 |
|---|---|---|---|
| 5 | —(生成骨架) | — | 生成完整骨架 |
| 6 | 数据源1: Slack | Connector | 数据源1 STUB → 实际内容 |
| 7 | 数据源2: Notion | | 数据源2 STUB → 实际内容 |
| 8 | 数据源3: Linear | | 数据源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로 프로젝트 탐색 + 기반 스켈레톤 생성 → Stop. Phase B에서 퀴즈.
templates/context-sync.md - Block 6 (Connector → Slack): Phase A에서 Connector 개념 설명 + Slack Connector 연결 안내 + 테스트 + 스킬 소스 1 채우기 → Stop. Phase B에서 퀴즈.
- Block 7 (mcp add → Notion): Phase A에서 설명 + AskUserQuestion으로 Notion 확인 + MCP 서버 등록 + 테스트 + 스킬 소스 2 채우기 → Stop. Phase B에서 퀴즈.
claude mcp add - Block 8 (Plugin → Linear): Phase A에서 Plugin 개념 설명 + + MCP 자동 등록 확인 + 테스트 + 스킬 소스 3 채우기 → Stop. Phase B에서 퀴즈.
/plugin install linear - 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探索项目 + 基于生成骨架 → 停止。Phase B中进行测验。
templates/context-sync.md - Block 6(Connector → Slack):Phase A中讲解Connector概念 + 引导连接Slack Connector + 测试 + 填充Skill数据源1 → 停止。Phase B中进行测验。
- Block 7(mcp add → Notion):Phase A中讲解+ 用AskUserQuestion确认Notion使用情况 + 注册MCP服务器 + 测试 + 填充Skill数据源2 → 停止。Phase B中进行测验。
claude mcp add - Block 8(Plugin → Linear):Phase A中讲解Plugin概念 + 执行+ 确认MCP自动注册成功 + 测试 + 填充Skill数据源3 → 停止。Phase B中进行测验。
/plugin install linear - 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 6 | Slack 사용 여부 확인 (회사 계정 제한 시 대안 안내) |
| Block 7 | Notion workspace 사용 여부 확인 |
| Block 8 | Linear 사용 여부 확인 (미사용 시 대안 Plugin 안내) |
| Block 9 | Google Calendar vs Gmail vs 둘 다 선택 |
| Block 10 | Output 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 사용 시:
- claude.ai/settings/connectors에서 Slack Connector 연결
- 로 claude.ai 섹션에 등록 확인
/mcp - 연결 테스트 후 스킬 소스 1 채우기
Slack 미사용 또는 회사 계정 제한 시 (Plan B):
- 개인 Slack workspace나 AI Native Camp Slack으로 연결
- Connector 연결 방식 자체를 체험하는 것이 핵심임을 안내
⚠️ 보안 안내: 회사 Slack은 관리자 정책상 외부 앱 연결이 차단될 수 있다. 이 경우 개인 workspace를 사용한다.
Block 6的Phase A可以使用AskUserQuestion,需要确认是否使用Slack以及是否可以正常连接。
使用Slack时:
- 在claude.ai/settings/connectors中连接Slack Connector
- 用确认claude.ai板块已注册
/mcp - 连接测试后填充Skill数据源1
不使用Slack或公司账号受限(备选方案):
- 连接个人Slack workspace或AI Native Camp Slack
- 说明核心目标是体验Connector连接方式本身
⚠️ 安全提示:公司Slack可能因管理员政策禁止外部应用连接,这种情况请使用个人workspace。
Block 7 예외 규칙
Block 7例外规则
Block 7의 Phase A는 AskUserQuestion을 사용한다. Notion 사용 여부를 확인해야 한다.
핵심 원칙: Claude가 설정을 대신 수행하고, 사용자는 결과를 확인한다.
Notion 사용 시:
- 실행
claude mcp add --transport http notion https://mcp.notion.com/mcp - 로 local 섹션에 등록 확인
/mcp - 연결 테스트 후 스킬 소스 2 채우기
Notion 미사용 시 (Plan B):
- 를 사용하여 대체 MCP 서버 검색
scripts/mcp_servers.py - 검색 결과에서 선택하여 로 등록
claude mcp add
Block 7的Phase A可以使用AskUserQuestion,需要确认是否使用Notion。
核心原则:Claude自动完成配置,用户仅需确认结果。
使用Notion时:
- 执行
claude mcp add --transport http notion https://mcp.notion.com/mcp - 用确认local板块已注册
/mcp - 连接测试后填充Skill数据源2
不使用Notion(备选方案):
- 使用搜索替代MCP服务器
scripts/mcp_servers.py - 从搜索结果中选择后用注册
claude mcp add
Block 8 예외 규칙
Block 8例外规则
Block 8의 Phase A는 AskUserQuestion을 사용한다. Linear 사용 여부를 확인해야 한다.
Linear 사용 시:
- 실행
/plugin install linear - 로 local 섹션에 Linear MCP 자동 등록 확인
/mcp - 연결 테스트 후 스킬 소스 3 채우기
Linear 미사용 시 (Plan B):
- 명령어로 설치 가능한 다른 공식 Plugin 목록 확인
/plugin - 사용 중인 도구의 Plugin이 있으면 그것을 설치
- Plugin이 없으면 Block 8은 skip하고 Block 9로 이동 가능
- 핵심: Plugin 설치 → MCP 자동 등록이라는 과정을 체험하는 것이 목표
⚠️ Plugin 설치 후 Claude Code 재시작이 필요할 수 있다. MCP 연결이 안 보이면 Claude Code를 재시작한다.
Block 8的Phase A可以使用AskUserQuestion,需要确认是否使用Linear。
使用Linear时:
- 执行
/plugin install linear - 用确认local板块已自动注册Linear MCP
/mcp - 连接测试后填充Skill数据源3
不使用Linear(备选方案):
- 用命令查看可安装的其他官方Plugin列表
/plugin - 有正在使用的工具对应的Plugin就安装该Plugin
- 没有对应Plugin可以跳过Block 8直接进入Block 9
- 核心:目标是体验「安装Plugin → 自动注册MCP」的流程
⚠️ 安装Plugin后可能需要重启Claude Code。如果看不到MCP连接请重启Claude Code。
Block 9 예외 규칙
Block 9例外规则
Block 9의 Phase A는 AskUserQuestion을 사용한다. Google Calendar vs Gmail vs 둘 다를 선택해야 한다.
Phase A 진행 순서:
- 의 EXPLAIN 섹션을 읽고 Plugin 구조를 설명한다
references/block9-skill-google.md - 실행
/plugin marketplace add team-attention/plugins-for-claude-natives - AskUserQuestion으로 Calendar/Gmail/둘 다/Skip 선택
- Explore 에이전트로 Plugin 디렉토리 구조 탐색 + 설명
- 선택한 도구 Plugin 설치 + 테스트 + 스킬 소스 4 채우기 → Stop
Block 9的Phase A可以使用AskUserQuestion,需要选择Google Calendar / Gmail / 两者都选。
Phase A执行顺序:
- 读取的EXPLAIN部分,讲解Plugin结构
references/block9-skill-google.md - 执行
/plugin marketplace add team-attention/plugins-for-claude-natives - 用AskUserQuestion让用户选择Calendar/Gmail/两者都选/跳过
- 用Explore Agent探索Plugin目录结构并讲解
- 安装选中的工具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 | | MCP 개념 이해 |
| Block 1 | | MCP 서버 추가하기 |
| Block 2 | | /mcp 명령어로 도구 탐색 |
| Block 3 | | 인기 MCP 서버 탐색 및 설치 |
| Block 4 [BONUS] | | /plugin으로 MCP 확장 |
| 模块 | 文件 | 主题 |
|---|---|---|
| Block 0 | | 理解MCP概念 |
| Block 1 | | 添加MCP服务器 |
| Block 2 | | 用/mcp命令探索工具 |
| Block 3 | | 探索并安装热门MCP服务器 |
| Block 4 [彩蛋] | | 用/plugin扩展MCP能力 |
Part B: Context Sync 스킬 만들기 (4개 도구 × 4가지 연결 방법)
Part B: 制作Context Sync Skill(4个工具 × 4种连接方式)
| 블록 | 파일 | 주제 |
|---|---|---|
| Block 5 | | Context Sync 개념 + Explore + 스켈레톤 생성 |
| Block 6 | | Connector로 Slack 연결 + 스킬 소스 1 채우기 |
| Block 7 | | |
| Block 8 | | |
| Block 9 | | Plugin 구조 분석 + Google 연결 + 스킬 소스 4 채우기 |
| Block 10 | | 병렬 수집 + Output 선택 + 최종 실행 + 마무리 |
파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은,## EXPLAIN,## EXECUTE섹션으로 구성된다.## QUIZ
| 模块 | 文件 | 主题 |
|---|---|---|
| Block 5 | | Context Sync概念 + Explore + 生成骨架 |
| Block 6 | | 用Connector连接Slack + 填充Skill数据源1 |
| Block 7 | | 用 |
| Block 8 | | 用 |
| Block 9 | | Plugin结构分析 + 连接Google服务 + 填充Skill数据源4 |
| Block 10 | | 并行采集 + 选择输出格式 + 最终运行 + 收尾 |
文件路径是相对于当前SKILL.md的相对路径。 每个参考文件都由、## EXPLAIN、## EXECUTE三个部分构成。## QUIZ
Templates / Scripts 파일 맵
模板/脚本文件映射
| 파일 | 용도 |
|---|---|
| Context Sync 스킬 기본 템플릿 (Slack, Notion, Gmail, GCal 4종 포함) |
| GitHub에서 MCP 서버 검색 + README.md 파싱 + 설치 안내 |
Gmail/Calendar 등의 수집 스크립트는 Block 7에서 Claude가 사용자의 선택에 맞춰 직접 작성한다.
| 文件 | 用途 |
|---|---|
| Context Sync Skill基础模板(包含Slack、Notion、Gmail、GCal 4种数据源) |
| 从GitHub搜索MCP服务器 + 解析README.md + 提供安装指引 |
Gmail/Calendar等采集脚本会在Block 7中由Claude根据用户选择自动生成。
진행 규칙
执行规则
- 한 번에 한 블록씩 진행한다
- "다음", "skip", 블록 번호/이름으로 이동한다
- BONUS 블록(Block 4)은 시간이 남을 때만 진행한다
- Part A(Block 0
4) 완료 후 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을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를 로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다
curl
- 一次只推进一个模块
- 可以通过“下一步”、“skip”、模块编号/名称跳转
- 彩蛋模块(Block 4)仅在时间充裕时进行
- Part A(Block 0
4)完成后自然过渡到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回答不准确,用将官方文档保存到文件后用Read工具仔细读取,用准确信息重新回答
curl
시작
开始
스킬 시작 시 먼저 최신 커리큘럼을 설치한 뒤 블록을 선택한다.
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 | 주제 | 내용 |
|---|---|---|
| 0 | MCP 개념 | MCP가 뭔지, USB-C 비유, 아키텍처 |
| 1 | 서버 추가 | |
| 2 | /mcp 탐색 | 연결된 서버와 도구 목록 확인 |
| 3 | 인기 서버 | 공식 목록에서 유용한 서버 설치 |
| 4 [BONUS] | Plugin + MCP | /plugin으로 MCP 포함 플러그인 설치 |
Part B: 나만의 Context Sync 스킬 만들기 (4개 도구 × 4가지 연결 방법)
| Block | 연결 방법 | 도구 | 내용 |
|---|---|---|---|
| 5 | — | 전체 | Context Sync 개념 + 스켈레톤 생성 |
| 6 | Connector | Slack | 브라우저 클릭으로 Slack 연결 |
| 7 | | Notion | CLI 명령어로 Notion 연결 |
| 8 | Plugin ( | Linear | 공식 Plugin으로 Linear 연결 |
| 9 | 커뮤니티 Plugin | Plugin 구조 분석 + 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 | 主题 | 内容 |
|---|---|---|
| 0 | MCP概念 | MCP是什么、USB-C类比、架构 |
| 1 | 添加服务器 | 用 |
| 2 | /mcp探索 | 查看已连接的服务器和工具列表 |
| 3 | 热门服务器 | 从官方列表安装实用服务器 |
| 4 [彩蛋] | Plugin + MCP | 用/plugin安装包含MCP的插件 |
Part B: 制作专属于你的Context Sync Skill(4个工具 × 4种连接方式)
| Block | 连接方式 | 工具 | 内容 |
|---|---|---|---|
| 5 | — | 全部 | Context Sync概念 + 生成骨架 |
| 6 | Connector | Slack | 点击浏览器即可连接Slack |
| 7 | | Notion | 用CLI命令连接Notion |
| 8 | Plugin( | Linear | 用官方Plugin连接Linear |
| 9 | 社区Plugin | Plugin结构分析 + 连接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开始推进。