Claude Context Sync技能创建教程：MCP工具集成与subagent并行处理实战

day2-create-context-sync-skill by ai-native-camp/camp-1

1,200 周安装量

214 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/ai-native-camp/camp-1 --skill day2-create-context-sync-skill

AI/机器学习开发生产力

🇨🇳中文介绍

Day 2: 创建你自己的 Context Sync 技能

当此技能被调用时，必须遵循下面的 STOP PROTOCOL。

术语定义

本技能中使用的核心术语：

术语	说明
MCP	Claude 与外部服务（Slack、Gmail 等）对话的通道。是 Day 1 中学到的“工具”向外部扩展的概念
subagent	Claude 调用另一个 Claude 来分配任务。用于同时处理多项任务时
Explore 代理	专门用于分析项目文件夹结构的 subagent
API	服务提供的数据接口。在没有 MCP 时，直接通过代码获取数据的方法
技能（Skill）	教给 Claude Code 特定工作方法的文档。在 Day 1 Block 3-2 中体验过

STOP PROTOCOL — 绝对禁止违反

此协议是本技能的最高优先级规则。违反以下规则将导致课程无法进行。

每个区块必须分 2 轮进行

┌─ Phase A（第一轮）─────────────────────────────────┐
│ 1. 从 references/ 中读取对应区块文件的 EXPLAIN 部分    │
│ 2. 解释功能                                          │
│ 3. 从 references/ 中读取对应区块文件的 EXECUTE 部分    │
│ 4. 引导“现在请亲自尝试执行”                            │
│ 5. ⛔ 此处必须 STOP。结束本轮。                         │
│                                                      │
│ ❌ 绝对不做的事：出题、读取 QUIZ 部分                    │
│ ❌ 绝对不做的事：调用 AskUserQuestion（Block 0,2,4 除外）│
│ ❌ 绝对不做的事：询问“执行了吗？”                        │
└──────────────────────────────────────────────────────┘

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

┌─ Phase B（第二轮）─────────────────────────────────┐
│ 1. 从 references/ 中读取对应区块文件的 QUIZ 部分        │
│ 2. 使用 AskUserQuestion 出题                          │
│ 3. 提供正确/错误反馈                                   │
│ 4. 使用 AskUserQuestion 询问是否移动到下一个区块         │
│ 5. ⛔ 如果开始下一个区块，则再次从 Phase A 开始。         │
└──────────────────────────────────────────────────────┘

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

核心禁止事项（绝对禁止违反）

Phase A 中不调用 AskUserQuestion（Block 0, 2, 4 除外） — 这三个区块因用户选择是必需的，所以例外
Phase A 中不出题 — QUIZ 部分仅在 Phase B 中读取
Phase A 中不询问“执行了吗？” — 等待用户先开口
同一轮中不同时进行 EXPLAIN + QUIZ — 必须分成 2 轮

输出官方文档 URL（绝对禁止遗漏）

所有区块的 Phase A 开始时，必须原样输出对应 reference 文件顶部的 > 官方文档： URL。

📖 官方文档：[URL]

如果 reference 文件中有多个 URL，则全部输出
不总结或省略 URL

Phase A 结束时的必需语句

Phase A 的最后必须输出以下形式的语句并 Stop：

---
👆 请亲自执行以上内容。
执行完毕后，请输入“完成”或“下一步”。

在此语句之后，不输出任何工具调用（包括 AskUserQuestion）或附加文本。

核心策略：先模板，再分步定制

按以下方式进行：

在 Block 0 中，当用户选择工具后，立即基于 templates/context-sync.md 生成技能文件
之后在 Block 1~5 中，仅修改/扩展已生成技能的对应部分
最后执行完成的技能并确认结果

模板包含了 Slack、Notion、Gmail、Google Calendar 四种工具的示例。根据用户选择的工具组合，只保留需要的部分，新工具按相同模式添加。

区块-模板部分映射

每个区块中修改的模板区域：

Block	修改目标	模板部分
0	技能骨架生成	整体（仅保留选定的工具）
1	反映项目上下文	frontmatter description，收集范围
2	确定连接方法	每个源的“收集方法”
3	收集执行 & 验证	“执行流程”部分 + 调整“提取信息”
4	输出格式设置	“输出格式”部分
5	最终整理 + 执行	整体收尾

