day3-clarify

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Day 3: Clarify

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

调用该技能时必须严格遵守以下 STOP PROTOCOL。

용어 정리

术语整理

용어	설명
Clarify	모호한 요구사항을 명확하게 만드는 과정. Claude가 질문을 던져서 암묵지를 명시지로 변환한다
AskUserQuestion	Claude가 사용자에게 구조화된 질문을 하는 도구. 선택지를 제시하여 인지 부하를 줄인다
Hypothesis-as-Options	열린 질문 대신 가설을 선택지로 제시하는 원칙. "뭘 원해요?" 대신 "A / B / C 중 어떤 건가요?"
Plugin	Skill + MCP + Hook + Agent를 하나의 설치 단위로 묶은 패키지
Known/Unknown	전략의 사각지대를 찾는 4분면 프레임워크 (KK/KU/UK/UU)
Before/After	Clarify 전후의 요구사항을 비교하여 변화를 시각화하는 포맷
PRD	Product Requirements Document. "이 프로젝트가 뭘 해결하고, 뭘 만드는지" 정리한 문서
GitHub	코드와 문서를 함께 관리하고 공유하는 온라인 서비스. Google Docs의 코드 버전
PR (Pull Request)	"내 작업을 확인해주세요"라고 운영진에게 보내는 검토 요청. 제출 버튼과 같다

术语	说明
Clarify	将模糊需求明确化的过程。Claude通过提问将隐性知识转化为显性知识
AskUserQuestion	Claude向用户提出结构化问题的工具。通过提供选项降低认知负担
Hypothesis-as-Options	将假设作为选项提供而非开放式提问的原则。相比"您需要什么？"，使用"A / B / C 中您需要哪一个？"的提问方式
Plugin	将 Skill + MCP + Hook + Agent 整合为一个安装单元的包
Known/Unknown	查找策略盲区的四象限框架（KK/KU/UK/UU）
Before/After	对比 Clarify 前后的需求，将变化可视化的格式
PRD	Product Requirements Document。整理"该项目要解决什么问题、要开发什么内容"的文档
GitHub	同时管理和共享代码与文档的在线服务，相当于代码版本的 Google Docs
PR (Pull Request)	向运营人员发送的"请检查我的工作内容"的审核请求，相当于提交按钮

STOP PROTOCOL — 절대 위반 금지

STOP PROTOCOL — 绝对禁止违反

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

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

각 블록은 반드시 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. ⛔ 此处必须停止，结束当前回合                    │
│                                                          │
│ ❌ 绝对禁止操作：出题、读取 QUIZ 部分             │
│ ❌ 绝对禁止操作：调用 AskUserQuestion                  │
│ ❌ 绝对禁止操作：询问"你操作完了吗？"                   │
└──────────────────────────────────────────────────────────┘

  ⬇️ 用户返回后输入"했어"、"완료"、"다음"等内容

┌─ Phase B（第二回合） ──────────────────────────────┐
│ 1. 读取 references/ 下对应模块文件的 QUIZ 部分       │
│ 2. 通过 AskUserQuestion 出题                     │
│ 3. 提供正确/错误反馈                                 │
│ 4. 通过 AskUserQuestion 询问是否进入下一个模块         │
│ 5. ⛔ 开始下一个模块后重新从 Phase A 执行                │
└──────────────────────────────────────────────────────────┘

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

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

Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop
Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다
Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다
한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다

禁止在 Phase A 调用 AskUserQuestion — 完成说明+操作指引后直接停止
禁止在 Phase A 出题 — QUIZ 部分仅可在 Phase B 读取
禁止在 Phase A 询问"你操作完了吗？" — 等待用户主动告知
禁止在同一个回合内同时进行 EXPLAIN + QUIZ — 必须分为2个回合

Phase A 종료 시 필수 문구

Phase A 结束时必须输出的文案

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

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

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

Phase A 的末尾必须输出以下格式的文案后停止：

---
👆 请自行尝试操作以上内容。
操作完成后请输入"完成"或"下一步"。

在该文案后不得输出任何工具调用（包含 AskUserQuestion）或额外文本。

블록 특수 규칙

模块特殊规则

