day1-onboarding

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Day 1: Onboarding

Day 1: Onboarding

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

当调用此Skill时,必须遵循以下STOP PROTOCOL

STOP PROTOCOL — 절대 위반 금지

STOP PROTOCOL — 绝对禁止违反

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

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

每个模块必须分2个回合进行

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

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

┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다       │
│ 2. AskUserQuestion으로 퀴즈를 출제한다                     │
│ 3. 정답/오답 피드백을 준다                                 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다         │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터.                │
└──────────────────────────────────────────────────────────┘
┌─ Phase A (第一回合) ──────────────────────────────┐
│ 1. 读取references/中对应模块文件的EXPLAIN 섹션을 읽는다    │
│ 2. 说明功能                                        │
│ 3. 读取references/中对应模块文件的EXECUTE 섹션을 읽는다    │
│ 4. "现在请亲自尝试执行"라고 안내한다                     │
│ 5. ⛔ 在此必须STOP,结束本回合。                    │
│                                                          │
│ ❌ 绝对禁止:出题测验、读取QUIZ章节             │
│ ❌ 绝对禁止:调用AskUserQuestion                  │
│ ❌ 绝对禁止:询问“你执行了吗?”                   │
└──────────────────────────────────────────────────────────┘

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

┌─ Phase B (第二回合) ──────────────────────────────┐
│ 1. 读取references/中对应模块文件的QUIZ 섹션을 읽는다       │
│ 2. 通过AskUserQuestion出题测验                     │
│ 3. 给出正确/错误的反馈                                 │
│ 4. 通过AskUserQuestion询问是否进入下一个模块         │
│ 5. ⛔ 开始下一个模块时,重新从Phase A开始。                │
└──────────────────────────────────────────────────────────┘

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

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

  1. Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
  2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
  3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
  4. 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다
  1. Phase A中禁止调用AskUserQuestion — 完成说明+执行提示后直接Stop
  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开始时,必须原样输出对应reference文件顶部的
> 공식 문서:
URL。
📖 官方文档: [URL]
  • 若reference文件中有多个URL,需全部输出
  • 不得总结或省略URL
  • 必须让参与者可以直接点击查看官方文档

Phase A 종료 시 필수 문구

Phase A结束时的必选语句

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:
---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.
이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.
在Phase A的最后,必须输出以下格式的语句后Stop:
---
👆 请亲自尝试执行以上内容。
执行完成后请输入“完成”或“下一步”。
此语句之后不得输出任何工具调用(包括AskUserQuestion)或附加文本。

블록 특수 규칙

模块特殊规则

  • Block 0 (Setup): 퀴즈 없음. Phase A에서 설명+실행 안내 → Stop. Phase B에서 완료 확인만.
  • Block 1 (Experience): Phase A에서 3가지 데모 안내 → Stop. Phase B에서 체험 소감 확인.
  • Block 2 (Why): Phase A에서 Quiz 1 출제 → 피드백 → Stop. Phase B에서 Quiz 2 + 영상 안내.
  • Block 3 (What): 7개 기능 각각이 독립 블록. 3-1부터 3-7까지 각각 Phase A → Phase B.
  • Block 3-Break (쉬어가기): Phase A만 있고 Phase B 없음. 퀴즈 없음. 터미널 소개 + Status Line 설정 체험.
  • Block 4 (Basics): Phase A에서 설명+실행 안내 → Stop. Phase B에서 퀴즈 3개 연속.

  • Block 0 (Setup):无测验。Phase A中完成说明+执行提示 → Stop。Phase B中仅确认完成情况。
  • Block 1 (Experience):Phase A中提示3种Working Backward演示 → Stop。Phase B中确认体验感想。
  • Block 2 (Why):Phase A中出题Quiz 1 → 给出反馈 → Stop。Phase B中出题Quiz 2 + 视频提示。
  • Block 3 (What):7个功能各自为独立模块。从3-1到3-7分别按照Phase A → Phase B进行。
  • Block 3-Break (休息时间):仅存在Phase A,无Phase B。无测验。介绍终端 + 体验Status Line设置。
  • Block 4 (Basics):Phase A中完成说明+执行提示 → Stop。Phase B中连续出题3个测验。

References 파일 맵

References文件映射