Block 0（工具选择 + 技能生成）：Phase A 中解释 + 使用 AskUserQuestion 进行工具选择。根据选择结果基于模板生成技能 → Stop。Phase B 中对生成的技能进行确认测验。
Block 1（项目探索）：Phase A 中使用 Explore 代理分析项目结构并共享结果 → Stop。Phase B 中测验。
Block 2（工具连接）：Phase A 中引导 MCP vs API 选择 + AskUserQuestion → Claude 代为执行设置，用户确认结果 → Stop。Phase B 中测验。
Block 3（收集执行 & 验证）：Phase A 中解释 subagent 并行收集 + 执行 → 将收集结果按成功/失败分类展示 → 重试失败的源 + 检查收集数据质量 → Stop。Phase B 中测验。
Block 4（Output 设置）：Phase A 中引导 Output format 选择 + AskUserQuestion → 根据选择修改技能 → Stop。Phase B 中测验。
Block 5（完成 + 执行）：Phase A 中整理最终技能配置 + 实际执行 → Stop。Phase B 中综合测验 + 收尾。

Block 0 例外规则

Block 0 的 Phase A 使用 AskUserQuestion。因为工具选择是之后所有区块的前提条件，所以必须接收用户输入。

Phase A 进行顺序：

读取 references/block0-tool-selection.md 的 EXPLAIN 部分并解释
使用 AskUserQuestion 接收工具选择（multiSelect: true）
读取 templates/context-sync.md 模板
根据选定的工具，在用户的项目中生成 .claude/skills/my-context-sync/SKILL.md
简要展示生成文件的整体结构并 Stop（详细内容在后续区块中说明）

Block 2 例外规则

Block 2 的 Phase A 也 使用 AskUserQuestion。需要为每个工具选择 MCP 和 API 中的连接方式。

核心原则：Claude 代为执行设置，用户确认结果。

遵循 references/block2-tool-connection.md 中的 MCP 指南
使用 scripts/mcp_servers.py 从 GitHub README.md 中搜索合适的 MCP 服务器
展示搜索结果，Claude 将服务器注册到 .mcp.json
同时使用 /mcp 命令检查服务器连接状态

Claude 直接编写 API 调用代码
保存到用户的技能 scripts/ 文件夹中

Block 4 例外规则

Block 4 的 Phase A 也 使用 AskUserQuestion。需要选择 Output format。

References 文件映射

区块	文件	内容
Block 0	`references/block0-tool-selection.md`	工具选择 + 基于模板的技能生成
Block 1	`references/block1-project-explore.md`	使用 Explore 代理分析项目结构
Block 2	`references/block2-tool-connection.md`	MCP vs API 连接方式选择 + 执行
Block 3	`references/block3-parallel-collection.md`	subagent 并行收集 + 结果验证
Block 4	`references/block4-output-format.md`	Output format 选择（markdown, Slack, Notion）
Block 5	`references/block5-finalize.md`	最终技能完成 + 执行 + 收尾

文件路径是相对于此 SKILL.md 的相对路径。每个 reference 文件由 ## EXPLAIN、## EXECUTE、## QUIZ 部分组成。

Templates / Scripts 文件映射

文件	用途
`templates/context-sync.md`	Context Sync 技能基本模板（包含 Slack、Notion、Gmail、GCal 四种）
`scripts/mcp_servers.py`	从 GitHub 搜索 MCP 服务器 + 解析 README.md + 安装指南

Gmail/Calendar 等的收集脚本在 Block 2 中由 Claude 根据用户的选择直接编写。

一次进行一个区块
通过“下一步”、“skip”、区块编号/名称移动
在 Block 0 中生成的技能文件在后续区块中逐步修改
在用户项目的 .claude/skills/my-context-sync/ 目录中创建技能
Explore 代理和 subagent 的使用是核心，请积极利用
当出现 Claude Code 相关问题时，使用 claude-code-guide 代理（内置工具）回答。回答后引导用户可以亲自逐步跟随操作，提问时使用 AskUserQuestion。如果判断内置代理的回答不准确，则使用 curl 将官方文档保存到文件，然后用 Read 工具仔细阅读，并用准确的信息重新回答

技能开始时，首先安装最新课程，然后选择区块。

Step 1: 安装最新技能

输出以下命令并在 Bash 中执行：

npx skills add ai-native-camp/camp-1 --agent claude-code --yes

简要引导执行结果（例如：“4 个技能已安装为最新版本”）。

Step 2: 选择区块

展示以下表格，并使用 AskUserQuestion 询问从哪里开始。

Block	主题	内容
0	工具选择	选择要同步的工具 + 生成技能骨架
1	项目探索	使用 Explore 分析项目结构
2	工具连接	使用 MCP 或 API 连接工具
3	收集执行 & 验证	subagent 并行收集 + 结果验证
4	Output 设置	选择输出格式 + 修改技能
5	完成 + 执行	最终技能执行 + 收尾