Block 0 (Concept): 표준 Phase A/B. AskUserQuestion 체험이 EXECUTE의 핵심.
Block 1 (Experience Vague): 예외 — Phase A에서 Claude가 clarify:vague 프로토콜을 시연한다. 학생이 모호한 요구사항을 던지면 Claude가 AskUserQuestion으로 clarify한다. 학생은 "clarify 받는 사람" 역할.
Block 2 (Build Clarify): 표준이지만 EXECUTE에서 플러그인의 vague SKILL.md를 Read로 분석한 후, 템플릿 기반으로 나만의 스킬을 작성한다.
Block 3 (Plugin & Unknown): 메인 블록 — Plugin 심화 분석 + clarify:unknown 체험.
Block 4 (PRD & GitHub): 표준 Phase A/B이지만 PRD 작성은 인터랙티브. Claude가 GitHub ID 확인 → PRD 초안 작성 → 검증 → PR 제출까지 자동으로 진행. Phase B 퀴즈 후 Day 3 과제 안내.

Block 0 (Concept): 标准 Phase A/B 流程。AskUserQuestion 体验是 EXECUTE 的核心。
Block 1 (Experience Vague): 例外 — Phase A 中 Claude 演示 clarify:vague 协议。学生提出模糊需求时，Claude 通过 AskUserQuestion 进行澄清。学生扮演"接受澄清的人"角色。
Block 2 (Build Clarify): 标准流程，但 EXECUTE 阶段需要读取分析插件的 vague SKILL.md，再基于模板编写专属技能。
Block 3 (Plugin & Unknown): 核心模块 — 插件深度解析 + clarify:unknown 体验。
Block 4 (PRD & GitHub): 标准 Phase A/B 流程，但 PRD 编写为交互形式。Claude 从确认 GitHub ID → 编写 PRD 初稿 → 验证 → 提交 PR 全程自动进行。Phase B 答题后提供 Day 3 作业指引。

소요 시간

所需时长

Block	주제	시간
0	Clarify 개념 + AskUserQuestion	~10분
1	clarify:vague 체험	~15분
2	나만의 Clarify 스킬 만들기	~25분
3	Plugin 심화 + clarify:unknown 체험	~30분
4	PRD 작성 & GitHub 첫 제출 + 과제	~15분
	합계	~95분

模块	主题	时长
0	Clarify 概念 + AskUserQuestion	~10分钟
1	clarify:vague 体验	~15分钟
2	制作专属 Clarify 技能	~25分钟
3	Plugin 深度解析 + clarify:unknown 体验	~30分钟
4	PRD 编写 & GitHub 首次提交 + 作业	~15分钟
	合计	~95分钟

핵심 전략

核心策略

"설치한 플러그인을 해부하고, 직접 만들어보기"

Day 1에서 설치한 clarify 플러그인을 체험 → 구조 분석 → 나만의 버전 제작 → 심화 활용

Day 1에서 설치          Day 3에서 깊이 파기
┌──────────────┐       ┌──────────────────────────┐
│ /plugin      │       │ Block 0: 개념 이해        │
│   install    │  ───▶ │ Block 1: vague 체험       │
│   clarify    │       │ Block 2: 나만의 스킬 제작  │
└──────────────┘       │ Block 3: Plugin 해부 +    │
                       │          unknown 체험     │
                       │ Block 4: PRD + GitHub 제출 │
                       └──────────────────────────┘

"拆解已安装的插件，亲手尝试制作"

体验 Day 1 安装的 clarify 插件 → 结构分析 → 制作专属版本 → 深度使用

Day 1 安装          Day 3 深入学习
┌──────────────┐       ┌──────────────────────────┐
│ /plugin      │       │ Block 0: 概念理解        │
│   install    │  ───▶ │ Block 1: vague 体验       │
│   clarify    │       │ Block 2: 专属技能制作  │
└──────────────┘       │ Block 3: Plugin 拆解 +    │
                       │          unknown 体验     │
                       │ Block 4: PRD + GitHub 提交 │
                       └──────────────────────────┘

References 파일 맵

References 文件映射

