SuperAPI AI Directory

part2-clarify

Writing & research

View repository

Updated 10-16 08:46

About this skill

Part 2: Clarify

When this skill is invoked, you must follow the STOP PROTOCOLbelow.


Terminology Overview

Term Description
Clarify The process of making ambiguous requirements clear. Claude asks questions to convert tacit knowledge into explicit knowledge
AskUserQuestion A tool for Claude to ask the user structured questions. It reduces cognitive load by presenting options
Hypothesis-as-Options The principle of presenting hypotheses as options instead of open questions. Instead of "What do you want?", "Which of A / B / C is it?"
Before/After A format that visualizes changes by comparing requirements before and after Clarify
Plugin A package that bundles Skill + MCP + Hook + Agent into a single installation unit

STOP PROTOCOL — Never Violate

This protocol is the top-priority rule of this skill.

Each block must proceed over exactly 2 turns

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

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

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

Required phrasing at the end of Phase A

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

Block-Specific Rules

  • Block 0 (Concept): Standard Phase A/B. The AskUserQuestion experience is the core of EXECUTE.
  • Block 1 (Experience Vague): Exception — In Phase A, Claude demonstrates the clarify-vague protocol. When a student throws out an ambiguous requirement, Claude clarifies it with AskUserQuestion. The student plays the role of the "clarify recipient."
  • Block 2 (Build Clarify): Standard, but in EXECUTE .claude/skills/clarify-vague/SKILL.mdis analyzed with Read, then you write your own skill based on the template.

Time Required

Block Topic Time
0 Clarify concept + AskUserQuestion ~15분
1 clarify-vague experience ~15분
2 Creating your own Clarify skill ~30분
Total ~60분

Handpicked only the core 3 blocks from the original Day 3 (5 blocks, ~95 min). Plugin deep dive/Unknown/PRD are outside the scope of this lecture.


Core Strategy

"Building the muscle to convert ambiguity into structured questions"

Block 0:  AskUserQuestion 체험 → "아, 이렇게 질문하는 거구나"
   ↓
Block 1:  모호한 요청 던져보기 → clarify 플러그인이 어떻게 대응하는지 관찰
   ↓
Block 2:  나만의 Clarify 스킬 작성 → 내 워크플로우에 맞게 커스터마이즈

References File Map

Block File
Block 0 references/block0-concept.md
Block 1 references/block1-experience-vague.md
Block 2 references/block2-build-clarify.md

Each reference file consists of ## EXPLAIN, ## EXECUTE, ## QUIZ sections. Block 3 (Plugin deep dive + Unknown) and Block 4 (PRD + GitHub) of the original Day 3 were excluded from this lecture.


Templates File Map

File Purpose
templates/clarify-vague.md Template for writing your own Clarify skill

Start

Select a block when Part 2 begins.

AskUserQuestion({
  "question": "Part 2: Clarify\n\n어디서부터 시작할까요?",
  "header": "시작 블록",
  "options": [
    {"label": "Block 0: Concept", "description": "Clarify 개념 + AskUserQuestion 체험"},
    {"label": "Block 1: Experience", "description": "clarify-vague 플러그인 체험"},
    {"label": "Block 2: Build", "description": "나만의 Clarify 스킬 만들기"}
  ],
  "multiSelect": false
})

If the direction changes during the co-session instructors (심근/문성훈/최의진), flexibly adjust the block order/depth.