AskUserQuestion({
  "questions": [{
    "question": "Day 2: 创建你自己的 Context Sync 技能\n\n你想从哪里开始？",
    "header": "起始区块",
    "options": [
      {"label": "从头开始（Block 0）", "description": "选择要同步的工具 + 生成技能骨架"},
      {"label": "工具连接（Block 2）", "description": "已选择工具，从 MCP/API 连接开始"},
      {"label": "收集执行 & 验证（Block 3）", "description": "连接完成，从收集开始"},
      {"label": "Output 设置（Block 4）", "description": "收集完成，从输出格式开始"}
    ],
    "multiSelect": false
  }]
})

选择起始区块后 → 从该区块的 Phase A 开始进行。

🇺🇸English

Day 2: 나만의 Context Sync 스킬 만들기

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

용어 정리

이 스킬에서 사용하는 핵심 용어:

용어	설명
MCP	Claude가 외부 서비스(Slack, Gmail 등)와 대화하는 통로. Day 1에서 배운 "도구"를 외부로 확장하는 것
subagent	Claude가 다른 Claude를 불러서 일을 시키는 것. 여러 일을 동시에 처리할 때 사용
Explore 에이전트	프로젝트 폴더 구조를 파악해주는 전문 subagent
API	서비스가 제공하는 데이터 창구. MCP가 없을 때 직접 코드로 데이터를 가져오는 방법
스킬(Skill)	Claude Code에게 특정 작업 방법을 가르치는 문서. Day 1 Block 3-2에서 체험한 것

STOP PROTOCOL — 절대 위반 금지

이 프로토콜은 이 스킬의 최우선 규칙이다. 아래 규칙을 위반하면 수업이 망가진다.

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

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

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

┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다       │
│ 2. AskUserQuestion으로 퀴즈를 출제한다                     │
│ 3. 정답/오답 피드백을 준다                                 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다         │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터.                │
└──────────────────────────────────────────────────────────┘

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

Phase A에서 AskUserQuestion을 호출하지 않는다 (Block 0, 2, 4 제외) — 이 3개 블록은 사용자 선택이 필수이므로 예외
Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다

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

모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 > 공식 문서: URL을 반드시 그대로 출력 한다.

📖 공식 문서: [URL]

reference 파일에 URL이 여러 개 있으면 전부 출력한다
URL을 요약하거나 생략하지 않는다

Phase A 종료 시 필수 문구

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:

---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.

이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.

핵심 전략: 템플릿 먼저, 단계별 커스터마이징

아래 방식으로 진행한다:

Block 0에서 사용자가 도구를 선택하면, templates/context-sync.md 기반으로 스킬 파일을 즉시 생성한다
이후 Block 1~5에서 생성된 스킬의 해당 부분만 수정/확장한다
최종적으로 완성된 스킬을 실행하여 결과를 확인한다

템플릿에는 Slack, Notion, Gmail, Google Calendar 4가지 도구의 예시가 포함되어 있다. 사용자가 선택한 도구 조합에 맞춰 필요한 부분만 남기고, 새 도구는 같은 패턴으로 추가한다.

블록-템플릿 섹션 매핑

각 블록에서 수정하는 템플릿 영역:

Block	수정 대상	템플릿 섹션
0	스킬 골격 생성	전체 (선택한 도구만 남기기)
1	프로젝트 맥락 반영	frontmatter description, 수집 범위
2	연결 방법 확정	각 소스의 "수집 방법"
3	수집 실행 & 검증	"실행 흐름" 섹션 + "추출할 정보" 조정
4	출력 형식 설정	"출력 포맷" 섹션
5	최종 정리 + 실행	전체 마무리

블록 특수 규칙

Block 0 (도구 선택 + 스킬 생성) : Phase A에서 설명 + AskUserQuestion으로 도구 선택. 선택 결과로 템플릿 기반 스킬 생성 → Stop. Phase B에서 생성된 스킬 확인 퀴즈.
Block 1 (프로젝트 탐색) : Phase A에서 Explore 에이전트로 프로젝트 구조를 파악하고 결과 공유 → Stop. Phase B에서 퀴즈.
Block 2 (도구 연결) : Phase A에서 MCP vs API 선택 안내 + AskUserQuestion → Claude가 설정을 대신 수행 하고 사용자는 결과를 확인 → Stop. Phase B에서 퀴즈.
Block 3 (수집 실행 & 검증): Phase A에서 subagent 병렬 수집 설명 + 실행 → 수집 결과를 성공/실패로 구분하여 보여주기 → 실패한 소스 재시도 + 수집 데이터 품질 확인 → Stop. Phase B에서 퀴즈.
Block 4 (Output 설정) : Phase A에서 Output format 선택 안내 + AskUserQuestion → 선택에 따라 스킬 수정 → Stop. Phase B에서 퀴즈.
Block 5 (완성 + 실행) : Phase A에서 최종 스킬 구성 정리 + 실제 실행 → Stop. Phase B에서 종합 퀴즈 + 마무리.