블록	파일
Block 0	`references/block0-concept.md`
Block 1	`references/block1-experience-vague.md`
Block 2	`references/block2-build-clarify.md`
Block 3	`references/block3-plugin-and-unknown.md`
Block 4	`references/block4-prd-and-github.md`

파일 경로는 이 SKILL.md 기준 상대경로다. 각 reference 파일은
## EXPLAIN
,
## EXECUTE
,
## QUIZ
섹션으로 구성된다.

模块	文件
Block 0	`references/block0-concept.md`
Block 1	`references/block1-experience-vague.md`
Block 2	`references/block2-build-clarify.md`
Block 3	`references/block3-plugin-and-unknown.md`
Block 4	`references/block4-prd-and-github.md`

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

Templates 파일 맵

Templates 文件映射

파일	용도
`templates/clarify-vague.md`	나만의 Clarify 스킬 작성용 템플릿

文件	用途
`templates/clarify-vague.md`	编写专属 Clarify 技能用模板

진행 규칙

推进规则

한 번에 한 블록씩 진행한다
"다음", "skip", 블록 번호/이름으로 이동한다
Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를
```
curl
```
로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 (WebFetch는 요약/손실 위험이 있으므로 사용하지 않는다)

每次仅推进一个模块
可通过"下一步"、"skip"、模块编号/名称跳转
收到 Claude Code 相关问题时，使用 claude-code-guide Agent（内置工具）解答。解答后分步骤引导用户自行操作，提问时使用 AskUserQuestion。若判断内置 Agent 的答案不准确，通过
```
curl
```
将官方文档保存到文件后，用 Read 工具仔细读取，再用准确信息重新解答（不要使用 WebFetch，存在摘要/信息丢失风险）

시작

开始

스킬 시작 시 아래를 안내하고 AskUserQuestion으로 어디서 시작할지 물어본다.

아직 camp-2 스킬이 설치되지 않았다면:
npx skills add ai-native-camp/camp-2

Block	주제	내용
0	Concept	Clarify 개념 + AskUserQuestion 체험
1	Experience	clarify:vague 플러그인 체험
2	Build	나만의 Clarify 스킬 만들기
3	Plugin & Unknown	Plugin 심화 + clarify:unknown
4	PRD & GitHub	PRD 작성 + GitHub 첫 PR 제출 + 과제

json

AskUserQuestion({
  "questions": [{
    "question": "어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "Block 0: Concept", "description": "Clarify 개념 + AskUserQuestion 체험"},
      {"label": "Block 1: Experience", "description": "clarify:vague 플러그인 체험"},
      {"label": "Block 2: Build", "description": "나만의 Clarify 스킬 만들기"},
      {"label": "Block 3: Plugin & Unknown", "description": "Plugin 심화 + unknown 체험"},
      {"label": "Block 4: PRD & GitHub", "description": "PRD 작성 + GitHub 첫 PR 제출"}
    ],
    "multiSelect": false
  }]
})

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

技能启动时按以下内容指引，通过 AskUserQuestion 询问从哪里开始。

若尚未安装 camp-2 技能：
npx skills add ai-native-camp/camp-2

模块	主题	内容
0	Concept	Clarify 概念 + AskUserQuestion 体验
1	Experience	clarify:vague 插件体验
2	Build	制作专属 Clarify 技能
3	Plugin & Unknown	Plugin 深度解析 + clarify:unknown
4	PRD & GitHub	PRD 编写 + GitHub 首个 PR 提交 + 作业

json

AskUserQuestion({
  "questions": [{
    "question": "어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "Block 0: Concept", "description": "Clarify 개념 + AskUserQuestion 체험"},
      {"label": "Block 1: Experience", "description": "clarify:vague 플러그인 체험"},
      {"label": "Block 2: Build", "description": "나만의 Clarify 스킬 만들기"},
      {"label": "Block 3: Plugin & Unknown", "description": "Plugin 심화 + unknown 체험"},
      {"label": "Block 4: PRD & GitHub", "description": "PRD 작성 + GitHub 첫 PR 제출"}
    ],
    "multiSelect": false
  }]
})

选择开始模块后 → 从对应模块的 Phase A 开始推进。