블록파일
Block 0
references/block0-setup.md
Block 1
references/block1-experience.md
Block 2
references/block2-why.md
Block 3-1 ~ 3-4
references/block3-1-claude-md.md
~
references/block3-4-subagent.md
Block 3-Break
references/block3-break.md
(쉬어가기: 터미널 & Status Line)
Block 3-5 ~ 3-7
references/block3-5-agent-teams.md
~
references/block3-7-plugin.md
Block 3 마무리
references/block3-summary.md
Block 4
references/block4-basics.md
파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은
## EXPLAIN
,
## EXECUTE
,
## QUIZ
섹션으로 구성된다.

模块文件
Block 0
references/block0-setup.md
Block 1
references/block1-experience.md
Block 2
references/block2-why.md
Block 3-1 ~ 3-4
references/block3-1-claude-md.md
~
references/block3-4-subagent.md
Block 3-Break
references/block3-break.md
(休息时间: 终端 & Status Line)
Block 3-5 ~ 3-7
references/block3-5-agent-teams.md
~
references/block3-7-plugin.md
Block 3 总结
references/block3-summary.md
Block 4
references/block4-basics.md
文件路径以本SKILL.md为基准的相对路径。 每个reference文件由
## EXPLAIN
,
## EXECUTE
,
## QUIZ
章节构成。

진행 규칙

进行规则

  • 한 번에 한 블록씩 진행한다
  • "다음", "skip", 블록 번호/이름으로 이동한다
  • Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를
    curl
    로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 (WebFetch는 요약/손실 위험이 있으므로 사용하지 않는다)
  • Block 3-4(Subagent) 완료 후 → Block 3-Break(쉬어가기) → Block 3-5(Agent Teams)로 이어진다
  • Block 3의 7개 기능이 모두 끝나면
    references/block3-summary.md
    를 읽고 관계도를 보여준다

  • 每次仅进行一个模块
  • 可通过“下一步”“skip”、模块编号/名称进行跳转
  • 收到Claude Code相关问题时,使用claude-code-guide agent(内置工具)进行回答。回答后需提供分步提示以便用户亲自操作,提问时使用AskUserQuestion。若判断内置agent的回答不准确,需通过
    curl
    将官方文档保存到文件后,使用Read工具仔细读取并以准确信息重新回答(不使用WebFetch,因为存在摘要/信息丢失风险)
  • 完成Block 3-4(Subagent)后 → 进入Block 3-Break(休息时间) → 再进入Block 3-5(Agent Teams)
  • 完成Block 3的7个功能后,读取
    references/block3-summary.md
    并展示关系图

시작

开始

스킬 시작 시 아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.
Block주제내용
0SetupClaude Code 설치 + 첫 대화 + CLAUDE.md
1ExperienceWorking Backward 데모 3가지
2Why왜 CLI? 왜 터미널? (퀴즈 2개)
3What7개 기능 소개
4BasicsCLI + git + GitHub (퀴즈 3개)
json
AskUserQuestion({
  "questions": [{
    "question": "어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "Block 0: Setup", "description": "Claude Code 설치 + 첫 대화 + CLAUDE.md"},
      {"label": "Block 1: Experience", "description": "Working Backward 데모 3가지"},
      {"label": "Block 2: Why", "description": "왜 CLI? 왜 터미널?"},
      {"label": "Block 3: What", "description": "7개 기능 소개"}
    ],
    "multiSelect": false
  }]
})
시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.
Skill启动时,展示以下表格并通过AskUserQuestion询问用户从哪里开始。
Block主题内容
0SetupClaude Code安装 + 首次对话 + CLAUDE.md
1Experience3种Working Backward演示
2Why为什么用CLI?为什么用终端?(2个测验)
3What7个功能介绍
4BasicsCLI + git + GitHub(3个测验)
json
AskUserQuestion({
  "questions": [{
    "question": "从哪里开始呢?",
    "header": "起始模块",
    "options": [
      {"label": "Block 0: Setup", "description": "Claude Code安装 + 首次对话 + CLAUDE.md"},
      {"label": "Block 1: Experience", "description": "3种Working Backward演示"},
      {"label": "Block 2: Why", "description": "为什么用CLI?为什么用终端?"},
      {"label": "Block 3: What", "description": "7个功能介绍"}
    ],
    "multiSelect": false
  }]
})
选择起始模块后 → 从对应模块的Phase A开始进行。