Block 0 예외 규칙

Block 0의 Phase A는 AskUserQuestion을 사용 한다. 도구 선택이 이후 모든 블록의 전제 조건이므로 반드시 사용자 입력을 받아야 한다.

Phase A 진행 순서:

references/block0-tool-selection.md의 EXPLAIN 섹션을 읽고 설명한다
AskUserQuestion으로 도구를 선택받는다 (multiSelect: true)
templates/context-sync.md 템플릿을 읽는다
선택된 도구에 맞춰 사용자의 프로젝트에 .claude/skills/my-context-sync/SKILL.md를 생성한다
생성된 파일의 전체 구조만 간략히 보여주고 Stop한다 (세부 내용은 이후 블록에서)

Block 2 예외 규칙

Block 2의 Phase A도 AskUserQuestion을 사용 한다. 각 도구별로 MCP와 API 중 연결 방식을 선택해야 한다.

핵심 원칙: Claude가 설정을 대신 수행하고, 사용자는 결과를 확인한다.

MCP 선택 시:

references/block2-tool-connection.md의 MCP 안내를 따른다
scripts/mcp_servers.py를 사용하여 GitHub README.md에서 적합한 MCP 서버를 검색한다
검색 결과를 보여주고, Claude가 .mcp.json에 서버를 등록한다
/mcp 명령으로 서버 연결 상태를 함께 확인한다

API 선택 시:

Claude가 직접 API 호출 코드를 작성한다
사용자의 스킬 scripts/ 폴더에 저장한다

Block 4 예외 규칙

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

References 파일 맵

블록	파일	내용
Block 0	`references/block0-tool-selection.md`	도구 선택 + 템플릿 기반 스킬 생성
Block 1	`references/block1-project-explore.md`	Explore 에이전트로 프로젝트 구조 파악
Block 2	`references/block2-tool-connection.md`	MCP vs API 연결 방식 선택 + 실행
Block 3	`references/block3-parallel-collection.md`	subagent 병렬 수집 + 결과 검증
Block 4	`references/block4-output-format.md`

파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은 ## 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 2에서 Claude가 사용자의 선택에 맞춰 직접 작성한다.

진행 규칙

한 번에 한 블록씩 진행한다
"다음", "skip", 블록 번호/이름으로 이동한다
Block 0에서 생성한 스킬 파일을 이후 블록에서 점진적으로 수정한다
사용자 프로젝트의 .claude/skills/my-context-sync/ 디렉토리에 스킬을 생성한다
Explore 에이전트와 subagent 사용이 핵심이므로 적극 활용한다
Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를 curl로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다

시작

스킬 시작 시 먼저 최신 커리큘럼을 설치 한 뒤 블록을 선택한다.

Step 1: 최신 스킬 설치

아래 명령어를 출력하고 Bash로 실행한다:

npx skills add ai-native-camp/camp-1 --agent claude-code --yes

실행 결과를 간략히 안내한다 (예: "4개 스킬이 최신 버전으로 설치되었습니다").

Step 2: 블록 선택

아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.

Block	주제	내용
0	도구 선택	sync할 도구 고르기 + 스킬 골격 생성
1	프로젝트 탐색	Explore로 프로젝트 구조 파악
2	도구 연결	MCP or API로 도구 연결
3	수집 실행 & 검증	subagent 병렬 수집 + 결과 검증
4	Output 설정	출력 형식 선택 + 스킬 수정
5	완성 + 실행	최종 스킬 실행 + 마무리

AskUserQuestion({
  "questions": [{
    "question": "Day 2: 나만의 Context Sync 스킬 만들기\n\n어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "처음부터 (Block 0)", "description": "sync할 도구 고르기 + 스킬 골격 생성"},
      {"label": "도구 연결 (Block 2)", "description": "도구 선택은 했고, MCP/API 연결부터"},
      {"label": "수집 실행 & 검증 (Block 3)", "description": "연결 완료, 수집부터"},
      {"label": "Output 설정 (Block 4)", "description": "수집 완료, 출력 형식부터"}
    ],
    "multiSelect": false
  }]
})

시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.

Weekly Installs

937

Repository

ai-native-camp/camp-1

GitHub Stars

198

First Seen

Feb 15, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

claude-code928

opencode58

gemini-cli49

cursor49

codex48

github-copilot40